Recaudo Docs
Criar conta

Eventos

Eventos da Meta

Cada evento que a Recaudo envia à Meta (pixel / API de Conversões e conjunto de dados do WhatsApp) com o que a Meta respondeu. É o mesmo registro de Configurações → Meta e fica guardado por 90 dias.

Listar eventos

GET /v1/meta-events

Do mais recente ao mais antigo. Filtre por status (sent, failed, skipped), destino (pixel, whatsapp), event_name, conversation ou customer.

Requisição 
curl "https://recaudo.app/api/v1/meta-events?status=failed" \
  -H "Authorization: Bearer sk_live_tu_secret_key"
Resposta 
{
  "object": "list",
  "data": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "object": "meta_event",
      "event_name": "Purchase",
      "destination": "pixel",
      "status": "failed",
      "trigger": "payment",
      "conversation_id": null,
      "customer_id": "98765432-10fe-dcba-9876-543210fedcba",
      "value": 1500.0,
      "currency": "MXN",
      "matched_keys": ["fn", "ln"],
      "error": {
        "code": "100/2804050",
        "message": "…",
        "explanation": "Sem dados para reconhecer a pessoa",
        "fix": "A Meta precisa pelo menos do e-mail, do telefone ou do clique do anúncio. Ligue o pagamento a um cliente ou peça o e-mail na cobrança."
      },
      "created_at": "2026-11-11T18:20:00+00:00"
    }
  ],
  "has_more": false,
  "page": 1,
  "url": "/v1/meta-events"
}

matched_keys indica com quais dados a pessoa é reconhecida (sem os valores). Nos que não foram aceitos, error traz o código da Meta, a mensagem e a explicação de como corrigir.

Esta página ajudou? Obrigado por avisar.
Esc