# Chatbot para uma conta empresarial do Telegram

Você já pode criar **assistentes empresariais pessoais** — bots especiais que se integram diretamente em chats individuais do Telegram. Esses bots processam automaticamente as solicitações recebidas e respondem em nome do proprietário da conta, reduzindo drasticamente o tempo gasto em tarefas rotineiras e melhorando a eficiência da comunicação.

**Casos de uso:**\
Esses assistentes podem ser configurados para diversos propósitos, como:

* Fornecer consultas sobre produtos ou serviços.
* Responder perguntas frequentes.
* Executar uma ampla variedade de outras tarefas automatizadas.

**Recurso principal: controle perfeito**

Um usuário pode **alternar instantaneamente de volta para a comunicação manual** a qualquer momento, sem interromper ou desativar o funcionamento do bot, garantindo controle total sobre o chat.

{% hint style="warning" %}
Atenção! 

A conta empresarial do Telegram tem uma janela de 24 horas.

Assim que um usuário envia sua primeira mensagem, o bot tem uma **janela de 24 horas** para responder e continuar a conversa. Essa janela é reiniciada toda vez que o usuário responde.

* **Se o usuário responder:** A janela de 24 horas é reiniciada, permitindo um diálogo contínuo.
* **Se o usuário NÃO responder em até 24 horas:** A janela se fecha. O bot ficará impedido de enviar novas mensagens até que o usuário envie uma nova mensagem para reiniciar o contato.
  {% endhint %}

## Conectando o bot

Etapa 1. Configuração no **Mensageiros** seção.

1.  **Se você estiver conectando um bot do Telegram pela primeira vez.**

Primeiro, vá até a aba Channels na seção Mavibot para conectar o chatbot do Telegram (se ainda não houver um).

<div data-with-frame="true"><figure><img src="/files/60db61c6a92b6c83b4c390b3972eb4899712e43c" alt="" width="563"><figcaption></figcaption></figure></div>

Em seguida, conectamos o bot do Telegram de acordo com as[ instruções](/doc/pt/chatbot/mensageiros/telegram/chatbot.md) .&#x20;

2. **Se o Telegram estiver conectado**.&#x20;

Caso você já tenha um bot do Telegram conectado, encontre esse bot nos canais:

<div data-with-frame="true"><figure><img src="/files/2d9e4b7bbd0c2159a9d16f52859c775701f7ca7e" alt="" width="563"><figcaption></figcaption></figure></div>

Em seguida, clique no botão de configurações, após o qual você verá uma janela modal com campos de token etc.:

<div data-with-frame="true"><figure><img src="/files/e5a208d1c51c3979ed61fc04f6edc81e049b7b05" alt="" width="563"><figcaption></figcaption></figure></div>

Na janela modal que se abre, clique em DONE para atualizar as configurações do seu bot do Telegram (não é necessário alterar mais nenhuma configuração):

<div data-with-frame="true"><figure><img src="/files/429903f4e21d92c19fbbdf3d07209800ad9b0036" alt="" width="563"><figcaption></figcaption></figure></div>

Nesta etapa, o trabalho com os canais está concluído. Vá para as configurações do mensageiro.&#x20;

Etapa 2. Configurações do mensageiro.

Para conectar o chatbot do Telegram à sua conta empresarial, vá até as configurações do seu perfil, onde você precisa encontrar a aba "Telegram Business":

<div data-with-frame="true"><figure><img src="/files/a07a972789aeb1494772e90afed022f2a919f5c5" alt="" width="375"><figcaption></figcaption></figure></div>

Em seguida, você verá a aba "Chatbots", para onde você precisa ir:

<div data-with-frame="true"><figure><img src="/files/c376224a939ad96b50db0246bb1b7d8e60b99faa" alt="" width="375"><figcaption></figcaption></figure></div>

Depois, na aba recém-aberta, insira o link para o bot do Telegram necessário ou seu nome de usuário (é preferível inserir o link).

<div data-with-frame="true"><figure><img src="/files/b98ce7915f97ee23d5e89c94dbc1d19ddfa49d56" alt="" width="375"><figcaption></figcaption></figure></div>

Na mesma aba, defina a permissão (caixa de seleção "Responder às mensagens") para que o chatbot responda às mensagens.

Nesta etapa, a configuração do chatbot na conta empresarial está concluída. Siga em frente.

Etapa 3. Configurações do BotFather.

Depois de vincular o chatbot à conta empresarial, você precisa atualizar as configurações do chatbot no BotFather, onde você criou inicialmente o bot do Telegram.

