# Telegram

> Crie um bot no @BotFather, cole o token em Configurações › Canais › Telegram e atenda as conversas do bot na NexTags, com boas-vindas e comandos.

Endereço: https://help.nextags.com.br/integracoes/telegram/
Tipo: Integração

Atualizado em: 25/10/2026

O Telegram se conecta à NexTags por um bot. Você cria o bot no @BotFather, o robô oficial do Telegram para isso, e cola o token dele na NexTags. As conversas com o bot chegam na Caixa de Entrada e podem receber fluxos, sem prazo para responder. O bot não começa conversas: a pessoa precisa escrever primeiro.

## O que dá para fazer

- Dar as boas-vindas e oferecer comandos no menu do bot. Veja [Boas-vindas e comandos do Telegram](https://help.nextags.com.br/tutoriais/canais/telegram-comandos/).
- Atender as conversas do bot com a equipe na Caixa de Entrada. Veja [Responder uma conversa](https://help.nextags.com.br/tutoriais/caixa-de-entrada/responder-conversas/).
- Responder com fluxos e com um agente de IA. Veja [Criar um fluxo](https://help.nextags.com.br/tutoriais/fluxos/criar-fluxo/) e [Criar um agente de IA](https://help.nextags.com.br/tutoriais/ia/criar-agente/).

## Como conectar

### Passo 1: Crie o bot e copie o token

No Telegram, abra o @BotFather e envie **/newbot**. Escolha o nome do bot e o nome de usuário, que termina em "bot". No fim, o @BotFather manda o token, um texto como `123456789:AAH…`. Copie o token inteiro e não envie para ninguém: quem tem o token controla o bot.

### Passo 2: Cole o token em Configurações › Canais › Telegram

No pé do menu, clique em **Configurações**, abra a aba **Canais**, clique no cartão **Telegram** e em **Conectar**. Cole o token em **Bot Token** e clique em **Continuar**.

![Campo Bot Token preenchido com um token de exemplo e o botão Continuar liberado.](https://help.nextags.com.br/_img/canais-conectar/telegram-token.webp)
*1. O token colado. 2. Continuar.*

1. **Bot Token**: o token inteiro, com os números, os dois-pontos e o resto. O do print é só um exemplo.
2. **Continuar**: conecta o bot e abre o Dashboard.

### Passo 3: Escolha as boas-vindas e os comandos

Volte em **Configurações** › **Canais** › **Telegram**. O cartão mostra o bot conectado e as opções do canal.

![Cartão Telegram conectado: Desconectar, Mensagem de boas-vindas com o fluxo escolhido e Menu Persistente (Commands) com Editar e Excluir.](https://help.nextags.com.br/_img/canais-conectar/telegram-conectado.webp)
*O cartão Telegram conectado.*

1. **Desconectar**: tira o bot da NexTags.
2. **Mensagem de boas-vindas**: o fluxo que a pessoa recebe na primeira conversa com o bot.
3. **Menu Persistente**: os comandos do bot, que aparecem quando a pessoa digita / na conversa.

O passo a passo completo, com as abas **Criar Novo Bot** e **Conectar Bot Existente** da tela, está em [Conectar um bot do Telegram](https://help.nextags.com.br/tutoriais/canais/conectar-telegram/).

## Se não funcionou

### A NexTags não aceitou o token

Confira se copiou o token inteiro, sem espaços. Se ele foi trocado no @BotFather com /token, o antigo deixa de valer: use o novo. Para pegar o token de um bot que já existe, envie **/mybots** ao @BotFather e escolha o bot.

### Apareceu "Já conectado a outra conta comercial."

O bot já está em outra conta da NexTags, e o aviso mostra o ID e o nome dela. Desconecte lá e conecte de novo aqui.

### Ninguém aparece na Caixa de Entrada

O bot só recebe quem escreve para ele primeiro. Abra o bot pelo link t.me seguido do nome de usuário e mande uma mensagem de teste. Veja também [Erros do Telegram](https://help.nextags.com.br/tutoriais/erros/erros-do-telegram/).

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
Vou criar um bot do Telegram e conectar na NexTags. Leia esta página: https://help.nextags.com.br/integracoes/telegram.md

Meu negócio: [descreva]. Sugira o nome e o nome de usuário do bot, a mensagem de boas-vindas e até cinco comandos para o menu, cada um com a descrição curta. Não me peça o token do bot.
```