Skip to main content

​
Sincronización de historial

Al activar la coexistencia, puede importar el historial de mensajes de su número de WhatsApp Business a Positus. La importación es asincrónica y los mensajes llegan a su webhook en el mismo formato que los mensajes recibidos normalmente.

​
Cómo disparar la sincronización

Realice una solicitud POST al endpoint a continuación. No se requiere cuerpo (body).
Parámetros:
  • {NUMBER_ID} — ID del número de WhatsApp ya activado con coexistencia.
La importación puede ser disparada una sola vez por onboarding, dentro de la ventana de 24 horas después de la activación de la coexistencia. El servidor solo confirma la recepción de la solicitud; los mensajes se entregan después, a lo largo de varios webhooks.

​
Lo que recibirá

Cada mensaje del historial se entrega a su webhook en el mismo formato que un mensaje recibido en Positus — el sobre { "contacts": [...], "messages": [...] }. Recibe un webhook por mensaje del historial; su manejador de webhook existente ya procesa estos mensajes sin cambios.
Este es el mismo formato descrito en Webhook. La diferencia es que los mensajes del historial traen el campo adicional history_context, indicando el estado que el mensaje tenía en la aplicación. Los metadatos internos del progreso de la importación (fase, orden del lote) no se pasan a su webhook.

​
Campos del mensaje

​
Valores de history_context.status

​
Ventana de cobertura del historial

Meta proporciona el historial en tres fases, definiendo cuánto tiempo atrás se importan los mensajes: Los mensajes con más de 180 días no se importan. No necesita tratar estas fases: solo determinan el alcance de la importación — los mensajes llegan a su webhook uno a uno, como se describe arriba.

​
Medios en dos etapas

Los mensajes de medios más antiguos (con más de ~14 días) llegan en dos etapas:
  1. Primero, un mensaje con type: "media_placeholder" — sin el contenido del medio.
  2. Después, un nuevo webhook entrega el mismo mensaje con el contenido real del medio.
Espere la segunda etapa antes de considerar el medio completo. El media_placeholder indica que el medio existe, pero aún no ha sido entregado.

​
Historial rechazado por la empresa

Si el compartir historial está desactivado en la aplicación WhatsApp Business, Meta rechaza la importación (error 2593109 — “History sync is turned off by the business”).
Cuando el historial es rechazado, la importación no procede y ningún mensaje se entrega. El usuario necesita habilitar el compartir historial en la aplicación WhatsApp Business y rehacer el onboarding.

​
Próximos pasos