Recaudo Docs

Eventos

Eventos de Meta

Cada evento que Recaudo le manda a Meta (píxel / Conversions API y dataset de WhatsApp) con lo que respondió Meta. Es la misma bitácora de Configuración → Meta y se guarda 90 días.

Listar eventos

GET /v1/meta-events

Del más reciente al más viejo. Filtra por estado (sent, failed, skipped), destino (pixel, whatsapp), event_name, conversation o customer.

Petición
curl "https://recaudo.app/api/v1/meta-events?status=failed" \
  -H "Authorization: Bearer sk_live_tu_secret_key"
Respuesta
{
  "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": "Sin datos para reconocer a la persona",
        "fix": "Meta necesita al menos el correo, el teléfono o el clic del anuncio. Liga el pago a un cliente o pide su correo al cobrar."
      },
      "created_at": "2026-11-11T18:20:00+00:00"
    }
  ],
  "has_more": false,
  "page": 1,
  "url": "/v1/meta-events"
}

matched_keys dice con qué datos se reconoce a la persona (sin sus valores). En los que no se aceptaron, error trae el código de Meta, su mensaje y la explicación con cómo arreglarlo.

¿Te sirvió esta página? Gracias por avisarnos.
Esc