Canais: Telegram, WhatsApp, VK

Um bot no GetMyBot pode funcionar em vários mensageiros ao mesmo tempo — Telegram, WhatsApp e VK. Você monta o comportamento uma única vez (reações, condições, ações) e a plataforma o entrega no canal de onde veio o evento. Assim, um único construtor atende todos os canais, em vez de ser configurado separadamente para cada um.

O que é um canal

Um canal é uma superfície de entrega conectada: um bot específico do Telegram, um número do WhatsApp Business ou uma comunidade do VK. Um mesmo bot do GetMyBot pode ter vários canais. As reações são compartilhadas: quando um assinante escreve no WhatsApp, o evento é processado pelas mesmas reações que no Telegram, e a resposta volta para o WhatsApp.

Canais diferentes suportam conjuntos diferentes de capacidades do mensageiro (botões, edição, templates etc.). O construtor leva isso em conta: ações indisponíveis para um canal ou não são oferecidas, ou degradam para o equivalente mais próximo.

Canal principal (primary_channel)

Cada bot tem um canal principal (primary_channel) — a superfície com a qual o bot é associado antes de tudo. Normalmente é o Telegram, mas o bot pode ser criado desde o início como bot de WhatsApp ou de VK, sem Telegram algum. O canal principal é definido na criação e aparece na lista de bots; os demais canais são adicionados ao bot depois.

Matriz de capacidades dos canais

Abaixo, quais capacidades do mensageiro cada canal suporta. A matriz atualizada em formato legível por máquina é fornecida pela API: GET /api/channels/capabilities.

Telegram — canal de referência, com o conjunto completo de capacidades: botões inline e teclado reply, callback (clique no botão → reação), reações-emoji, deep-link /start, edição, exclusão e encaminhamento de mensagens, reply como gatilho, eventos de participantes, permissões e moderação. Formatação de texto — Plain / HTML / Markdown. Não há templates, listas, carrosséis nem janela de sessão (eles não são necessários no Telegram).

WhatsApp (via WhatsApp Cloud API) — sua própria especificidade: botões inline, callback, reações-emoji, deep-link /start, templates de mensagem, listas (interactive list) e janela de sessão de 24 horas. Formatação — Plain / Markdown. Não suporta teclado reply, edição, exclusão e encaminhamento de mensagens, reply como gatilho, eventos de participantes, permissões/moderação nem carrosséis. Mais detalhes na página WhatsApp.

VK — mensagens e anexos, botões inline e teclado reply, callback, reações-emoji, deep-link /start, edição e exclusão de mensagens, encaminhamento, eventos de participantes, banir/desbanir. Formatação — apenas texto simples (HTML/Markdown é removido na renderização). O VK não tem templates de WhatsApp, listas, carrosséis nem janela de sessão.

Comum a todos os canais: botões inline, callback, reações-emoji e deep-link /start. Carrosséis ainda não são suportados por nenhum canal.

Como conectar um canal

Os canais são adicionados na página Bots (/app/bots).

  1. Abra Bots e encontre o bot desejado.
  2. Clique em "Adicionar canal" no card do bot.
  3. Escolha a plataforma — Telegram, WhatsApp ou VK.
  4. Informe as credenciais do canal (para o Telegram — o token; para o WhatsApp — o conjunto de credenciais da Meta; para o VK — as credenciais da comunidade).
  5. Clique em "Verificar" — a plataforma valida as credenciais no lado do mensageiro.
  6. Clique em "Conectar".

Para WhatsApp e VK, após a conexão o canal ganha um endereço de webhook (ícone 🔗). Esse endereço precisa ser informado no lado da plataforma (no aplicativo Meta para o WhatsApp, nas configurações da comunidade para o VK) para que os eventos de entrada cheguem ao bot. Como fazer isso para o WhatsApp — veja WhatsApp → Configuração do webhook.

Próximos passos