Telegram

• o chat ID da pessoa, se você já o conhece;
• o identificador dela no seu sistema (user_id) ou o telefone, depois que ela se vincula pelo bot (seção 3, abaixo).

​

1. Criar o bot

​

2. Conectar o bot na plataforma

• Testar — confere o token e registra o webhook de novo. Use quando o bot parar de responder (o estado mostra Precisa testar).
• Tornar padrão — define o bot dos disparos.
• Editar boas-vindas — troca a mensagem enviada quando a pessoa confirma o telefone.
• Remover — o bot para de receber mensagens e quem estava inscrito nele deixa de receber disparos. As conversas continuam salvas.

​

Já usava o Telegram antes?

​

3. Vincular as pessoas ao bot

<a href="https://t.me/SEU_BOT?start=ID_DO_USUARIO">Ativar notificações pelo Telegram</a>

1. O bot guarda o vínculo entre o ID_DO_USUARIO e o chat dela.
2. O bot pede o telefone, com o botão Compartilhar meu número.
3. Quando ela compartilha, o bot guarda o vínculo entre o telefone e o chat e responde com a Mensagem de boas-vindas.

​

4. Atender na inbox Conversas

1. A pessoa abre o bot (https://t.me/SEU_BOT) e envia /start.
2. O bot pede o telefone, com o botão Compartilhar meu número. Antes disso, nada é gravado em Conversas.
3. Ao compartilhar, a plataforma cria ou encontra o contato em Contatos pelo telefone, o bot envia a mensagem de boas-vindas e a conversa passa a aparecer.

​

Responder com o chatbot

1. Abra o bot em Chatbot e vá ao campo Canais atendidos.
2. Marque o bot do Telegram que ele deve atender e salve.

​

5. Grupos do Telegram

• Conversa — histórico em tempo real. Você envia texto e mídia da biblioteca pelo bot. Mídia recebida até 20 MB aparece na conversa (limite do Telegram para bots).
• Participantes — total de membros, administradores e quem já falou no grupo. O Telegram não mostra ao bot a lista completa de membros.

​

6. Criar o template

• Mensagem — o texto que chega ao usuário, com variáveis {{var}}.
• Formatação — modo Nenhum (texto puro), HTML (<b>, <i>, <code>, <a href>) ou MarkdownV2, e a opção de desativar a prévia de links.
• Mídia (opcional) — Foto, Vídeo, Documento, Áudio ou Animação (GIF), por URL. A mensagem vira a legenda, e a URL aceita variáveis.
• Botões inline (opcional) — organizados em linhas. Cada botão tem texto e URL ou callback_data — não os dois.

​

7. Enviar

curl -X POST https://api.octasend.com.br/functions/v1/send-message \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "communication_slug": "pedido-confirmado",
    "recipient": { "user_id": "ID_DO_USUARIO" },
    "channels": ["telegram"]
  }'

curl -X POST https://api.octasend.com.br/functions/v1/send-message \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "communication_slug": "pedido-confirmado",
    "recipient": { "phone": "+5511999998888" },
    "channels": ["telegram"]
  }'

curl -X POST https://api.octasend.com.br/functions/v1/send-message \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "communication_slug": "pedido-confirmado",
    "recipient": { "telegram_chat_id": "123456789" },
    "channels": ["telegram"]
  }'

• A escolha do bot é automática: primeiro o bot padrão em que a pessoa confirmou o telefone; se não, o bot mais recente em que ela se inscreveu.
• Telefone que ninguém compartilhou com o bot falha com “Nenhum usuário Telegram encontrado com o telefone … O usuário precisa iniciar o bot e compartilhar o número primeiro.”
• user_id sem vínculo falha com “No Telegram chat_id found — provide recipient.phone, recipient.user_id (registered via bot) or recipient.telegram_chat_id”.
• Sem nenhum desses campos, o Telegram é pulado nessa chamada; se você pediu o canal explicitamente em channels, o resultado vem como skipped.
• Campanhas encontram a pessoa pelo telefone do contato: só recebem os contatos que compartilharam esse número com o bot.

​

Checklist

• Bot adicionado em Canais → Telegram (token salvo e bot Ativo).
• Link do bot no seu site, e a pessoa abriu o bot e compartilhou o número (ou você tem o chat ID dela).
• Comunicação com template Telegram criado e mensagem preenchida.
• send-message retorna status sent e a mensagem chega no Telegram.
• Para atender em Conversas: a pessoa confirmou o telefone no bot.
• Para grupos: bot adicionado ao grupo e, se faltarem mensagens, privacidade do bot desativada no BotFather.