message.sent

EVENTOmessage.sentdesde M3envelope v1

Mensagem enviada.

Quando é emitido

Emitido quando um envio pela API é confirmado pelo WhatsApp (source: "api", id = id do item da fila) ou quando alguém envia uma mensagem pelo celular do número conectado (source: "device"). Útil para detectar que um humano respondeu pelo celular.

Campos de data

Campo	Tipo	Descrição
id	string	Id LiteZap (em envios pela API, o id devolvido por POST /messages).
wa_message_id	string	Id no WhatsApp.
chat	string	JID do chat.
from_me	boolean	Sempre true.
source	string	api ou device.
type	string	Tipo da mensagem.
text	string	Texto ou legenda.
timestamp	string	Hora do envio.

O envelope (id, type, version, instance_id, timestamp,data) está em Visão geral. Campos novos podem ser adicionados emdata sem mudar a versão: ignore os que não conhecer.

Exemplos

Enviada pela API

{
  "id": "evt_8c4f1a7d3b0e6259",
  "type": "message.sent",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-17T13:50:03.090Z",
  "data": {
    "id": "msg_a41c9e07d2b35f68",
    "wa_message_id": "3EB0A1B2C3D4E5F6A7B8C9",
    "chat": "5511999999999@s.whatsapp.net",
    "from_me": true,
    "source": "api",
    "type": "text",
    "text": "Seu pedido saiu para entrega!",
    "timestamp": "2026-10-17T13:50:03Z"
  }
}

Enviada pelo celular

{
  "id": "evt_4b0e7c3a9f2d6158",
  "type": "message.sent",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-17T13:55:41.330Z",
  "data": {
    "id": "msg_2e7a4c9f1b6d3085",
    "wa_message_id": "3AF1C8E2B5D9A4F7C0E1",
    "chat": "5511999999999@s.whatsapp.net",
    "from_me": true,
    "source": "device",
    "type": "text",
    "text": "Já está a caminho!",
    "timestamp": "2026-10-17T13:55:41Z"
  }
}

Entrega e ordem

• Por webhook: pelo menos uma vez, com retry por até 24 horas. O mesmo evento pode chegar duas vezes: deduplique porX-LiteZap-Event-Id. Veja Entrega e retentativas.
• A ordem entre eventos não é garantida (retentativas reordenam): use timestamp.
• Por SSE: ao vivo, sem replay. Veja Tempo real com SSE.
• Para assinar só este tipo: "events": ["message.sent"] no webhook, ou?types=message.sent no SSE.

Relacionados: message.status · message.received

Equivalente na Z-API: Ao enviar / Notificar enviadas por mim.