Voltar para a documentaçãoIntegrações

Telegram

Traga seu próprio bot do Telegram, vinculado a um agente, para DMs e grupos.

Última atualização em 10 de julho de 2026 · 4 min read

O Telegram é o canal certo quando o Slack não é uma opção — você está fora do tenant do Slack do espaço de trabalho, está colaborando com um grupo que vive no Telegram, ou quer um canal de DM móvel e leve com o Zero, separado do Slack da sua equipe.

Você traz seu próprio bot. Cada bot do Telegram é vinculado a um único agente no seu espaço de trabalho da VM0, então um bot pessoal e um bot de equipe podem rotear para agentes diferentes com skills diferentes.

Conectando

  1. Fale com o @BotFather no Telegram. Rode /newbot, nomeie seu bot e copie o token que o BotFather fornecer.
  2. Na VM0, abra Where Zero works e escolha Telegram.
  3. Cole o token do bot. Escolha para qual agente o bot deve rotear.
  4. (Para uso em grupo) Desative o modo de privacidade do bot no BotFather: /setprivacy → escolha seu bot → Disable. Sem isso, o bot só consegue ver mensagens que o mencionem diretamente com @; com o modo desativado, o bot lê o contexto do grupo em torno das menções e responde.
  5. Abra o Telegram e envie uma mensagem ao bot. A primeira mensagem inicia uma sessão vinculada na VM0.

Como você usa o Zero no Telegram

Dois padrões principais:

Mande DM para o bot. Comporta-se como um chat privado com o Zero. Mensagens, arquivos, fotos — o Zero vê tudo. Cada thread de DM mapeia para uma sessão na VM0.

Adicione o bot a um grupo. Com o modo de privacidade desativado, o bot lê as mensagens em torno das menções e responde. Mencione o bot com @ ou responda às mensagens dele para manter um fluxo. Os outros membros do grupo nunca veem o raciocínio do Zero, apenas o resultado que o bot publica de volta.

Fluxos de trabalho comuns no Telegram

  • Triagem de caixa de entrada no celular. No trem, mande DM para o seu bot: "resuma meu Slack não lido do #cs." O Zero responde em segundos.
  • Grupos de fornecedores ou parceiros. Adicione o bot a um grupo com pessoas de fora da sua empresa. O bot cuida de agendamentos, lembretes ou tradução sem expor o seu Slack interno.
  • Bots por agente. Vincule um bot de pesquisa ao seu agente de pesquisa e um bot pessoal ao seu agente pessoal. Mesmo app do Telegram, bots diferentes, agentes diferentes.

Roteamento por agente

Cada token de bot é vinculado a exatamente um agente. Se você quer um agente diferente respondendo, crie um segundo bot no BotFather e vincule-o. Isso é por design: a identidade de um bot do Telegram é a identidade do agente para aquela superfície.

Suporte a arquivos

O Telegram suporta fotos, notas de voz, documentos e PDFs. O Zero ingere todos eles como entradas de sessão. Arquivos de saída (artefatos que o Zero produz) são retornados como documentos ou imagens do Telegram inline.

Armadilhas comuns

  • O bot não responde em um grupo. O modo de privacidade ainda está ativado. Rode /setprivacy novamente no BotFather → Disable, depois remova e adicione o bot novamente ao grupo.
  • Agente errado respondendo. O token do bot está vinculado a um único agente. Para mudar, troque o vínculo em Where Zero works ou use um bot separado.
  • Token do bot vazado. Rotacione-o no BotFather (/revoke), depois atualize o token na VM0. O token antigo para de funcionar imediatamente.

O que vem a seguir

  • Veja Skills para capturar fluxos de trabalho móveis recorrentes.
  • Veja Permissions para o que o Zero pode e não pode fazer via seu bot.