OmnichannelCentral de conhecimento
Canais de atendimento

Conectar e administrar um bot Telegram

Cadastre um bot oficial, configure seu perfil e reconecte o webhook quando necessário.

Onde encontrarConfigurações → Integrações → Telegram

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra o BotFather pelo atalho acima. Use /newbot para criar um bot ou /mybots para administrar um existente da empresa.
  2. Obtenha o token do bot. No Omnichannel, preencha Token do BotFather e Nome interno do canal.
  3. Salve a conexão e confira o resultado da validação.
  4. Revise nome público, descrição e descrição curta. Selecione um fluxo de entrada ativo e publicado e salve.
  5. No Telegram, abra o bot com uma conta de teste autorizada e inicie a conversa. Confira a chegada no Omnichannel.
  6. Use Atualizar status para consultar a conexão. Se a recepção falhar, leia os registros e use Reconectar webhook após corrigir a causa.
  7. Use Desconectar somente quando a operação desse bot deva ser interrompida.

Resultado esperado

O bot pode receber as mensagens iniciadas pelos contatos e encaminhá-las ao Omnichannel.

Observações importantes

  • A integração utiliza um bot da Bot API. Não exige api_id/api_hash de uma conta pessoal em my.telegram.org.
  • O token fica protegido após salvar. Ao editar, siga a indicação da tela para manter a credencial atual.
  • O mesmo bot não deve ter seu webhook configurado simultaneamente por outro sistema.
  • O contato precisa iniciar uma conversa com o bot. Conectar o bot não importa automaticamente os contatos de uma conta pessoal.

Se precisar de ajuda

  • Token inválido: confira a credencial do bot correto.
  • Bot sem mensagens: confira o webhook e se o usuário iniciou uma conversa com ele.

Referências oficiais