Verificar conexión Meta
Prueba las credenciales de la conexión contra Meta haciendo un login real (y su logout, a cargo del pipeline). No sincroniza ni devuelve datos: solo confirma si las credenciales sirven.
API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.
In: header
Header Parameters
Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.
^conn_Request Body
application/json
La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/tools/meta_ads.conexion.verificar/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": {} }'{ "data": { "verificadoEn": "string" }, "meta": { "request_id": "string", "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f", "tool_id": "string", "plane": "action", "latency_ms": 0, "audit_status": "recorded", "idempotency": "replayed" }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}Sincronizar conexión Meta Ads POST
Sincroniza el gasto y la entrega DIARIOS de la cuenta publicitaria de Meta de esta conexión, al total de la cuenta y por campaña, y los guarda para consultarlos con 'meta_ads.gasto_cuenta.consultar' y 'meta_ads.gasto_campanas.consultar'. Es el ÚNICO camino que trae datos de Meta. Relee los últimos 28 días (Meta corrige cifras recientes) y completa hacia atrás ~13 meses por tramos; con mucha historia, varias sincronizaciones seguidas la completan y el resultado lo dice en 'detalle'. Sólo lee: nunca crea, edita ni pausa anuncios, ni lee facturas o cobros de Meta. Un 'upstream_error' o un 'partial' por límite de consultas es transitorio y no invalida la autorización.
Consultar gasto diario por campaña en Meta POST
Lee el gasto y la entrega DIARIOS por campaña de la cuenta publicitaria de Meta de esta conexión, YA sincronizados. Sirve para atribuir gasto por campaña; para el total de la cuenta usa 'meta_ads.gasto_cuenta.consultar' y no sumes las dos, ni supongas que la suma de campañas cuadra con la cuenta (Meta puede no informar campañas eliminadas). Lectura pura: NO contacta a Meta ni dispara una sincronización. Revisa 'cobertura' antes de concluir que no hubo gasto. Las cifras son las que Meta informa en Insights: el gasto es estimado y NO equivale a facturas, cobros ni impuestos. No mezcles monedas. Para traer datos nuevos usa 'meta_ads.conexion.sincronizar'. Pagina con 'cursor'.