Telegram
Conecte seu agente ao Telegram para atender usuários via bot.
Visão geral
O canal Telegram permite que seu agente atenda usuários automaticamente através de um bot do Telegram. A configuração é simples e direta — basta criar um bot pelo BotFather, inserir o token no Take Sales e o agente começa a responder mensagens imediatamente.
Pré-requisitos
- Conta no Telegram — Para criar e gerenciar o bot
- Agente configurado — Um agente no Take Sales com prompt e configurações prontas
Passo a passo da configuração
1. Criar o bot no BotFather
O BotFather é o bot oficial do Telegram para criação e gerenciamento de bots.
- Abra o Telegram e pesquise por @BotFather
- Inicie uma conversa e envie o comando
/newbot - O BotFather pedirá um nome para o bot (nome de exibição, ex.: "Atendimento Take Sales")
- Em seguida, pedirá um username (identificador único, deve terminar com
bot, ex.:takesales_atendimento_bot) - O BotFather retornará o Bot Token — uma string no formato
123456789:ABCdefGhIjKlMnOpQrStUvWxYz - Copie o token com cuidado
Nunca compartilhe o Bot Token publicamente. Qualquer pessoa com o token pode controlar o bot. Se o token for comprometido, use o comando /revoke no BotFather para gerar um novo.
2. Criar o canal no Take Sales
- Acesse Canais no menu lateral
- Clique em Adicionar Canal
- Selecione Telegram
- Dê um nome de exibição e preencha:
| Campo | Descrição |
|---|---|
| Bot Token | Token gerado pelo BotFather |
- Clique em Criar Canal
- Vincule o canal ao agente em Agentes → [agente] → Canais → Conectar
3. Webhook automático
Ao criar o canal, o Take Sales configura automaticamente o webhook do Telegram. Diferente de outros canais, não é necessário configurar nada manualmente no lado do Telegram — o sistema registra o webhook via API automaticamente.
Se você precisar reconfigurar o webhook por algum motivo, basta editar o canal e salvar novamente. O Take Sales reenviará a configuração do webhook para o Telegram.
4. Testar o bot
- No Telegram, pesquise pelo username do bot que você criou
- Inicie uma conversa clicando em Iniciar (ou envie
/start) - Envie uma mensagem de texto
- O agente deve responder automaticamente
- Verifique se a conversa aparece em Conversas, com o canal Telegram
Configurações adicionais do bot
Você pode personalizar o bot diretamente pelo BotFather com os seguintes comandos:
| Comando | Descrição |
|---|---|
/setdescription | Define a descrição exibida antes de iniciar a conversa |
/setabouttext | Define o texto "Sobre" do perfil do bot |
/setuserpic | Define a foto de perfil do bot |
/setcommands | Configura os comandos disponíveis no menu do bot |
Configure uma descrição e foto de perfil no BotFather para transmitir mais profissionalismo. O visitante vê essas informações antes de iniciar a conversa.
Funcionalidades específicas do Telegram
Comandos do bot
O Telegram permite definir comandos (ex.: /start, /ajuda, /contato). Se você configurar comandos no BotFather, os usuários poderão acessá-los pelo menu do bot. O agente receberá o comando como uma mensagem de texto e poderá ser instruído no prompt para responder adequadamente.
Conversas em grupo
O bot pode ser adicionado a grupos do Telegram. Nesse cenário:
- O bot responde apenas quando é mencionado diretamente (
@seu_bot mensagem) ou quando o modo de privacidade está desativado - Para desativar o modo de privacidade, use o comando
/setprivacyno BotFather e selecione Disable - Em grupos, o agente receberá todas as mensagens e poderá participar da conversa
Desativar o modo de privacidade em grupos significa que o bot receberá todas as mensagens do grupo, o que pode gerar um volume alto de mensagens e consumo de tokens. Use com cautela.
Mensagens com mídia
O agente recebe notificações de imagens, documentos e outros tipos de mídia enviados pelos usuários. O processamento depende das capacidades configuradas no agente.
Boas práticas
- Respostas concisas — Usuários do Telegram esperam respostas rápidas e diretas. Configure o prompt do agente para ser objetivo
- Use o comando /start — Instrua o agente no prompt a dar uma mensagem de boas-vindas quando receber o comando
/start - Evite markdown complexo — O Telegram suporta markdown básico, mas formatação complexa pode não renderizar corretamente
- Configure comandos úteis — Defina comandos no BotFather que orientem o usuário (ex.:
/servicos,/horarios,/contato) - Monitore o uso em grupos — Se o bot for adicionado a grupos, acompanhe o consumo de tokens e o comportamento do agente