Shopify y WhatsApp: La integración que nos tomó 6 meses hacer bien

Lo que realmente cubre la integración

Una integración adecuada de Shopify-WhatsApp no es una sola cosa. Es un conjunto de flujos de datos que deben funcionar de manera confiable en ambas direcciones. De Shopify a WhatsApp: mensajes de confirmación de pedido, actualizaciones de envío, notificaciones de entrega, confirmaciones de reembolso y activadores de carrito abandonado. De WhatsApp a Shopify: búsquedas de pedidos iniciadas por el cliente, solicitudes de devolución que necesitan crear un objeto de devolución en Shopify y consultas de productos que deben extraerse del catálogo en vivo.

Además de eso, necesitas que el catálogo de productos sea accesible dentro de la conversación de WhatsApp, para que la IA pueda responder "¿qué tallas tienes en la kurta azul?" sin que el cliente tenga que salir de WhatsApp e ir al sitio web. Esto requiere una sincronización de catálogo que se mantenga actualizada a medida que cambia el inventario.

Las trampas comunes que te ralentizan

La primera trampa es la confiabilidad de los webhooks. Shopify dispara webhooks cuando ocurren eventos de pedidos: pedido realizado, pedido enviado, pedido entregado, reembolso creado. Pero los webhooks pueden fallar. El sistema de entrega en el extremo receptor necesita manejar reintentos, deduplicación y registro de fallos. La mayoría de los desarrolladores construyen primero el camino feliz y descubren los modos de fallo seis semanas después cuando un cliente se queja de que nunca recibió su notificación de envío.

La segunda trampa son las discrepancias en el formato del número de pedido. Los ID de pedidos de Shopify son numéricos. Tu marca puede mostrar a los clientes un número de pedido formateado como #RL-2847. El sistema necesita manejar búsquedas por ambos formatos, porque los clientes usarán el que tengan delante.

La tercera trampa es el retraso en la aprobación de plantillas de WhatsApp. Cada mensaje saliente de WhatsApp que no sea una respuesta directa a un mensaje del cliente requiere una plantilla pre-aprobada. El proceso de aprobación de Meta toma de 24 a 72 horas, y los rechazos son comunes en la primera presentación. Este es un problema de planificación: necesitas enviar las plantillas con anticipación, no la semana antes del lanzamiento.

Usamos un conector de terceros durante los primeros tres meses. Cada vez que Shopify actualizaba su API, algo se rompía. Migramos a una integración nativa y la carga de mantenimiento cayó a casi cero.

Por qué importa la integración nativa frente a los conectores de terceros

Los conectores de terceros para la integración Shopify-WhatsApp son abundantes y frecuentemente económicos. Funcionan bien para casos de uso simples: enviar mensajes de confirmación de pedido y notificaciones de envío. Pero fallan para cualquier cosa más compleja.

El problema específico con los conectores es que no exponen el modelo de datos completo de Shopify a la capa de IA. Un conector puede enviar una notificación de envío. No puede responder "¿cuál es el período de devolución del producto que pedí el mes pasado?" porque no tiene los datos contextuales del producto unidos a los datos del pedido unidos a los datos del cliente.

La integración nativa significa que tu IA tiene acceso en vivo al objeto de pedido completo, el objeto de cliente, el objeto de producto y el objeto de cumplimiento. Ese contexto es lo que permite conversaciones genuinamente útiles, no solo despacho de notificaciones.

Cómo funciona la sincronización del catálogo (y qué sale mal)

WhatsApp Commerce te permite subir un catálogo de productos accesible dentro de las conversaciones. El catálogo se sincroniza a través de la API de Meta Commerce. Cada producto necesita un título, descripción, precio, URL de imagen e ID de contenido único que se mapee de vuelta a tu SKU de Shopify.

La sincronización debe ejecutarse en un horario que mantenga el ritmo con los cambios de inventario. Para la mayoría de las marcas D2C, una sincronización cada dos a cuatro horas es suficiente. Para marcas que realizan ventas flash o lanzamientos limitados, la sincronización casi en tiempo real es crítica. Nada daña la confianza más rápidamente que un bot de WhatsApp que ofrece un producto que lleva tres horas agotado.

El fallo de sincronización de catálogo más común es la corrupción de URL de imágenes. Las imágenes de productos en Shopify tienen URLs de CDN. Cuando cambias una imagen de producto en Shopify, la URL antigua se rompe. Si la sincronización del catálogo no recoge la nueva URL, el catálogo de WhatsApp muestra imágenes rotas. La solución es obtener imágenes del objeto de producto de Shopify en el momento de sincronización en lugar de almacenar URLs estáticamente.

Qué haríamos diferente si empezáramos de nuevo

Construiríamos el manejo de fallos antes del camino feliz. Cada endpoint de webhook, cada llamada a la API, cada trabajo de sincronización de catálogo debe tener registro y alertas antes de pasar a producción. Descubrir un fallo de sincronización tres días después por una queja de un cliente es un problema solucionable, pero es mucho más estresante que detectarlo en tu panel de monitoreo cinco minutos después de que ocurra.

También enviaríamos todas las plantillas de WhatsApp en la primera semana del proyecto, no en la última semana. El cronograma de aprobación no está en tu control. Todo lo demás puede esperar. Las plantillas no pueden.