Skip to main content
Quando você cadastra uma URL de webhook, o Notifique avisa o seu sistema sobre o que aconteceu. O formato do aviso (JSON, assinatura, horário) é o mesmo padrão explicado em Eventos dos Webhooks. A diferença principal: no Telegram o nome do evento começa com telegram..
No WhatsApp, os nomes começam com message. — não misture: marque os dois no painel se usar os dois canais.

​
Eventos que você pode marcar

​
Instância em modo USER (login por QR ou sessão)

EventoEm poucas palavras
telegram.instance.connectingComeçou a abrir a conexão MTProto para gerar o QR / login.
telegram.instance.qrcodeNovo QR ou link tg://login?token=... (pode incluir base64 com imagem PNG).
telegram.instance.connectedSessão USER salva; instância ficou ACTIVE (pode enviar).
telegram.instance.login_errorFalha no login (timeout, cancelado, 2FA, etc.) — veja data.code e data.message.
O formato do JSON (campos workspaceId, instanceId, data, …) é o mesmo padrão dos webhooks do WhatsApp; só o nome do evento muda.

​
Mensagens (envio e bot)

EventoEm poucas palavras
telegram.sentSua mensagem foi aceita pelo Telegram (saiu do nosso lado com sucesso).
telegram.failedDepois das tentativas, não deu para entregar (bloqueio, chat inválido, etc.).
telegram.receivedAlguém mandou mensagem para o seu bot (entrada guardada no histórico).
telegram.cancelledVocê cancelou um envio que ainda estava na fila ou agendado.
telegram.editedO texto de uma mensagem foi alterado pela API.
telegram.deletedA mensagem foi apagada no chat pela API.

​
Exemplo de aviso — envio ok

{
  "event": "telegram.sent",
  "workspaceId": "clxxworkspace",
  "instanceId": "clxxinstance",
  "messageId": "clxxmessage",
  "timestamp": "2026-04-11T12:00:00.000Z",
  "data": {
    "to": "123456789",
    "type": "TEXT",
    "status": "SENT",
    "sentAt": "2026-04-11T12:00:00.000Z",
    "externalId": "42"
  }
}

​
Exemplo — alguém escreveu no bot

{
  "event": "telegram.received",
  "workspaceId": "clxxworkspace",
  "instanceId": "clxxinstance",
  "timestamp": "2026-04-11T12:01:00.000Z",
  "data": {
    "inboundId": "clxxinbound",
    "preview": "Oi, preciso de ajuda",
    "chatId": "123456789",
    "fromUsername": "cliente"
  }
}
(Neste caso não há messageId de envio — é um registro de entrada.)

​
Referências