Error 2593107 de WhatsApp: límite de sincronización excedido
El error 2593107 significa que este número ya usó su única sincronización de contactos e historial de conversaciones. La sincronización se ejecuta una vez por onboarding y no puede repetirse, así que la única manera de ejecutarla otra vez es desconectar el número y conectarlo de nuevo.
Código de Meta para haber excedido el límite de llamadas de la API de sincronización en un número.
Cuántas veces se pueden sincronizar contactos e historial de conversaciones por onboarding.
El código relacionado que se devuelve cuando la sincronización se intenta fuera de su ventana de 24 horas.
¿Qué sincronización es esta?
Es el paso que lleva los contactos existentes y el historial de conversaciones de un número en Coexistencia al lado de la API, para que el software no empiece a ciegas en un número que la empresa usa desde hace años.
Esto solo existe por la Coexistencia. Un número integrado de la manera habitual no tiene historial previo en la app para traer, y no hay nada que sincronizar. Un número en Coexistencia tiene las dos cosas, y Meta ofrece una transferencia única de ellas en el momento en que el número se conecta.
Por eso también el error resulta desconocido incluso para quien lleva mucho tiempo trabajando con la Cloud API. Pertenece a un modo de onboarding que esas personas nunca usaron.
¿Por qué solo puede ejecutarse una vez?
Porque forma parte del onboarding y no es una capacidad continua, y Meta la trata como una decisión única tomada en el momento de la conexión.
Durante el Embedded Signup se le pregunta al dueño del negocio si quiere compartir el historial de conversaciones existente. Responder que sí es lo que permite que la sincronización se ejecute. No hay un ajuste para volver a activarla más tarde ni un endpoint que la repita, y por eso una segunda llamada devuelve este error en lugar de un límite de tasa que se pasa.
La consecuencia práctica es que la elección pesa más de lo que parece en ese momento. Quien pasa rápido por el onboarding y rechaza el historial porque rechazar parece más seguro tomó una decisión que solo una desconexión y reconexión completas pueden revisar.
¿Y si realmente la necesitas otra vez?
El número tiene que desconectarse y conectarse de nuevo, lo que es una operación real y no un ajuste.
Reconectar ejecuta el Embedded Signup desde el principio, incluido el escaneo del código en el teléfono, y da una nueva oportunidad de aceptar el historial. La app de WhatsApp Business no se ve afectado en ningún momento, así que la empresa no pierde nada, pero tampoco es una acción silenciosa de fondo: alguien tiene que estar frente al teléfono.
Hay una consecuencia que conviene planificar. Una desconexión elimina el destino del webhook, porque ese destino vive como un override en una suscripción de app y no en el número. Reconectar restaura el envío y el monitoreo, pero no la entrega a tu propio servidor, a menos que algo la vuelva a poner.
Errores comunes
- Reintentar la llamada de sincronización. Es un evento único, así que el reintento devuelve el mismo error en vez de terminar funcionando.
- Rechazar el historial de conversaciones durante el onboarding por precaución. Esa elección solo puede revisarse reconectando el número.
- Reconectar sin planificar la restauración del destino del webhook, que se desinstala junto con la app.
EasyCoexistence vuelve a aplicar el destino de webhook de un número automáticamente después de cualquier reconexión, porque el envío y el monitoreo vuelven solos y la entrega a tu servidor no.
Preguntas frecuentes
¿Esto pasa en un número normal de la Cloud API?
No. La sincronización existe solo para números en Coexistencia, porque solo ellos tienen historial previo en la app para traer.
¿Cuánto historial se sincroniza?
Meta sincroniza una ventana de historial reciente de conversaciones en el onboarding. La cantidad exacta la define Meta, no un proveedor.
¿Reconectar va a perder mis chats en el teléfono?
No. La app de WhatsApp Business y sus conversaciones no se tocan al desconectar y reconectar el lado de la API.
¿El 2593108 es el mismo problema?
No. Ese significa que la sincronización se intentó más de 24 horas después del onboarding, no que ya se ejecutó.
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