Apariencia
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
- Tu sistema marca el pedido 1042 como enviado.
- En ese mismo punto llama a
POST /api/v1/messages. - Tu cliente recibe "Tu pedido 1042 va en camino 🚚" en su WhatsApp.
- 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 eventosmessage.deliveredymessage.readpuedes 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.