Use este artigo para conectar um bot do Telegram ao seu workspace do Intercom, entender o que acontece após a conexão estar ativa e saber o que fazer se precisar desconectar. Após a configuração, as conversas do Telegram aparecem na Inbox junto com todos os outros canais, o Fin as gerencia automaticamente e os Workflows são aplicados com total paridade.
O que você precisará antes de conectar
Você precisará de acesso de administrador no seu workspace do Intercom para conectar ou desconectar um canal do Telegram.
Antes de conectar, você precisará de um bot do Telegram e do seu bot token (uma credencial que dá permissão ao Intercom para enviar e receber mensagens em nome do seu bot). Crie um bot via @BotFather (bot oficial do Telegram para criar e gerenciar bots). Veja a documentação do Telegram para instruções passo a passo.
Nota: Seu bot token dá controle total sobre o bot. Mantenha-o seguro e não o compartilhe além do necessário para a conexão com o Intercom.
Como conectar o Telegram
Tenha seu bot token do @BotFather pronto antes de começar.
Vá para Configurações > Canais > Telegram.
Cole seu bot token no campo Bot token.
Clique em Conectar.
Uma vez conectado:
O Intercom valida seu bot token.
O webhook (o endpoint de conexão que recebe mensagens do Telegram) é registrado, vinculando seu bot do Telegram à Inbox.
A instalação é registrada no Registro de Atividades do Time (Configurações > Segurança > Atividades do Time).
O canal do Telegram aparece como ativo em Configurações > Canais > Telegram assim que a configuração estiver completa. Para verificar a conexão, envie uma mensagem de teste para seu bot do Telegram — ela deve aparecer como uma nova conversa na sua Inbox do Intercom em poucos segundos.
Posso usar o mesmo bot em vários workspaces?
Cada bot do Telegram só pode ser conectado a um workspace do Intercom por vez. Se tentar conectar um bot que já está em uso em outro workspace, a conexão falhará.
Como desconectar o Telegram
Para desconectar, vá para Configurações > Canais > Telegram e clique em Desconectar.
Conversas existentes na Inbox não são afetadas quando você desconecta, permanecem acessíveis e ainda podem ser gerenciadas pelos colegas. No entanto, os clientes não poderão enviar novas mensagens para o bot até que ele seja reconectado.
Importante: Desconectar remove permanentemente o bot token e o segredo do webhook (uma credencial de segurança vinculada à conexão do webhook) do Intercom. Essas credenciais não podem ser recuperadas. Para reconectar, você precisará regenerar seu bot token via @BotFather e completar a configuração novamente.
Envie formulários de ticket hospedados para clientes do Telegram
Você pode coletar informações estruturadas dos seus clientes do Telegram enviando um formulário de ticket hospedado — da mesma forma que pode no Discord, Slack e WhatsApp. O cliente verifica sua identidade com um toque usando o login integrado do Telegram, depois preenche e envia o formulário sem sair do chat.
Nota: Enviar formulários de ticket hospedados para clientes do Telegram está atualmente em beta.
Defina o domain do seu bot no BotFather
O Widget de Login do Telegram só funciona em um domain registrado com seu bot. Você deve definir isso uma vez por bot — o domain depende da região de hospedagem do seu workspace:
Região | Domain a definir |
Estados Unidos | app.intercom.com |
Europa | app.eu.intercom.com |
Austrália | app.au.intercom.com |
Abra um chat com @BotFather no Telegram.
Envie
/setdomain.Selecione seu bot.
Envie o domain para sua região da tabela acima.
Nota: Se não tiver certeza de qual região seu workspace está, verifique a URL que você usa para entrar no Intercom — ela corresponde a um dos domains acima. Definir o domain da região errada impedirá que o widget de login apareça.
Envie um formulário para um cliente do Telegram
Abra a conversa do Telegram na sua Inbox.
No compositor de resposta (ou via as ações
⌘K/Ctrl+K), escolha enviar um formulário de ticket hospedado.Escolha o formulário e envie. O cliente recebe um link no chat do Telegram.
O que o cliente vê
Ele abre o link do chat.
Ele é solicitado a verificar sua identidade com o botão Entrar com o Telegram.
Após um toque, o formulário abre — ele preenche e envia.
O ticket enviado aparece de volta na conversa, assim como qualquer outro formulário de ticket hospedado.
Solução de problemas
O botão de login não aparece — o domain do bot não está definido, ou o domain da região errada foi usado. Execute novamente
/setdomainno BotFather com o domain correto para sua região."Falha na verificação" após tocar em entrar — confirme se o bot conectado à sua integração do Telegram corresponde ao bot para o qual você definiu o domain.