Bot no Telegram — Chatonaut

Antes de tudo

Não temos WhatsApp

No Brasil essa é a primeira pergunta. Melhor responder na segunda tela do que deixar você descobrir na página de preços.

O WhatsApp não está na nossa lista de canais e não vai estar. Se era isso que você procurava, acabamos de te devolver meia hora do seu dia.

O que temos são três canais: Telegram, Instagram e o chat no site. Os três caem na mesma Caixa de entrada, são automatizados pelos mesmos fluxos e dividem o mesmo agente de IA.

E também não vamos fingir que o Telegram é o aplicativo de todo mundo por aqui — não é. Aqui ele é o aplicativo das comunidades: grupo de alunos, canal de avisos, lista de vagas, comunidade de cupons, sala de mentoria. Quem está lá entrou porque quis. É essa diferença que sustenta o resto desta página.

A diferença

No Telegram, a primeira mensagem pode ser sua

Se você chegou pela nossa página do Instagram, é aqui que a regra muda.

Instagram: quem faz as regras é a Meta

Você responde no relógio deles

Só dá para escrever para quem escreveu antes — e só por 24 horas.
Um comentário abre 7 dias para falar uma vez com aquela pessoa no Direct.
Não existe transmissão para seguidores. Nem com a gente, nem com ninguém.

Você escreve quando tem o que dizer

Quem tocou em Iniciar (/start) continua ao seu alcance hoje, no mês que vem e no dia em que você tiver novidade.
Uma transmissão chega à lista inteira, ou só a quem tem a tag que você escolher.
Cada link pode levar um parâmetro, então o bot já sabe de qual publicação a pessoa veio.

Uma regra não muda: a pessoa dá o /start primeiro. Ninguém recebe mensagem do seu bot do nada — nem no Telegram, nem com a gente. E quem espaça as transmissões grandes somos nós, porque o Telegram deixa um bot enviar cerca de 30 mensagens por segundo, e um bot que bate nesse teto não serve para ninguém.

Veja o que fazemos no Instagram.

Três tipos de bloco. O construtor é isso.

Você monta o fluxo num quadro: uma mensagem, uma condição, uma ação. Sem código e sem um servidor seu para manter de pé.

Uma mensagem com botões embaixo

Texto, foto, vídeo, arquivo, áudio, figurinha. Os botões ficam abaixo da mensagem: um abre um link, o outro leva a pessoa um passo adiante.

O Telegram pinta o botão de azul, verde ou vermelho — assim “Confirmar” e “Cancelar” param de parecer a mesma coisa.

Na conversa

B

Quer o material da aula de hoje ou a agenda da semana? Material de hoje Agenda da semana

Material de hoje

Uma condição para abrir o caminho em dois

Separe pelo que a pessoa escreveu — uma palavra, um número, um e-mail, um telefone. Pelas tags que ela carrega. Pela hora do dia. Ou por estar inscrita no seu canal, se o seu bot for administrador dele.

Uma ação para aquilo virar alguma coisa

Coloque uma tag. Guarde a resposta e use mais tarde: {{var.cidade}} na mensagem seguinte. Espere uma hora. Receba o aviso no seu Telegram. Passe a conversa para um atendente. Ou chame uma URL sua.

Antes de ativar, a “Prévia” roda o fluxo de verdade com você: os mesmos blocos e as mesmas condições, sem que nada chegue a ninguém.

Links com parâmetro

Um link para cada campanha

Qualquer link para o seu bot pode levar um parâmetro. O bot lê esse valor antes de dizer a primeira palavra e começa pelo fluxo que você preparou para aquele link.

O valor fica guardado na conversa: uma mensagem ou uma condição mais adiante ainda usa esse dado.
O mesmo link vale no story, na bio, no anúncio, no QR code do balcão e na mensagem fixada do grupo.
Você descobre de onde veio cada pessoa sem precisar perguntar. “Como você chegou até aqui?” é a pergunta que ninguém responde.

O link que você espalha

↗

t.me/seubot?start=canal

na mensagem fixada do grupo

o bot lê canal e começa por aquele fluxo

Primeira mensagem

B

Você veio do canal. Te mando o material de hoje e, se quiser, aviso quando abrir a próxima turma. Quero o aviso

Comunidade

Um canal fala para todo mundo. O bot fala com cada um.

É o uso mais brasileiro do Telegram: a audiência já está no grupo ou no canal, e mesmo assim não dá para puxar assunto com uma pessoa só. O bot resolve exatamente esse pedaço.

01

Você espalha um link com parâmetro

Na descrição do canal, na mensagem fixada do grupo, no story, no QR code do balcão. Cada lugar leva o seu parâmetro, então o bot já sabe de onde a pessoa veio.

02

A pessoa toca em Iniciar

A partir daí existe uma conversa — dela com você, fora do grupo. É o único jeito de o bot poder escrever depois.

03

O bot confere quem está no canal

