Pular para o conteúdo principal

Telegram

O canal Telegram permite que seu agente atenda clientes pelo mensageiro Telegram. Cada bot do Telegram é associado a um agente e gerencia sua própria lista de conversas.

Como funciona​

Quando um cliente envia uma mensagem para o bot no Telegram:

  1. O Telegram entrega a mensagem ao gateway da plataforma via webhook.
  2. A plataforma identifica qual agente atende aquele bot.
  3. O texto é enviado ao agente, que processa e responde.
  4. A resposta é enviada de volta ao cliente no Telegram.

Cada conversa no Telegram tem seu próprio histórico, isolado por chat.

Configurar um bot​

1. Criar o bot no Telegram​

Abra o @BotFather no Telegram e crie um novo bot:

/newbot

Siga as instruções. Ao final, o BotFather fornece um token no formato: 1234567890:ABCdefGHIjklmNOPqrstUVwxyz. Guarde esse token.

2. Cadastrar o bot na plataforma​

No painel, vá em Configurações > Canais. Clique em Adicionar bot do Telegram e preencha:

  • Token: o token que você copiou do BotFather.
  • Agente: qual especialista vai atender as mensagens deste bot.

A plataforma valida o token com o Telegram e gera uma chave interna (bot_key) para rotear as mensagens.

3. Registrar o webhook​

Na lista de bots, clique no bot que você cadastrou e depois em Registrar webhook. A plataforma configura o Telegram para entregar as mensagens recebidas pelo bot diretamente ao gateway.

4. Testar​

Envie uma mensagem para o seu bot no Telegram. O agente deve responder.

Múltiplos bots por organização​

Sua organização pode ter vários bots no Telegram, cada um atendido por um agente diferente. Cada bot é independente: suas conversas não se misturam.

Modo público (atendimento anônimo)​

O bot do Telegram pode atender qualquer pessoa que encontre o bot na busca do Telegram e inicie uma conversa. Nesse modo:

  • O agente designado precisa ter public: true no especialista.
  • As ferramentas disponíveis são limitadas ao que cada fonte MCP permite como "acesso anônimo".
  • O raciocínio e os passos de ferramenta ficam ocultos.

Allowlist (lista de permitidos)​

Você pode restringir quem pode conversar com o bot a uma lista de permitidos (allowlist). Quem não estiver na lista recebe um aviso com seu próprio ID do Telegram e a conversa não é processada pelo agente.

Para configurar:

  1. Edite o bot na tela de Canais.
  2. Em "Modo público", escolha "Somente permitidos".
  3. Adicione os IDs numéricos ou @usernames do Telegram das pessoas autorizadas.

Alternativamente, deixe em "Todo mundo" para qualquer pessoa poder conversar.

Gerenciamento de bots​

Na tela de Canais, você pode:

  • Listar todos os bots da sua organização.
  • Verificar o status de cada bot (se o webhook está ativo, qual o @username).
  • Editar o agente, o modo público ou a allowlist.
  • Remover um bot (o webhook no Telegram é desligado automaticamente).

Perguntas frequentes​

Preciso de um token diferente para cada bot? Sim. Cada bot no Telegram tem seu próprio token, fornecido pelo BotFather.

O agente lembra do histórico da conversa? Sim. Cada conversa no Telegram mantém seu histórico completo.

Posso ter o mesmo agente em mais de um bot? Sim. Vários bots podem ser atendidos pelo mesmo especialista.

O que acontece se eu remover o bot? O webhook no Telegram é removido e o bot para de responder. As conversas passadas permanecem no histórico da plataforma.