Enviar mensajes de pedidos de WhatsApp desde Shopify

¿Cómo envía Shopify Flow un mensaje de WhatsApp?

Con la acción Send HTTP request, que hace una petición POST a cualquier URL con encabezados y un cuerpo que puede usar variables Liquid del disparador.

Crea un workflow con el disparador de creación de pedido y añade Send HTTP request. La URL es el endpoint de mensajes de la Cloud API para el phone number id del número conectado. Añade un encabezado Authorization cuyo valor sea Bearer seguido del token de acceso del número, guardado como secreto de Flow y referenciado como variable secreta. Los valores secretos nunca se muestran en la interfaz de Flow y se ocultan en los registros de ejecución, que es donde debe estar un token. El cuerpo es un mensaje de plantilla, con el teléfono del cliente en el campo to y los datos del pedido como parámetros de la plantilla.

Flow considera éxito una respuesta 2XX o 3XX. Meta responde a una petición válida con el id del mensaje, así que una ejecución exitosa significa que Meta aceptó el mensaje.

{
  "messaging_product": "whatsapp",
  "to": "<customer phone, digits only>",
  "type": "template",
  "template": {
    "name": "order_confirmation",
    "language": { "code": "en" },
    "components": [{
      "type": "body",
      "parameters": [{ "type": "text", "text": "{{order.name}}" }]
    }]
  }
}

¿Por qué un mensaje de pedido tiene que ser una plantilla?

Porque quien escribe primero es la tienda. La ventana de atención de 24 horas de Meta solo se abre cuando el cliente escribe al número. Una confirmación de pedido, un aviso de envío o un recordatorio de carrito abandonado se envían antes de eso, así que el texto libre se rechaza y solo pasa una plantilla aprobada de antemano.

Crea la plantilla una sola vez, en la categoría de utilidad para avisos de pedidos y envíos, y espera a que se apruebe antes de activar el workflow. El nombre y el idioma del cuerpo de la petición deben coincidir exactamente con la plantilla aprobada, y el número de parámetros debe coincidir con sus marcadores.

También está el consentimiento. Meta exige opt-in antes de que una empresa escriba a alguien por WhatsApp: la persona dio su número y aceptó recibir mensajes de ese negocio. Una casilla en el checkout que lo diga es la forma habitual de obtenerlo, y el workflow debe comprobarla antes de enviar.

¿Y si el plan de la tienda no incluye Send HTTP request?

Usa un webhook de administración de Shopify. En Configuración, Notificaciones, Webhooks, el comerciante puede crear un webhook para un evento como la creación de un pedido, en JSON, hacia una URL. Apúntalo a un receptor: un nodo Webhook de n8n, o una ruta en PHP, Python o Node. El receptor lee el pedido, comprueba el consentimiento y hace la misma llamada de plantilla a la Cloud API.

Por cualquiera de las dos vías, las respuestas funcionan igual. Cuando el cliente contesta el mensaje del pedido, la respuesta llega a la app de WhatsApp Business en el teléfono de la tienda, porque el número está en Coexistencia, y la ventana de 24 horas queda abierta para texto libre. Si el número tiene configurado un destino de webhook, la respuesta también llega a tu sistema. El mensaje del pedido también aparece en la app, así que quien responde ve a qué está contestando el cliente.

Errores comunes

• Enviar texto libre al crear el pedido. El cliente no ha escrito, así que Meta lo rechaza; tiene que ser una plantilla aprobada.
• Dejar el manejo de errores en Reintentar para respuestas 4XX. Flow puede reintentar durante hasta 24 horas una petición que Meta nunca aceptará.
• Poner el token como texto plano en un encabezado. Guárdalo como secreto de Flow para que quede fuera de la interfaz y de los registros.

Preguntas frecuentes

Sigue leyendo