Skip to main content
O Telegram no Notifique reutiliza a infraestrutura de webhooks do workspace: POST para sua URL, corpo JSON, assinatura HMAC (mesma regra geral dos outros canais). A estrutura base (event, workspaceId, instanceId, messageId, timestamp, data) é a descrita em Eventos dos Webhooks — WhatsApp (os exemplos lá são WhatsApp, mas o formato do envelope é o mesmo).

​
Como identificar Telegram

Nos eventos disparados pelo processamento outbound do Telegram, o objeto data inclui o campo: 
"channel": "telegram"
Assim você pode rotear no seu backend sem confundir com WhatsApp (onde o campo pode estar ausente ou diferente). Exemplo ilustrativo — message.sent 
{
  "event": "message.sent",
  "workspaceId": "clxxworkspace",
  "instanceId": "clxxinstance",
  "messageId": "clxxmessage",
  "timestamp": "2026-04-10T14:05:00.000Z",
  "data": {
    "to": "123456789",
    "type": "TEXT",
    "status": "SENT",
    "sentAt": "2026-04-10T14:05:00.000Z",
    "externalId": "42",
    "channel": "telegram"
  }
}
Exemplo — message.failed 
{
  "event": "message.failed",
  "workspaceId": "clxxworkspace",
  "instanceId": "clxxinstance",
  "messageId": "clxxmessage",
  "timestamp": "2026-04-10T14:06:00.000Z",
  "data": {
    "to": "123456789",
    "status": "FAILED",
    "reason": "Forbidden: bot was blocked by the user",
    "channel": "telegram"
  }
}

​
Cobertura de eventos

O worker do Telegram emite, entre outros, message.sent e message.failed. Eventos finos de entrega/leitura do tipo WhatsApp (message.delivered, message.read) podem não se aplicar da mesma forma ao Telegram — configure apenas os eventos que seu painel oferece e trate channel quando presente. Inbound (mensagens recebidas pelo bot) pode integrar com automações internas; a consulta detalhada no dashboard usa rotas autenticadas por sessão, não a API pública v1 documentada no OpenAPI de Telegram.

​
Referências