agent.draft.created

EVENTOagent.draft.createddesde A1envelope v1

Rascunho de agente criado.

Quando é emitido

Um agente em modo aprovacao quis executar uma escrita (enviar, etiquetar, mudar grupo); ela espera aprovação em POST /agents/drafts/{draft_id}/approve por até 24 horas.

Campos de data

Campo	Tipo	Descrição
draft_id	string	Id do rascunho (o conteúdo fica em GET /agents/drafts).
agent_id	string	Agente.
tool	string	Ferramenta (send_message, label_chat...).
chat	string	Destinatário ou chat.
status	string	pending.

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

Corpo do POST

{
  "id": "evt_3e5a7c9b1d2f4068",
  "type": "agent.draft.created",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-20T14:02:10.500Z",
  "data": {
    "draft_id": "adr_5b1d3f9a7c2e4086",
    "agent_id": "agn_3c9e1a7f5d2b4086",
    "tool": "send_message",
    "chat": "[email protected]",
    "status": "pending"
  }
}

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": ["agent.draft.created"] no webhook, ou?types=agent.draft.created no SSE.

Relacionados: agent.draft.decided · agent.run.completed

Equivalente na Z-API: (sem equivalente).