Para fazer isso, abra a conversa com o BotFather e habilite-o para trabalhar com a conta empresarial:

<div data-with-frame="true"><figure><img src="/files/a7abd33072016e61002422b962114eab2525e31b" alt="" width="375"><figcaption></figcaption></figure></div>

Vá para as configurações do bot:

<div data-with-frame="true"><figure><img src="/files/0419b0b5e7de9addef30c20cfecf5f9bb75ee866" alt="" width="375"><figcaption></figcaption></figure></div>

Em seguida, clique no botão "Business Mode" para ativar o modo empresarial para o chatbot:

<div data-with-frame="true"><figure><img src="/files/8836dcecf6aa88ac7effe3374a24db18d579a968" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
Pronto! Todas as configurações necessárias do chatbot com uma conta empresarial foram concluídas.
{% endhint %}

Agora, nas configurações do canal, você encontrará o bot do Telegram e verá o ID empresarial e também o nome do proprietário da conta empresarial:

<div data-with-frame="true"><figure><img src="/files/4914bec6d4c229330aa020e1a211a3ce6a90afe7" alt=""><figcaption></figcaption></figure></div>

### Como desativar&#x20;

Para desativar o chatbot com modo empresarial, vá para canais e encontre o chatbot no qual você deseja desativar essa configuração. Clique no botão de configurações:

<div data-with-frame="true"><figure><img src="/files/c2ab7ef4d465693a8d5a8c4f3515b014fbbe71bb" alt=""><figcaption></figcaption></figure></div>

Clique no botão "Disable Business Account".

<div data-with-frame="true"><figure><img src="/files/4c7c24fb630e831db5004d0c763d704d16f28c7c" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
Se você desativar sua conta empresarial, o chatbot continuará funcionando no modo padrão.
{% endhint %}

## Funções disponíveis

1. (API) Função na calculadora:

**tg\_callback(platform\_id , callback\_message,group\_id, tg\_business)**

<details>

<summary><strong>tg_callback</strong></summary>

Parâmetros:

**! platform\_id** - ID do cliente do Telegram

**! callback\_message** - mensagem de callback&#x20;

**group\_id** - ID do bot do Telegram

**tg\_business -** para trabalhar com clientes empresariais, assume o valor "1".

</details>

**tg\_send\_poll(platform\_id, question, options, is\_anonymous, allows\_multiple\_answers, reply\_markup, disable\_notification, protect\_content, token, reply\_to\_message\_id, message\_thread\_id, business\_connection\_id)**

<details>

<summary><strong>tg_send_poll</strong></summary>

Parâmetros:&#x20;

**! platform\_id** - identificador do chat no Telegram [**\***](/doc/pt/chatbot/mensageiros/telegram/api.md)

**! question** - pergunta

**! options** - matriz de opções de resposta

**is\_anonymous** - 1 - enquete anônima, '' - não anônima

**allows\_multiple\_answers** - 1 - permite múltiplas respostas, '' - apenas uma resposta

**reply\_markup** - teclado, ou '' - sem teclado

**disable\_notification** — sinalizador para envio com notificação sonora (padrão 0); 1 - enviar em silêncio, 0 - enviar com notificação

**protect\_content** - 1 - proteger contra cópias e capturas de tela, '' - sem proteção

**token** - token do bot; se não for fornecido, será usado o atual

**reply\_to\_message\_id** - ID da mensagem citada

**message\_thread\_id** — identificador do tópico (disponível em supergrupos com funcionalidade de fórum)

**business\_connection\_id -**&#x76;alor usado ao conectar um bot (Business ID, exibido nos canais); deve ser passado se o token do bot for fornecido e a mensagem precisar ser enviada por meio da conta de usuário vinculada ao bot

</details>

**tg\_send\_quiz\_poll(platform\_id, question, options, explanation, correct\_option\_id, is\_anonymous, reply\_markup, parse\_mode, protect\_content, disable\_notification, token, reply\_to\_message\_id, message\_thread\_id )**

<details>

<summary><strong>tg_send_quiz_poll</strong></summary>

**! platform\_id** - identificador do chat no Telegram [**\***](/doc/pt/chatbot/mensageiros/telegram/api.md)

**! question** - pergunta

**! options** - matriz de opções de resposta

**! explanation** - texto exibido quando o usuário seleciona uma resposta incorreta ou toca no ícone de lâmpada em uma enquete no estilo quiz; de 0 a 200 caracteres, com no máximo duas quebras de linha após a análise de entidades.

**! correct\_option\_id** - número da resposta correta, começando em 1.

