El webhook history
history lleva la transferencia única de las conversaciones que un número con Coexistencia ya tenía hacia la API. Llega después de la integración, cuando se aceptó compartir el historial, y es la única señal que recibe una integración de que la transferencia ocurrió.
La ventana después de la integración en la que debe empezar la sincronización.
El error devuelto cuando la sincronización ya se usó.
El error devuelto cuando se intenta fuera de esa ventana.
Qué entrega
El historial de mensajes individuales que un número ya tenía en la app de WhatsApp Business, trasladado al otro lado para que el software no empiece a ciegas en una línea que una empresa usa desde hace años.
Lo que no viene con él son las conversaciones de grupo, que quedan por completo fuera de la API en un número con Coexistencia, y las herramientas del propio app: etiquetas, respuestas rápidas, mensajes de saludo y de ausencia no tienen equivalente en la API y se quedan en el dispositivo.
Este campo existe solo en números con Coexistencia. Un número integrado de la forma común no tiene historial previo de app que traer, así que no hay nada que pueda entregar.
Por qué se dispara una sola vez
Porque la transferencia es parte de la integración y no una capacidad continua.
Durante el Embedded Signup se le pregunta al dueño del negocio si quiere compartir las conversaciones existentes. Responder que sí es lo que permite que la sincronización corra, y no hay ninguna configuración que lo vuelva a encender después ni endpoint que lo repita. Un segundo intento devuelve 2593107, y no un límite de tasa que se pasa.
También hay un plazo. La sincronización tiene que iniciarse dentro de las 24 horas de la integración, e intentarlo más tarde devuelve 2593108. Perder cualquiera de los dos significa desconectar el número y correr el flujo entero otra vez.
Qué debe hacer un handler con esto
Tratarlo como un lote que llega una vez y puede ser grande, y no como más tráfico en la ruta de mensajes.
- Confirma rápido y procesa de forma asíncrona, como en cualquier otra entrega.
- Elimina repeticiones por el id del mensaje: el historial y los mensajes en vivo pueden solaparse cerca del momento de la integración.
- Espera que no llegue. Un número cuyo dueño rechazó el historial no envía nada aquí, y la integración tiene que funcionar de las dos maneras.
- No bloquees la integración por él. La conexión ya se puede usar antes de que la transferencia termine.
Errores comunes
- Construir una integración que exige que exista historial. Muchos números se conectan sin él.
- Reintentar la sincronización después del 2593107. Es un evento único, así que el reintento devuelve el mismo error.
- Dejar la decisión sobre el historial para cuando empiece el trabajo de integración, que suele ser después de que la ventana de 24 horas se cerró.
EasyCoexistence registra la integración y su elección de historial en la línea de tiempo de la conexión, así que si un número sincronizó, y qué día, es un hecho con fecha en vez de algo que reconstruir después.
Preguntas frecuentes
¿Cuánto historial llega?
Una ventana de conversaciones individuales recientes, definida por Meta y no por un proveedor.
¿Los chats de grupo se trasladan?
No. Los grupos quedan por completo fuera de la API en un número con Coexistencia.
¿Puedo pedirlo de nuevo más tarde?
No. Corre una vez por integración, y volver a correrlo significa desconectar y reconectar el número.
¿Y si el dueño rechazó el historial?
No llega nada en este campo, y la API ve solo los mensajes desde el momento en que el número se conectó.
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el