Chatbot para uma conta Telegram Business

Agora você pode criar assistentes pessoais de negócios — 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 fins, como:

Fornecer consultas sobre produtos ou serviços.
Responder a perguntas frequentes.
Realizar uma ampla gama de outras tarefas automatizadas.

Funcionalidade principal: controle contínuo

Um usuário pode mudar instantaneamente para a comunicação manual a qualquer momento, sem interromper ou desabilitar a operação do bot, garantindo controle total sobre o chat.

Atenção!

A conta Telegram Business possui 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 cada 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 dentro de 24 horas: A janela fecha. O bot será bloqueado de enviar mais mensagens até que o usuário envie uma nova mensagem para reiniciar o contato.

Conectando o bot

Passo 1. Configuração na seção Messengers.

Se você está conectando um bot do Telegram pela primeira vez.

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

Em seguida, conecte o bot do Telegram de acordo com as instruções .

Se o Telegram já estiver conectado.

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

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

Na janela modal que abrir, clique em DONE para atualizar as configurações do seu bot do Telegram (você não precisa alterar mais nenhuma configuração):

Nesta etapa, o trabalho com os canais está concluído. Vá para as configurações do messenger.

Passo 2. Configurações do messenger.

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

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

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

Na mesma aba, defina a permissão (caixa de seleção "Reply to messages") para o chatbot responder às mensagens.

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

Passo 3. Configurações do BotFather.

Após 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 o chat com o BotFather e ative-o para trabalhar com a conta empresarial:

Vá para as configurações do bot:

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

Pronto! Todas as configurações necessárias do chatbot com uma conta empresarial foram concluídas.

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:

Como desativar

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

Clique no botão "Disable Business Account".

Se você desativar sua conta empresarial, o chatbot continuará funcionando no modo padrão.

Funções disponíveis

(API) Função na calculadora:

tg_callback(platform_id , callback_message,group_id, tg_business)

Parâmetros:

! platform_id - ID do cliente do Telegram

! callback_message - mensagem de callback

group_id - ID do bot do Telegram

tg_business - para trabalhar com clientes empresariais, assume o valor "1".

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)

Parâmetros:

! platform_id - identificador do chat no Telegram *

! question - pergunta

! options - array de opções de resposta

is_anonymous - 1 - enquete anônima, '' - não anônima

allows_multiple_answers - 1 - múltiplas respostas permitidas, '' - apenas uma resposta

reply_markup - teclado, ou '' - sem teclado

disable_notification — flag para envio com notificação sonora (padrão 0); 1 - enviar silenciosamente, 0 - enviar com notificação

protect_content - 1 - proteger contra cópia e capturas de tela, '' - sem proteção

token - token do bot; se não fornecido, o atual é usado

reply_to_message_id - ID da mensagem citada

message_thread_id — identificador de tópico (disponível em supergrupos com funcionalidade de fórum)

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 através da conta de usuário vinculada ao bot

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 )

! platform_id - identificador do chat no Telegram *

! question - pergunta

! options - array de opções de resposta

! explanation - texto mostrado quando o usuário seleciona uma resposta incorreta ou toca no ícone de lâmpada em uma enquete estilo quiz; 0–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ópia e capturas de tela, '' - sem proteção.

disable_notification — flag para envio com notificação sonora (padrão 0); 1 - enviar silenciosamente, 0 - enviar com notificação

token -token do bot; se não fornecido, o atual é usado.

reply_to_message_id - ID da mensagem citada

message_thread_id —identificador de tópico (disponível em supergrupos com funcionalidade de fórum)

open_period - tempo permitido para completar 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 através da conta de usuário vinculada ao bot

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)

Parâmetros:

! token — token do bot do Telegram obtido do BotFather

! platform_id — identificador do cliente do Telegram para o qual a mensagem deve ser enviada *

! text - texto da mensagem

client_message_id - ID da mensagem citada

reply_markup — configurações do botão **

parse_mode — modo de formatação de texto para negrito ou itálico na descrição da mensagem ***. valores possíveis: html, markdown, markdownV2

disable_web_page_preview - se deve exibir uma prévia do link; defina como 1 para desabilitar, caso contrário 0 ou deixe vazio ("")

protect_content — flag para proteger o conteúdo contra cópia; para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ('')

disable_notification — flag para envio com notificação sonora (padrão 0); 1 - enviar silenciosamente, 0 - enviar com notificação

message_thread_id — identificador de 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 através 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"}]

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