Saltar al contenido principal

WhatsApp & SMS Notifications

Envía notificaciones por WhatsApp o SMS para eventos de pedido, carritos abandonados y más.


Descripción general

Flujo:

  1. El admin configura las gateway URLs en Settings.
  2. El admin crea plantillas de notificación en Products → Notifications (o similar).
  3. Cuando se disparan los triggers (p. ej. pedido realizado, factura pagada, carrito abandonado), el módulo envía una petición al gateway.
  4. El gateway entrega el mensaje por WhatsApp o SMS.

Configuración

Gateway URLs

  1. Ve a Setup → Settings → Products.
  2. En WhatsApp / SMS Notifications:
    • Activa la función.
    • Introduce SMS Gateway URL - Endpoint webhook/API de tu proveedor de SMS.
    • Introduce WhatsApp Gateway URL - Endpoint webhook/API de tu proveedor de WhatsApp.
  3. Guarda.

Anulación por plantilla

Cada plantilla de notificación puede usar el gateway global o una URL de webhook personalizada.


Crear una plantilla de notificación

  1. Ve a Products → Notifications (o Product Notifications).
  2. Haz clic en New Notification.
  3. Configura:
FieldDescription
NameNombre interno
ChannelWhatsApp o SMS
Triggerabandoned_cart, order_placed, order_paid
Recipientclient o staff
Message templateTexto con campos merge
Webhook URLAnular global (opcional)
Webhook methodPOST o GET
Webhook bodyPlantilla JSON para la API
  1. Guarda.

Campos merge

Usa estos marcadores en la plantilla del mensaje:

FieldDescription
{companyname}Nombre de tu empresa
{cart_link}Enlace al checkout
{cart_total}Total del carrito (carrito abandonado)
{client_name}Nombre del cliente
{contact_phonenumber}Número de teléfono
{order_id}Order ID
{order_date}Fecha del pedido
{total}Total del pedido
{invoice_number}Número de factura
{invoice_link}Enlace a la factura

Eventos trigger

  • abandoned_cart - Cuando el cron envía recordatorios de carrito abandonado.
  • order_placed - Cuando se crea un pedido/factura.
  • order_paid - Cuando una factura se marca como pagada.

Cuerpo del Webhook

El formato de cuerpo por defecto suele ser:

{"to":"{contact_phonenumber}","body":"{message}"}

El marcador {message} se reemplaza por el mensaje renderizado (codificado en JSON). Ajusta la plantilla del cuerpo para que coincida con los requisitos de la API de tu gateway.