what-syncs-and-what-does-not | Qué se sincroniza con la API, y qué no

Qué cruza

Dos cosas, y son las dos que importan para un software que arranca en un número que un negocio lleva años usando.

• Contactos: cada contacto con un número de WhatsApp puede sincronizarse hacia la plataforma.
• Historial de mensajes individuales, para que la API no quede ciega ante las conversaciones que ocurrieron antes de que existiera.
• De ahí en adelante, los mensajes se reflejan en ambas direcciones: lo que la API envía aparece en la app, y lo que el equipo escribe en la app llega a tus sistemas.

Qué no cruza

Más cosas de las que la gente espera, y esta es la lista que vale leer antes de prometerle nada a un cliente. Nada de esto es una limitación de proveedor; es como funciona la plataforma.

• Los chats de grupo, que no se sincronizan y no son alcanzables por la API en ningún proveedor.
• Herramientas de negocio: el catálogo, los pedidos y los estados.
• Herramientas de mensajería: mensaje de saludo, mensaje de ausencia, respuestas rápidas y etiquetas.
• Los canales, las llamadas de voz y video, y los detalles del perfil comercial.

Por qué las herramientas propias de la app se quedan atrás

Porque son funciones de la app y no de la plataforma, y la API no tiene equivalente de ellas.

Las respuestas rápidas y las etiquetas viven en el dispositivo. Un mensaje de ausencia es algo que la app envía cuando nadie la está mirando. Nada de esto existe como concepto de API, así que no hay hacia dónde sincronizarlo.

La consecuencia práctica es que un negocio que depende de las etiquetas para organizar su trabajo sigue usándolas en la app, y el software no tiene ninguna visibilidad de ellas. Si esa organización importa para lo que estás construyendo, hay que reconstruirla de tu lado en lugar de leerla desde allá.

La ventana que se puede perder

La sincronización tiene que iniciarse dentro de las 24 horas del onboarding. Si la pierdes, el número tiene que pasar por offboarding y onboarding otra vez para tener una segunda oportunidad.

Esto es distinto de la ventana de atención de 24 horas que gobierna el envío, y las dos se confunden todo el tiempo. Una cuenta desde el último mensaje del cliente y decide si el texto libre se entrega. Esta cuenta desde el onboarding y decide si el historial todavía puede traerse.

Es también por eso que conviene decidir lo del historial el día en que un número se conecta, y no cuando empieza el trabajo de integración, que suele ser otra semana.

Errores comunes

• Prometerle a un cliente que sus etiquetas y respuestas rápidas van a aparecer en tu sistema. Se quedan en la app.
• Construir cualquier cosa alrededor de los chats de grupo. No se sincronizan en ningún proveedor.
• Dejar la sincronización de historial para cuando la integración esté construida. La ventana es de 24 horas desde el onboarding.

Preguntas frecuentes

Sigue leyendo