Ir al contenido

Notificaciones de pedidos por WhatsApp ​

"¿Y mi pedido?" es la pregunta que más llega a una tienda en línea. Si tu sistema avisa por WhatsApp en cada cambio de estado (confirmado, enviado, entregado), tu cliente se entera al momento y tú dejas de contestar lo mismo todo el día.

Con ZAPPIO es una petición HTTP en el punto de tu código donde el pedido cambia de estado.

Cómo queda ​

  1. Tu sistema marca el pedido 1042 como enviado.
  2. En ese mismo punto llama a POST /api/v1/messages.
  3. Tu cliente recibe "Tu pedido 1042 va en camino 🚚" en su WhatsApp.
  4. ZAPPIO te avisa por webhook cuando el mensaje fue entregado y leído (message.delivered, message.read).

El envío ​

bash
curl -X POST "$ZAPPIO_API_URL/api/v1/messages" \
  -H "Authorization: Bearer $ZAPPIO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-1042-enviado" \
  -d '{
    "instance": "'"$ZAPPIO_INSTANCE"'",
    "to": "5215500000000",
    "type": "text",
    "text": "Hola Ana, tu pedido 1042 va en camino 🚚. Llega mañana entre 9 y 14 h."
  }'

Lo mismo desde tu código, por ejemplo en Node.js al cambiar el estado del pedido:

js
async function notifyOrderShipped(order) {
  const res = await fetch(`${process.env.ZAPPIO_API_URL}/api/v1/messages`, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.ZAPPIO_API_KEY}`,
      'Content-Type': 'application/json',
      // Una clave por pedido y por aviso: si tu proceso reintenta, el cliente no recibe el mensaje dos veces.
      'Idempotency-Key': `pedido-${order.id}-enviado`,
    },
    body: JSON.stringify({
      instance: process.env.ZAPPIO_INSTANCE,
      to: order.customerPhone, // con código de país: "5215500000000"
      type: 'text',
      text: `Hola ${order.customerName}, tu pedido ${order.id} va en camino 🚚`,
    }),
  });
  const body = await res.json();
  if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
  return body.data.id; // guárdalo con el pedido: con él sigues el estado del mensaje
}

En Laravel o Python es la misma petición.

Buenas prácticas ​

  • Idempotencia por aviso. Usa una clave como pedido-1042-enviado: un reintento de tu cola nunca duplica el mensaje (Idempotencia).
  • Guarda el id del mensaje (msg_...) junto al pedido. Con los eventos message.delivered y message.read puedes mostrar en tu panel si el cliente ya vio el aviso (Webhooks).
  • Solo avisos que el cliente espera. Escribe a quien te compró, sobre su pedido. No uses el número para publicidad masiva: además de molestar, pone en riesgo tu número.
  • Adjunta lo útil. La guía de envío o el comprobante en PDF van como documento (Multimedia, enviar facturas); la sucursal de recogida, como ubicación (Ubicaciones y contactos).
  • Responde las dudas. Si el cliente contesta "¿a qué hora llega?", te llega como message.received: puedes responderle desde tu sistema o con un bot.

Cuánto cuesta ​

La prueba incluye 50 mensajes salientes, sin tarjeta. Después, $400 MXN al mes, IVA incluido, sin cobro por mensaje (Prueba y planes).

Pruébalo gratis

Crea tu cuenta y manda tu primer aviso de pedido hoy.