API - Coexistencia
La API de coexistencia permite sincronizar contactos e historial de mensajes de su cuenta de WhatsApp Business a Positus de forma programática. Esta es una referencia rápida de los endpoints de sincronización.Base de la API:
https://api.positus.global/v2Autenticación: todas las solicitudes deben incluir el encabezado Authorization: Bearer <su-token>, donde <su-token> es el token de autenticación de su espacio de trabajo.Endpoints de sincronización
Sincronizar contactos
POST https://api.positus.global/v2/whatsapp/numbers/{NUMBER_ID}/onboarding-smb-app/sync-contacts
Solicita la sincronización de los contactos guardados en la aplicación WhatsApp Business a su cuenta Positus.
Parámetros
Encabezados
Cuerpo de la solicitud
No se requiere cuerpo (body) para esta solicitud.Comportamiento
La sincronización es asincrónica: la llamada solo solicita el inicio del proceso. 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.
Respuesta
Después de una llamada exitosa, el servidor responde con estado200 OK e inicia el proceso asincrónico. No hay cuerpo de respuesta específico — monitoree la aparición de los contactos en su cuenta.
Sincronizar historial de mensajes
POST https://api.positus.global/v2/whatsapp/numbers/{NUMBER_ID}/onboarding-smb-app/sync-message-history
Solicita la sincronización del historial de mensajes de su cuenta de WhatsApp Business a Positus.
Parámetros
Encabezados
Cuerpo de la solicitud
No se requiere cuerpo (body) para esta solicitud.Comportamiento
La sincronización es asincrónica: la llamada solo solicita el inicio del proceso. 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.
Recepción de mensajes
Los mensajes sincronizados llegan a su webhook configurado en el formato
{ contacts, messages }. Cada mensaje incluye los metadatos completos: remitente, destinatario, tipo de contenido y timestamp.messages que contiene todos los mensajes importados.
Contexto de uso
En el onboarding a través de Embedded Signup, Positus dispara estas sincronizaciones automáticamente. Estos endpoints existen para casos en que sea necesario solicitar manualmente la sincronización después del onboarding inicial.
- Sincronización de contactos — detalles sobre el proceso de importación de contactos
- Sincronización de historial — detalles sobre el proceso de importación de mensajes
- Introducción a la coexistencia — conceptos y limitaciones de la coexistencia
- Onboarding — cómo activar la coexistencia