Chatbot para uma conta Telegram Business

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.

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.

Conectando o bot

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

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).

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

Se o Telegram estiver conectado.

Caso você já tenha um bot do Telegram conectado, encontre esse 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 se abre, clique em DONE para atualizar as configurações do seu bot do Telegram (não é necessário alterar mais nenhuma configuração):

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

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":

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

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).

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:

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 canais e encontre o chatbot no qual você deseja desativar essa 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)

tg_callback

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)

tg_send_poll

Parâmetros:

! platform_id - identificador do chat no Telegram *

! 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 -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

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 )

tg_send_quiz_poll

! platform_id - identificador do chat no Telegram *

! 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

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)

tg_send_message_1

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 *

! text - texto da mensagem

client_message_id - ID da mensagem citada

reply_markup — configurações dos botões **

parse_mode — modo de formatação do 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 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"}]

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