Seus clientes não vivem todos em um único aplicativo. Alguns mandam mensagem no WhatsApp, outros no Telegram. Até agora o WATeamInbox atendia o primeiro grupo; agora atende os dois, na mesma caixa de entrada compartilhada, com as mesmas atribuições, notas e respostas que sua equipe já usa.
O WATeamInbox se conecta ao Telegram pela Bot API oficial. Você cria um bot, cola o token dele no aplicativo e os chats diretos recebidos aparecem na caixa de entrada ao lado das suas conversas do WhatsApp.
Uma coisa para saber primeiro
Um bot do Telegram só pode responder a pessoas que já iniciaram uma conversa com ele. Um cliente precisa abrir seu bot e tocar em Iniciar antes que o bot possa enviar mensagens a ele. O WATeamInbox não pode usar um bot para enviar mensagens frias a um usuário arbitrário do Telegram — isso é uma regra do Telegram, não uma limitação do WATeamInbox. Na prática, você compartilha o link do bot (ou o nome de usuário) onde já compartilha seus dados de contato, e as conversas começam quando os clientes entram em contato.
Conecte um bot em quatro passos
-
Crie um bot com o BotFather. Abra o @BotFather no Telegram, execute
/newbot, escolha um nome e um nome de usuário e copie o token que ele fornecer. Trate esse token como uma senha. -
Prepare sua instância auto-hospedada. O Telegram roda no lado neutro de canal do WATeamInbox, então configure o chaveiro de credenciais de canal, defina um
APP_URLHTTPS público, reconcilie os índices da espinha de canais e habilite o Telegram para o espaço de trabalho. O guia de operações de canal neutro explica isso, e o provisionamento falha de forma fechada se algum pré-requisito estiver faltando — então uma instância parcialmente configurada se recusará a conectar em vez de se comportar mal silenciosamente. -
Abra Configurações → Conexões. Escolha Bot do Telegram, dê à conexão um nome reconhecível e cole o token do BotFather. O WATeamInbox valida o bot e registra o webhook dele para você. O token é armazenado criptografado e nunca é exibido novamente.
-
Envie uma mensagem de teste. Abra o bot no Telegram como se você fosse um cliente, toque em Iniciar e envie uma mensagem de baixo risco. Ela deve aparecer na caixa de entrada compartilhada em instantes, onde um colega autorizado pode atribuí-la e responder.
Para a versão completa com destaques, veja o documento Conecte um bot do Telegram.
Requisitos do webhook
O Telegram entrega mensagens chamando o webhook HTTPS do seu aplicativo, então sua instância precisa estar acessível a partir da internet pública via HTTPS. Para desenvolvimento local, exponha o aplicativo por meio de um túnel confiável e mantenha o APP_URL alinhado com essa origem — caso contrário, as chamadas de webhook do Telegram não chegarão e as conversas não aparecerão.
Ele se comporta como qualquer outro canal
Uma vez conectado, um chat do Telegram é uma conversa de primeira classe. Sua equipe pode:
- Atribuí-lo a um colega e deixar notas internas
- Responder, com a mensagem entregue de volta através do bot
- Resolver, reabrir e acompanhá-lo no mesmo fluxo de casos do WhatsApp
Você pode executar WhatsApp e Telegram lado a lado em um único espaço de trabalho. Quando há mais de uma conta conectada, o WATeamInbox é explícito sobre a qual conta uma conversa pertence, para que uma resposta nunca saia do lugar errado.
Se um token vazar
Se um token de bot for exposto, revogue-o e gere um novo no BotFather, desvincule a conexão afetada no WATeamInbox e reconecte o bot com o novo token. Suas conversas, atribuições e notas existentes são mantidas. Nunca cole tokens em issues, logs, capturas de tela ou mensagens de suporte.
Experimente
O suporte ao Telegram já está disponível na edição open-source hoje. Auto-hospede o WATeamInbox, siga a documentação de conexão do Telegram e dê aos seus clientes mais uma forma de alcançar uma equipe que responde a partir de uma única caixa de entrada compartilhada.