Uma condição pergunta ao Telegram se aquela pessoa está inscrita, antes de entregar o arquivo, o link ou o combinado. Basta que o seu bot seja administrador do canal.

04

A tag fica, e a lista é sua

O fluxo marca com uma tag quem passou por ali. Na semana seguinte, a transmissão vai só para essa tag — sem depender do alcance de ninguém.

Ninguém entra nessa lista sem tocar em Iniciar. Não dá para importar os membros do grupo: o Telegram não entrega essa lista aos bots, e a gente também não inventa uma.

Transmissões para uma lista que é sua

Nela está todo mundo que deu /start. Sem conta de anúncios no meio e sem algoritmo decidindo quem vê você.

Todo mundo, ou só uma tag

Envie para todas as conversas do bot, ou só para quem um fluxo marcou antes.

Botões dentro da mensagem

Um botão que abre um link, ou outro que coloca a pessoa dentro de um fluxo e segue a conversa dali.

Agora, ou com data marcada

Programe e vá cuidar de outra coisa. No fim, cada destinatário tem o seu status — enviada, com erro ou ignorada — e os erros dizem o motivo.

Bloquearam o bot? O Telegram avisa, a gente marca a conversa, e a transmissão seguinte passa direto em vez de gastar o seu limite de envio numa porta fechada.

O agente responde. A pessoa assume.

O mesmo agente trabalha no Telegram, no Instagram e no chat do seu site: uma base de conhecimento só para os três.

Ele aprende com o que você já escreveu

Suba um arquivo, cole um texto ou dê o endereço do seu site para ele ler. O agente responde a partir daí e não perde o fio da conversa.

Ele sabe a hora de sair de cena

Pediram para falar com um atendente? A conversa vai para o seu time, marcada e esperando. O bot para de falar por cima.

Uma Caixa de entrada e papéis de verdade

Todos os canais caem na mesma Caixa de entrada. Você é o Proprietário; os colegas entram por convite no e-mail, cada um com o seu papel: Administrador ou Atendente.

O agente de IA vem no Premium, com 500 respostas de IA por mês. Mais sobre o agente

Para quem programa

Ou comande o bot pelo seu próprio código

Envie uma mensagem, liste as conversas, leia uma inteira, edite ou apague o que o bot mandou. Os webhooks avisam em message.received e button.clicked.

POST /api/v2/telegram/messages
GET  /api/v2/telegram/chats
GET  /api/v2/telegram/chats/{id}/messages
POST /api/v2/telegram/messages/{id}/edit

Dois limites, os dois do Telegram: dá para editar ou apagar uma mensagem por umas 48 horas depois do envio, e o Telegram não entrega histórico para bots — então uma conversa volta do jeito que o bot viu, não do jeito que ela aparece no seu celular.

Planos

Comece de graça e sem cobrança

Starter R$ 0 Até 50 novas conversas por mês e um fluxo. Com os três canais incluídos. Plus R$ 79/mês Conversas, fluxos, transmissões e time, sem os limites do Starter. Sem agente de IA. Premium R$ 159/mês Tudo do Plus e mais o agente de IA, com 500 respostas de IA por mês.

Ver a comparação completa O Premium começa com 1 dia grátis.

O que perguntam antes de começar

Preciso saber programar?

Não. Você abre o @BotFather no Telegram, pede um bot novo, copia o token que ele devolve e cola na sua conta. O preparo é esse.

E o WhatsApp?

Não temos e não vamos ter. Os canais são Telegram, Instagram e o chat no site — e a gente prefere dizer isso na segunda tela a deixar você descobrir depois de montar tudo.

O bot pode escrever para alguém que nunca falou comigo?

Não. O Telegram exige que a pessoa dê o /start primeiro. Em troca, depois não existe janela de 24 horas: você escreve no mês que vem, quando tiver o que contar.

Dá para conferir se a pessoa está inscrita no meu canal?

Dá, desde que o seu bot seja administrador do canal. Coloque a checagem como condição antes de entregar o arquivo, o link ou o cupom.

O agente de IA também responde no Telegram?

Responde, e é o mesmo agente dos outros canais: uma base de conhecimento só para os três. Ele vem no Premium, que inclui 500 respostas de IA por mês.

Dá para testar o fluxo antes de ativar?

Dá. A “Prévia” roda o fluxo de verdade — os mesmos blocos e as mesmas condições —, só que com você e sem enviar nada para ninguém.

O que acontece quando eu envio uma transmissão para a lista inteira?

A gente espaça o envio abaixo do teto do Telegram, que fica em torno de 30 mensagens por segundo, e no fim você vê o resultado de cada destinatário.

Como é o pagamento?

Por enquanto não tem. Enquanto o Chatonaut está em acesso antecipado, você escolhe Plus ou Premium na sua conta e o plano é ativado como bônus. Sem cobrança nenhuma.

Cole o token. O bot já está no ar.

Começar de graça Ver os planos

Sem cobrança. O Premium começa com 1 dia grátis.