Se os clientes falam com você pelo WhatsApp enquanto a equipe trabalha no Telegram, a divisão aparece muito rápido: algumas conversas ficam no WhatsApp, outras discussões passam para o Telegram, e os atendentes começam a responder a partir de contas pessoais. Como resultado, mensagens se perdem, o contexto se quebra e o controle da comunicação fica mais fraco.
Uma opção mais prática é transformar o Telegram na interface única de trabalho e deixar o WhatsApp como o canal visível para o cliente. É exatamente isso que a combinação GramDeskBot + Twilio oferece: o cliente escreve no WhatsApp, a mensagem aparece no Telegram, o responsável responde no Telegram e a resposta volta para o WhatsApp.
Se você quer o fluxo de negócio e não só o setup técnico, veja o caso de uso de suporte de WhatsApp no Telegram. Para lojas, a mesma configuração também atende dúvidas de pedidos, entrega e devolução.
Como funciona o fluxo entre WhatsApp e Telegram
Depois da configuração, o fluxo fica assim:
| Etapa | O que acontece | Onde acontece |
|---|---|---|
| 1 | O cliente envia uma mensagem | |
| 2 | O Twilio recebe o evento e o encaminha ao GramDeskBot | Webhook do Twilio |
| 3 | A mensagem aparece em uma conversa separada para a equipe | Telegram |
| 4 | O responsável responde no tópico ou no chat | Telegram |
| 5 | A resposta volta para o cliente | WhatsApp via Twilio |
Como resultado, o Telegram vira a inbox única da equipe, enquanto o WhatsApp continua sendo o canal externo de comunicação com o cliente.
O que você precisa antes de começar
Antes de começar, confirme que você já tem:
- um bot do Telegram conectado ao GramDeskBot
- acesso ao management bot
@GramDeskBot - uma conta no Twilio
- um WhatsApp sender já configurado no Twilio
Se o seu bot do Telegram ainda não estiver conectado, faça primeiro a configuração básica do GramDeskBot e só depois adicione WhatsApp via Twilio.
Precisa de um bot para suporte no Telegram?
Primeiro conecte seu bot do Telegram ao GramDeskBot e depois adicione o WhatsApp como canal adicional de entrada.
Configuração passo a passo no Telegram e no Twilio
Etapa 1. Abra o management bot e a lista de bots
No Telegram, abra:
@GramDeskBotDepois toque em:
🤖 Meus botse escolha o bot necessário.
Etapa 2. Abra a seção WhatsApp via Twilio
No cartão do bot, abra:
📲 WhatsApp via TwilioSe a integração ainda não tiver sido configurada, você verá o botão:
Conectar Twilio WhatsAppEtapa 3. Inicie o fluxo de conexão
Depois disso, o bot vai pedir três parâmetros, um de cada vez.
Twilio Account SID
O bot mostrará a etapa:
Passo 1 de 3 — Twilio Account SIDNo Twilio, abra:
Twilio Console → DashboardCopie o Account SID. Ele deve começar com AC.
Twilio Auth Token
Na segunda etapa, o bot mostrará:
Passo 2 de 3 — Twilio Auth TokenO Auth Token fica ao lado do Account SID no Twilio Console. É uma chave secreta e não deve ser compartilhada fora do processo de configuração.
WhatsApp sender number
Na terceira etapa, o bot mostrará:
Passo 3 de 3 — WhatsApp sender numberInforme o número usado no Twilio como WhatsApp sender em formato internacional:
+14155238886Importante:
- informe o número apenas no formato
+123... - não adicione o prefixo
whatsapp: - não use um número pessoal, a menos que ele realmente esteja registrado como sender no Twilio
Etapa 4. Revise o resumo e confirme a configuração
Depois de informar os dados, o bot mostrará uma tela de revisão antes de salvar. Nela você verá:
- um
Account SIDmascarado - o status do
Auth Token - o número do WhatsApp
Se tudo estiver correto, toque em:
ConfirmarDepois disso, a configuração será salva no GramDeskBot.
Etapa 5. Obtenha os webhook URLs
Depois de salvar, o bot mostrará duas URLs que você precisa adicionar na configuração do WhatsApp sender no Twilio:
- o webhook para mensagens recebidas
- o webhook para status de entrega
Na interface do bot, essa é uma etapa separada de configuração de webhook do Twilio depois que as credenciais são salvas.
Quais webhook URLs colocar no Twilio
No Twilio, use estes endereços:
When a message comes in
https://api.gramdeskbot.com/twilio/inboundMethod:
POSTStatus callback
https://api.gramdeskbot.com/twilio/statusMethod:
POSTEsses webhooks são necessários para duas tarefas diferentes: o primeiro recebe mensagens de entrada do WhatsApp e o segundo atualiza os status de entrega das respostas de saída.
Onde isso é configurado no Twilio
Abra seu WhatsApp sender no painel do Twilio e adicione ambas as URLs nos campos correspondentes de webhook. Depois salve a configuração do sender.
| Campo no Twilio | Valor | Method |
|---|---|---|
| When a message comes in | https://api.gramdeskbot.com/twilio/inbound | POST |
| Status callback | https://api.gramdeskbot.com/twilio/status | POST |
Como verificar se a integração funciona
Depois de salvar os webhooks no Twilio, verifique a integração em duas etapas.
Primeiro, confira as mensagens recebidas
Envie uma mensagem de teste do WhatsApp para o número sender.
Se tudo estiver configurado corretamente:
- a mensagem aparecerá no Telegram
- um diálogo ou tópico separado será criado para o cliente
- o webhook no cartão da integração ficará verificado
Depois, ative as respostas de saída
Mesmo que as mensagens recebidas já estejam chegando, as respostas enviadas pelo Telegram ainda podem estar desativadas. No cartão da integração, confira o campo:
AtivadoSe ele mostrar não, toque em:
AtivarEsse detalhe é importante: antes dessa etapa, o Telegram pode já aceitar mensagens de entrada, mas ainda não devolver respostas para o WhatsApp.
Teste final em duas direções
Depois de ativar:
- envie uma mensagem pelo WhatsApp e confirme que ela chega ao Telegram
- responda pelo Telegram e confirme que a mensagem volta ao WhatsApp
Se as duas direções funcionarem, a integração está configurada corretamente.
O que costuma falhar
A maior parte dos problemas se resume a um destes pontos:
- foi adicionada uma webhook URL incorreta no Twilio
- o method do webhook não é
POST - foi informado um
WhatsApp sender numberincorreto - a integração ainda não foi ativada para respostas de saída
- as alterações não foram salvas no Twilio depois de editar o sender
Se a mensagem recebida chega ao Telegram, mas a resposta não volta, revise primeiro o status Ativado e o botão Ativar.
A limitação de 24 horas do WhatsApp
Mesmo com a configuração correta, o WhatsApp tem uma limitação padrão para respostas normais.
Se tiverem passado mais de 24 horas desde a última mensagem do cliente:
- uma resposta normal pode deixar de ser enviada
- pode ser necessária uma mensagem de template para continuar a conversa
Isso não é uma limitação do GramDeskBot nem do Telegram. É uma regra padrão do WhatsApp Business API ao usar o Twilio.
FAQ sobre conectar WhatsApp ao Telegram
Posso usar esse fluxo para uma equipe e não apenas para uma pessoa?
Sim. Esse é justamente o objetivo da integração: os clientes continuam escrevendo pelo WhatsApp, enquanto a equipe trabalha no Telegram como interface compartilhada.
O que devo fazer se o bot disser que o webhook foi verificado, mas as respostas ainda estiverem desativadas?
Abra o cartão da integração e toque em Ativar. No produto, essa é uma etapa separada depois que o webhook de entrada já está funcionando.
Posso usar meu número pessoal do WhatsApp?
Só se esse número estiver realmente conectado no Twilio como sender. Caso contrário, você precisa usar o número que está registrado no Twilio para envio de mensagens do WhatsApp.
Por que o artigo usa nomes de campos em inglês como Account SID e Auth Token?
Porque é exatamente assim que esses campos aparecem no Twilio Console e em parte da interface da integração. Traduzir tudo dentro do artigo dificultaria a comparação com a configuração real.
Conclusão
A integração entre WhatsApp e Telegram usando Twilio permite manter o WhatsApp como canal visível para o cliente e transformar o Telegram na interface única de trabalho para a equipe. Isso elimina a separação entre canais, reduz o risco de perder conversas e entrega uma inbox compartilhada real sem a necessidade de um helpdesk separado.
Se você precisa desse fluxo, conecte primeiro seu bot do Telegram ao GramDeskBot, depois adicione WhatsApp via Twilio e verifique as duas direções: mensagens recebidas e respostas de saída.