No Telegram, a empresa atende por um bot: uma conta própria, com nome e @, que você cria no BotFather em poucos minutos. Depois de conectar o bot ao Codewo, toda mensagem enviada a ele cai na Caixa de Entrada, e as respostas da equipe saem pelo bot.
O que você vai precisar
- Uma conta no Telegram, de qualquer número.
- Uns 5 minutos.
O Telegram não cobra pelo uso de bots nem pede verificação da empresa.
Como funciona
- O bot é a identidade da empresa no Telegram. O cliente encontra o bot pelo @ ou por um link, abre a conversa e manda a primeira mensagem.
- O bot nunca começa a conversa. O Telegram só deixa o bot escrever para quem já falou com ele.
- Com o canal criado ativo, o Codewo liga sozinho o recebimento das mensagens. Você não configura nada no Telegram além do próprio bot.
- O contato chega com o nome e a foto do perfil do Telegram, sem telefone.
Passo a passo
1. Criar o bot no BotFather
- No Telegram, procure @BotFather (o bot oficial do Telegram para criar bots) e abra a conversa.
- Envie
/newbot. - Escolha o nome que aparece no perfil, por exemplo "Atendimento Loja Exemplo". Dá para mudar depois.
- Escolha o username, terminado em "bot", por exemplo
lojaexemplo_atendimento_bot. Esse não muda depois. - O BotFather responde com o token, no formato
123456789:ABCdefGHIjklMNOpqrsTUVwxyz. Copie. O token é a chave do bot: quem tem o token controla o bot.
2. Conectar no Codewo
Em Configurações → Canais, clique em Adicionar Canal, escolha Telegram Bot e clique em Próximo. As etapas são Token, Verificação, Perfil e Detalhes.
- Token: cole o token no campo Token do Bot e clique em Testar Conexão.
- Verificação: o Codewo mostra o @, o nome e o ID do bot. Confira se é o bot certo.
- Perfil (opcional): ajuste Nome do Bot (até 64 caracteres), Descrição Curta (até 120, aparece na busca e no início das conversas) e Descrição (até 512, aparece em "O que este bot pode fazer?"). Se você mudar algo, o botão vira Salvar & Próximo e a alteração vai direto para o Telegram. Foto, username e mensagem de boas-vindas só mudam no BotFather.
- Detalhes: o Nome do Canal vem preenchido com o @ do bot. Deixe Canal Ativo ligado e clique em Criar Canal.
Se a empresa tem mais de uma equipe ou pessoa, o Codewo pergunta em seguida Quem atende este canal.
3. Testar
No celular, procure o @ do bot, inicie a conversa e mande "Oi". A conversa aparece na Caixa de Entrada. Responda de lá e confira a resposta no celular.
Depois de conectado
- Configurar, no menu do canal, abre Editar Canal Telegram: Nome do Canal, Canal Ativo, Sincronizar grupos e as Informações do Bot (ID, se pode ser adicionado a grupos e a situação). Com a situação em Erro ou Desconectado, aparece o botão Reconectar.
- Editar Perfil do Bot, no menu do canal, muda o nome, a descrição curta e a descrição a qualquer momento.
- Se aparecer Bot Deletado no Telegram, o bot foi apagado ou o token deixou de valer. O canal não recebe mais nada: crie um canal novo com um bot válido.
O que dá para fazer pelo Telegram
- Mensagens e anexos: texto, foto, vídeo, áudio, documento e localização. Foto até 10 MB; vídeo, áudio e documento até 50 MB.
- Editar e apagar mensagem enviada: o Codewo não põe prazo. Quem pode recusar é o Telegram, que não deixa um bot apagar mensagem enviada há mais de 48 horas. Nesse caso aparece "Falha ao excluir mensagem no Telegram".
- Reações nos dois sentidos. O Telegram aceita só uma lista própria de emojis; reação fora dela fica só no Codewo.
- Botões: mensagens com botões, enviadas por Automações, aparecem como teclado de resposta, que some depois do toque.
- Enquetes e quizzes que o cliente manda aparecem com as opções e, no quiz, com a resposta certa.
- Sem confirmação de leitura. O Telegram não conta ao bot quando o cliente leu, então as mensagens enviadas ficam como entregues.
- Mensagem apagada pelo cliente continua visível no Codewo, porque o Telegram não avisa o bot.
Grupos
O bot também atende grupos. Adicione o bot ao grupo pelo próprio Telegram, e o grupo vira uma conversa na Caixa de Entrada. Veja Grupos de WhatsApp e Telegram.
- Modo de privacidade. Todo bot nasce com ele ligado: no grupo, o bot só recebe comandos, menções ao @ dele e respostas às mensagens dele. Nesse caso, Configurar mostra o aviso Modo de privacidade ativo. Para receber tudo: no BotFather, envie
/mybots, escolha o bot e vá em Bot Settings → Group Privacy → Turn off. Depois, remova o bot do grupo e adicione de novo. - Sincronizar grupos desligado, em Configurar, faz o Codewo ignorar as mensagens de grupo. Para impedir que o bot seja colocado em grupos, desligue também no BotFather, com
/setjoingroups. - Em grupo, a reação do cliente só chega quando o bot é administrador do grupo.
Origem do lead pelo link do bot
O Codewo lê a origem na primeira mensagem de uma conversa nova. No Telegram, essa mensagem é o /start que o aplicativo envia quando o cliente toca para iniciar o bot a partir de um link:
| Como o cliente chegou | Origem registrada |
|---|---|
| Link Rastreável com o bot como destino | A origem do link, com UTMs e campanha |
Link do bot com um texto no final, como t.me/lojaexemplo_atendimento_bot?start=blackfriday |
Telegram, com a campanha "blackfriday" |
| Sem link com código ou texto | Direto |
- O Link Rastreável fica em Contatos, no botão Link Rastreável do topo da tela (no celular, no menu de três pontos). Escolha o bot em Canal de destino. O Telegram não aceita mensagem pré-preenchida: o código vai no próprio link. Veja Link Rastreável.
- O código do Link Rastreável vale 7 dias depois do clique. Se o cliente só iniciar o bot depois disso, a origem fica como Telegram, com o código no lugar da campanha, e as UTMs do link se perdem.
- No link com texto, use só letras sem acento, números,
_e-, com até 64 caracteres. É regra do Telegram. - A primeira mensagem aparece na conversa como
/startseguido do código ou do texto. É normal. - Se o cliente já tem uma conversa aberta, clicar num link novo não muda a origem dele.
Pegadinhas comuns
- Token vazado. Quem tem o token controla o bot. Gere outro no BotFather com
/revoke. O token antigo para de funcionar na hora, e a tela Configurar não troca o token de um canal que já existe: com o token novo, crie um canal novo e exclua o antigo. O bot continua o mesmo, e cada cliente continua sendo o mesmo contato no Codewo, porque ele é reconhecido pela conta do Telegram. Mesmo assim, guarde o token com cuidado desde o começo. - Um bot, um sistema. O Telegram entrega as mensagens de cada bot num único endereço. Se o mesmo bot for ligado a outra ferramenta, quem conectou por último passa a receber tudo, e o Codewo para de receber. Use um bot só para o Codewo.
- O bot não inicia conversa, nem por Transmissão: a transmissão pelo Telegram só alcança quem já conversou com o bot.
- Nada chega do grupo. Confira o modo de privacidade e se Sincronizar grupos está ligado.
- Username errado não tem conserto. Ele não muda depois de criado; o jeito é criar outro bot.
- Canal criado inativo não recebe nada. Use Ativar Canal no menu do canal: o Codewo liga o recebimento na hora.
Boas práticas
- Username simples, fácil de falar e de digitar:
lojaexemplo_boté melhor quexyz123_bot_2026. - Foto e descrição no perfil. O cliente vê isso ao abrir a conversa; bot sem foto parece abandonado.
- Link Rastreável em anúncio e divulgação. Sem ele, todo cliente vindo de campanha aparece como Direto no relatório.
- Horário e distribuição definidos. O Telegram não tem janela de 24 horas, então uma conversa sem dono pode esperar dias. Configure o horário de atendimento e quem atende o canal.