Disparar sincronización
POST/v1/:phone_number_id/smb_app_data
Dispara la sincronización del historial de conversaciones o de la lista de contactos de la aplicación WhatsApp Business hacia la Cloud API.
Cada tipo (history y smb_app_state_sync) puede dispararse una sola vez por
integración, y solo dentro de las 24 horas posteriores al Embedded Signup.
Si te equivocas o pierdes el plazo, el cliente debe rehacer el onboarding
completo.
La respuesta es inmediata y solo confirma la programación. Los datos llegan después, en múltiples webhooks asíncronos — lee la descripción de la sección Espejo · Sincronización para saber cómo montar las conversaciones a partir de ellos.
Request
Responses
- 200
- 401
- 403
- 429
- 502
Respuesta de la Meta Cloud API, reenviada sin cambios. El formato depende del endpoint — consulta la documentación de Meta.
Response Headers
Categoría de límite aplicada — send, media o default.
Qué cubo describen las otras cabeceras — key (la API key), session (el panel) o account (el techo de la cuenta).
Techo de peticiones de la categoría en la ventana actual.
Peticiones restantes en la ventana actual.
Token ausente, mal formado, desconocido o revocado (authentication), o cuenta
suspendida (tenant_inactive).
El recurso no pertenece a tu cuenta (forbidden), o la ruta está en la lista de
bloqueo del espejo (forbidden_endpoint), o tu API key está restringida a algunos
números y la operación es de toda la cuenta (forbidden).
Límite de peticiones superado (rate_limit).
Response Headers
Segundos a esperar antes de reintentar.
Categoría de límite aplicada — send, media o default.
Qué cubo describen las otras cabeceras — key (la API key), session (el panel) o account (el techo de la cuenta).
Techo de peticiones de la categoría en la ventana actual.
Peticiones restantes en la ventana actual.
No se pudo alcanzar a Meta (upstream_error), Meta respondió con un 5xx
(meta_error) o tardó más de 30 segundos.