/v1 puede devolver GatewayError, ValidationError o MetaError. Las rutas compatibles con Graph pueden devolver el cuerpo GraphError y estado originales de Meta. No uses un único parser para ambas interfaces.
Estados comunes: 401 por claves inválidas, 402 por pago, 404 por recursos inexistentes o ajenos, 409 por conflictos, 422 por validación del core, 429 por límites y 503 por gateway pausado o sin configurar. Revisa la referencia de cada operación.
Evita duplicados
unknown_outcome significa que un envío podría haberse realizado. Consulta eventos e historial antes de reintentar. Un timeout o error del servidor no demuestra que no pasó nada.
Ante 429, respeta Retry-After cuando exista. Limita reintentos y aplica esperas crecientes; no presupongas una cuota universal.
Diagnostica de forma segura
GET /v1/logs filtra por origin (api, meta, webhook) y errores (errors=1 o errors=true). El contrato describe hasta 200 entradas durante siete días; no registra cuerpos.
Ante un 500 con requestId, facilita ese ID a soporte, no claves ni mensajes de clientes.