# White-label API

{% hint style="info" %}
Make sure that you have access to the API token of your Telegram bot before starting
{% endhint %}

### Configure your bot in "full-control" mode

In "full-control" mode we will automatically configure a webhook for your bot, so you can't use your own commands. But in this mode, you don't need to have your own servers and don't need to have programming skills.

1. Create an API application on the [API Settings](https://fullyst.com/api_settings) page
2. Insert the API token of your bot (received from @BotFather) in the form
3. Tick the "Full control" checkbox
4. Click the "Save" button

<figure><img src="/files/3C8xYY4qhrI3QivRhHZG" alt=""><figcaption><p>Configured White-label bot</p></figcaption></figure>

Now you can use your bot as [@Fullystbot](/getting-started.md)

### Forwarding data to the webhook

Unlike other services, we don't require full control over your bot and that's why we created it this way. This method is suitable for bots that must contain their own functionality different from Fullyst's functionality and require you to maintain your own webhook.

1. Create an API application on the [API Settings](https://fullyst.com/api_settings) page
2. Insert the API token of your bot (received from @BotFather) in the form
3. **Don't** tick the "Full control" checkbox
4. Click the "Save" button

Now you should send all data that you receive from Telegram to our webhook API as a POST request:

```
https://api.fully.st/v1/webhook
```

with the following parameters:

```
key - API ID + API key combined with a colon, for example, eKgl2d2P:8afe4df7-df9e-5e79-8e28-4e83ae5530ce
query - unchanged data received by your webhook from Telegram
```

{% hint style="info" %}
**NB!** In the case that a substitution or change of messages on the side of your webhook is detected, we reserve the right to unilaterally suspend your API application and/or prohibit the creation and use of new API applications.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fullyst.com/api/white-label-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
