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
- Abra o BotFather pelo atalho acima. Use /newbot para criar um bot ou /mybots para administrar um existente da empresa.
- Obtenha o token do bot. No Omnichannel, preencha Token do BotFather e Nome interno do canal.
- Salve a conexão e confira o resultado da validação.
- Revise nome público, descrição e descrição curta. Selecione um fluxo de entrada ativo e publicado e salve.
- No Telegram, abra o bot com uma conta de teste autorizada e inicie a conversa. Confira a chegada no Omnichannel.
- 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.
- 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.