> For the complete documentation index, see [llms.txt](https://docs.fullyst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fullyst.com/api/white-label-api.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.