Conectar Telegram

Conecte um bot do Telegram com o token do BotFather

Canal do tipo BOT_TELEGRAM. É o fluxo mais simples dos cinco: não tem OAuth, não tem Meta, não tem aprovação.

​

Requisitos

• Um bot criado no @BotFather do Telegram
• O token que o BotFather devolve na criação

​

Criando o bot

1. Fale com o BotFather

   Abra @BotFather no Telegram e envie /newbot.

2. Escolha nome e usuário

   O usuário precisa terminar em bot — por exemplo minhaloja_bot.

3. Guarde o token

   O BotFather devolve algo como 123456789:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. É esse o token.

O token dá controle total do bot. Trate como senha — não versione e não exponha no frontend.

​

Conectando

const client = OmniZapi.newClient({ publicKey: 'SUA_PUBLIC_KEY' });
const response = await client.connect({ channelId: 'ID_DO_CANAL' });
// response: { success, channelId, botToken }

O SDK abre uma janela onde o usuário cola o token do bot. Diferente dos canais Meta, o retorno traz botToken em vez de code — não há OAuth envolvido.

Repasse o objeto inteiro para finalizar a conexão.

​

O que muda no Telegram

O Telegram é o canal menos restrito dos cinco:

Detalhe	Valor
Identificador do contato	usuário do bot (@meu_bot)
Janela de conversa	não existe — envie a qualquer momento
Templates	não precisa, e não existem
Enquete	suportada (só Telegram e WhatsApp Web têm)
Localização e contato	suportados

Sem janela de 24 horas, você inicia conversa quando quiser — desde que o usuário tenha iniciado o bot pelo menos uma vez. Essa é a regra do Telegram: o bot não fala com quem nunca deu /start.