Ir al contenido

Bot de respuestas automáticas en WhatsApp ​

Muchas preguntas se repiten: el horario, la dirección, cómo va un pedido. Un bot sencillo las contesta al instante, a cualquier hora, y deja a las personas lo que de verdad necesita a una persona.

Con ZAPPIO el bot son dos piezas que ya conoces: un webhook que recibe cada mensaje (message.received) y la API para responder.

Cómo queda ​

  1. Tu cliente escribe "¿Cuál es su horario?".
  2. ZAPPIO envía message.received a tu servidor, firmado.
  3. Tu código revisa el texto y decide la respuesta.
  4. Respondes con POST /api/v1/messages (puedes citar el mensaje original con reply_to).

El bot (Node.js + Express) ​

Usa la función verifyZappioWebhook de la guía de webhooks y sendWhatsApp de Enviar WhatsApp desde Node.js.

js
const express = require('express');
const { verifyZappioWebhook } = require('./verify-webhook');
const { sendWhatsApp } = require('./zappio');

const ANSWERS = [
  { match: /horario|abren|cierran/i, text: 'Abrimos de lunes a sábado de 9:00 a 19:00 🕘' },
  { match: /direcci[oó]n|d[oó]nde|ubicaci[oó]n/i, text: 'Estamos en Av. Juárez 10, Centro, CDMX 📍' },
  { match: /pedido|env[ií]o/i, text: 'Mándanos tu número de pedido y te decimos cómo va 📦' },
];
const seen = new Set(); // en producción, guarda los event.id en tu base de datos

const app = express();
app.post('/webhooks/zappio', express.raw({ type: 'application/json' }), async (req, res) => {
  if (!verifyZappioWebhook(process.env.ZAPPIO_WEBHOOK_SECRET, req.get('X-Zappio-Timestamp') ?? '', req.get('X-Zappio-Signature') ?? '', req.body)) {
    return res.sendStatus(401);
  }
  res.sendStatus(200);

  const event = JSON.parse(req.body);
  if (event.type !== 'message.received' || seen.has(event.id)) return;
  seen.add(event.id);

  const msg = event.data.message;
  if (msg.group_id !== null || msg.type !== 'text') return; // solo chats directos con texto

  const answer = ANSWERS.find((a) => a.match.test(msg.text));
  await sendWhatsApp(msg.from, answer ? answer.text : 'Gracias por escribir. En un momento te atiende una persona 🙋');
});

app.listen(3000);

Buenas prácticas ​

  • Responde 2xx primero y haz el trabajo después: ZAPPIO espera como máximo 10 segundos (reintentos y duplicados).
  • Deduplica por event.id. Un evento puede llegar más de una vez; sin esto, el bot contestaría dos veces.
  • No contestes en grupos salvo que sea tu intención (group_id distinto de null).
  • Deja salida a una persona. Si el bot no entiende, dilo y pasa la conversación a tu equipo. Con Conversaciones puedes marcar chats como no leídos o archivarlos desde tu sistema.
  • Muestra "escribiendo…" antes de responder para que se sienta natural (Números, perfil y presencia).
  • Los mensajes entrantes no cuentan en la prueba gratuita; las respuestas del bot sí cuentan como salientes.

Más que texto ​

Pruébalo gratis

Crea tu cuenta: 50 mensajes de prueba, sin tarjeta y sin límite de días.