**is\_anonymous** -1 - enquete anônima, '' - não anônima

**reply\_markup** - teclado, ou '' - sem teclado

**parse\_mode** - markdown ou html para *explanation*, ou '' para sem formatação.

**protect\_content** - 1 proteger contra cópias e capturas de tela, '' - sem proteção.

**disable\_notification** — sinalizador para envio com notificação sonora (padrão 0); 1 - enviar em silêncio, 0 - enviar com notificação

**token** - token do bot; se não for fornecido, o atual será usado.

**reply\_to\_message\_id** - ID da mensagem citada

**message\_thread\_id** — identificador do tópico (disponível em supergrupos com funcionalidade de fórum)

**open\_period** - tempo permitido para concluir o quiz/teste; valor numérico de 5 a 600, representando segundos.

**business\_connection\_id -** valor usado ao conectar um bot (Business ID, exibido nos canais); deve ser passado se o token do bot for fornecido e a mensagem precisar ser enviada por meio da conta de usuário vinculada ao bot

</details>

**tg\_send\_message\_1(token, platform\_id, text, client\_message\_id, reply\_markup, parse\_mode, disable\_web\_page\_preview, protect\_content, disable\_notification, message\_thread\_id, entities, business\_connection\_id)**

<details>

<summary><strong>tg_send_message_1</strong></summary>

Parâmetros:

**! token** — token do bot do Telegram obtido no BotFather

**! platform\_id** — identificador do cliente do Telegram para o qual a mensagem deve ser enviada [**\***](/doc/pt/chatbot/mensageiros/telegram/api.md)

**! text** - texto da mensagem

**client\_message\_id** - ID da mensagem citada

**reply\_markup** — configurações dos botões [**\*\***](/doc/pt/chatbot/mensageiros/telegram/api.md)

**parse\_mode** — modo de formatação do texto para negrito ou itálico na descrição da mensagem [**\*\*\***](/doc/pt/chatbot/builder/telegram_messages.md)**.** valores possíveis: html, markdown, markdownV2

**disable\_web\_page\_preview -** se deve exibir uma prévia do link; defina como 1 para desativar, caso contrário 0 ou deixe em branco ("")

**protect\_content** — sinalizador para proteger o conteúdo contra cópia; para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ('')

**disable\_notification** — sinalizador para envio com notificação sonora (padrão 0); 1 - enviar em silêncio, 0 - enviar com notificação

**message\_thread\_id** — identificador do tópico (disponível em supergrupos com funcionalidade de fórum) **entities** — permite copiar texto pré-formatado com toda a estilização; especifique intervalos de caracteres para cada estilo de formatação. Você pode encontrar um exemplo no campo tg\_request. O parâmetro deve conter um dicionário.

**business\_connection\_id -** valor usado ao conectar um bot (Business ID, exibido nos canais); deve ser passado se o token do bot for fornecido e a mensagem precisar ser enviada por meio da conta de usuário vinculada ao bot

Exemplo de passagem de parâmetro:

`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`&#x20;

No exemplo, apenas o dicionário é mostrado, enquanto o próprio texto da mensagem é definido em uma variável separada.

</details>

2. Métodos

\- [tg\_send\_chat\_action](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-raboty-v-chatakh-i-kanalakh-telegram#tg_send_chat_action)

\- [tg\_send\_message](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-dlya-otpravki-i-redaktirovaniya-soobshenii)

\- [tg\_send\_poll](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram#kak-sozdat-zakryt-opros-v-chate-kanale-telegram)

\- [tg\_send\_quiz\_poll](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram#kak-sozdat-zakryt-opros-v-chate-kanale-telegram)

\- [tg\_send\_video\_note](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii)

\- [tg\_send\_sticker](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii)

\- [tg\_send\_contact](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-kontakt-tg_send_contact)

\- [tg\_send\_venue](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-geotochku-tg_send_venue)

\- [tg\_send\_video](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii?q=#primer-koda-dlya-kopirovaniya-6)

\- [tg\_send\_animation](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_voice](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_document](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_media\_group](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_photo](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_video](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_document](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_audio](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_dice ](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

Eles funcionam automaticamente com clientes que escreveram para a conta empresarial do Telegram da mesma forma que nos bots.

{% hint style="info" %}
Para mais informações sobre esses métodos, consulte o artigo [API do Telegram](/doc/pt/chatbot/mensageiros/telegram/api.md)"
{% 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.mavibot.ai/doc/pt/chatbot/mensageiros/telegram/business.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.