Use este artigo para conectar um ou mais bots 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 no Inbox junto com todos os outros canais, 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 ao 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 no seu Inbox do Intercom em poucos segundos.

Conectando múltiplos bots do Telegram

Você pode conectar mais de um bot do Telegram a um único workspace — útil se você gerencia bots separados para diferentes marcas, regiões ou linhas de produtos. Cada bot que você adiciona aparece na lista em Configurações > Canais > Telegram com seu próprio @username e status de conexão. Para adicionar outro bot, repita os passos de conexão acima com o token do novo bot.

Atribuir uma marca a um bot do Telegram

Se seu workspace estiver em um plano multimarcas, você pode atribuir uma marca a cada bot do Telegram conectado. Isso controla a persona que o Fin usa ao responder e o conteúdo do help center de onde o Fin responde — cada bot pode apontar para uma marca diferente de forma independente.

Para atribuir uma marca:

Vá para Configurações > Canais > Telegram.
No cartão do bot, abra o seletor Marca.
Selecione a marca que você quer que o bot use.

Conversas iniciadas pelo bot são marcadas com a marca como um atributo padrão da conversa, para que sejam segmentadas corretamente em visualizações, relatórios e condições de workflow baseadas na marca.

Nota: Limpar o seletor de marca retorna o bot ao padrão do workspace. A atribuição de marca está disponível apenas em planos multimarcas.

Roteamento de conversas por bot

Se seu workspace tiver mais de um bot do Telegram conectado, você pode rotear as conversas de cada bot independentemente usando um atributo dedicado da conversa.

O atributo do bot do Telegram

Cada conversa que chega via Telegram carrega automaticamente um atributo Telegram bot somente leitura que registra de qual bot ela veio, mostrado pelo nome de usuário do Telegram desse bot (por exemplo, support_acme_bot). Esse atributo está disponível em:

Regras de atribuição
Ramos condicionais de Workflow
A barra lateral do inbox
Relatórios

Para configurar o roteamento, crie uma regra de atribuição ou workflow com uma condição em Telegram bot, escolha um bot no menu suspenso e direcione para o time que o possui. Repita para cada bot. Workspaces com apenas um bot do Telegram conectado verão o atributo com uma única opção — o atributo está presente, mas não há nada para rotear entre bots.

Limitações

Sem histórico. Apenas conversas criadas em ou após 12 de agosto de 2026 carregam o atributo. Conversas abertas antes dessa data permanecem em branco permanentemente — não há preenchimento retroativo. Regras que ramificam pelo atributo não corresponderão a conversas antigas.
Somente leitura. O atributo é definido automaticamente quando a conversa é criada. Colegas de equipe e administradores não podem defini-lo ou corrigi-lo manualmente, inclusive na barra lateral.
Não disponível na API pública. O atributo não é exposto via REST API, portanto não pode ser lido ou filtrado por integrações externas.
Um workflow por vez. Uma conversa executa um único workflow visível para o colega de equipe por vez. Se outro workflow ativo já estiver lidando com a conversa, um workflow que ramifica pelo Telegram bot não será executado. Essa é a causa mais comum de uma regra de roteamento parecer não funcionar — verifique se outro workflow está rodando primeiro.
Chats em grupo com dois bots. Se dois dos seus bots estiverem no mesmo grupo do Telegram, cada um abre sua própria conversa no Intercom para esse grupo, então a mesma mensagem aparece duas vezes e ambos os bots podem responder. Esse é um comportamento pré-existente, não específico deste recurso.

Bots desconectados

Se um bot for desconectado depois, ele permanece disponível como uma opção arquivada no seletor de atributos. Regras existentes e conversas antigas que o referenciam continuam a resolver corretamente.

Como desconectar o Telegram

Para desconectar um bot do Telegram, vá para Configurações > Canais > Telegram e clique em Desconectar.

Conversas existentes no Inbox não são afetadas quando você desconecta, permanecem acessíveis e ainda podem ser gerenciadas pelos colegas de equipe. No entanto, os clientes não poderão enviar novas mensagens para o bot até que ele seja reconectado.

Importante: Desconectar um bot remove permanentemente seu 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.

Transmissões do Telegram

Quando você envia uma transmissão, um seletor From bot aparece se você tiver mais de um bot do Telegram conectado. Selecione de qual bot a transmissão será enviada — a lista de canais automaticamente se restringe aos canais desse bot. Se você tiver apenas um bot conectado, as transmissões funcionam como antes, sem etapas extras.

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.

Defina o domain do seu bot no BotFather

O Login Widget 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 você não tem 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 no seu 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 a partir do chat.
Ele é solicitado a verificar sua identidade com o botão Log in with 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 /setdomain no BotFather com o domain correto para sua região.
"Falha na verificação" após tocar no login — confirme se o bot específico que lidou com a conversa corresponde ao bot para o qual você definiu o domain. Com múltiplos bots conectados, cada bot precisa ter seu domain definido separadamente no BotFather.
A conexão falhou — Cada bot do Telegram só pode estar conectado a um workspace do Intercom por vez. Se você tentar conectar um bot que já está em uso em outro workspace, a conexão falhará.

Configurando o Telegram no Intercom