Processamento assíncrono

Envie o header abaixo para optar pelo processamento assíncrono:

Prefer: respond-async

A Vensy grava a intenção de envio e o evento de outbox antes de responder. O relayer entrega a mensagem com retry e backoff.

Uma aceitação assíncrona usa 202:

{
  "messageId": null,
  "providerMessageId": null,
  "outreachId": "cm_outreach_123",
  "firingChannelId": "cm_channel_123",
  "conversationId": null,
  "status": "queued",
  "createdAt": "2026-08-27T18:30:00.000Z",
  "idempotencyReplayed": false,
  "apiKeyId": "cm_key_123"
}

providerMessageId ainda não existe nesse momento. Se você precisa correlacionar o status por esse identificador, consulte o registro de envios no app após o relayer processar a fila.

Use o modo síncrono quando a integração precisa do ID do provedor na resposta imediata; use o assíncrono para maior vazão e menor acoplamento à latência externa.