Ir al contenido

Recordatorios de citas por WhatsApp con confirmación ​

Una cita olvidada es un espacio perdido. Un día antes, tu sistema manda un recordatorio por WhatsApp con una encuesta: tu cliente confirma o pide reagendar con un toque, y la respuesta llega a tu sistema por webhook.

Cómo queda ​

  1. Tu sistema busca las citas de mañana (una tarea programada, por ejemplo a las 18:00).
  2. Por cada cita envía una encuesta: "¿Confirmas tu cita mañana a las 10:00?" con las opciones Sí, ahí estaré y Necesito reagendar.
  3. Guardas el id del mensaje (msg_...) en la cita.
  4. Cuando el cliente vota, ZAPPIO te envía message.poll_vote con el id de la encuesta y la opción elegida.
  5. Tu sistema marca la cita como confirmada, o te avisa para reagendar.

Enviar el recordatorio ​

bash
curl -X POST "$ZAPPIO_API_URL/api/v1/messages" \
  -H "Authorization: Bearer $ZAPPIO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: cita-381-recordatorio" \
  -d '{
    "instance": "'"$ZAPPIO_INSTANCE"'",
    "to": "5215500000000",
    "type": "poll",
    "poll": {
      "question": "Hola Luis, ¿confirmas tu cita mañana a las 10:00?",
      "options": ["Sí, ahí estaré", "Necesito reagendar"]
    }
  }'

La respuesta es 202 Accepted y trae data.id: guárdalo en la cita. Una encuesta lleva de 2 a 12 opciones (Encuestas).

Recibir la respuesta ​

Suscribe tu webhook al evento message.poll_vote. Llega cada vez que alguien vota, cambia su voto o lo quita, con el mensaje de la encuesta y el voto:

json
{
  "type": "message.poll_vote",
  "data": {
    "message": { "id": "msg_01EXAMPLE00000000000000000", "type": "poll", "poll": { "...": "..." } },
    "vote": { "from": "5215500000000", "from_me": false, "options": ["Sí, ahí estaré"], "voted_at": "2026-01-01T18:05:30+00:00" }
  }
}

En tu servidor (Node.js con Express; verifica la firma igual que en la guía de webhooks):

js
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.poll_vote') return;

  const appointment = await db.appointments.findByMessageId(event.data.message.id); // el msg_ que guardaste
  if (!appointment) return;

  const [choice] = event.data.vote.options; // vacío = quitó su voto
  if (choice === 'Sí, ahí estaré') await appointment.confirm();
  else if (choice === 'Necesito reagendar') await appointment.flagForReschedule();
});

Buenas prácticas ​

  • Una clave de idempotencia por cita (cita-381-recordatorio): si la tarea programada corre dos veces, el recordatorio sale una sola vez.
  • El voto puede cambiar. Llega un evento nuevo cada vez; usa el más reciente (voted_at).
  • Envía la encuesta por la API. Solo así ZAPPIO puede contar los votos; las encuestas creadas a mano en el teléfono de tu número no traen votos (Encuestas).
  • Si responden con texto ("¿puede ser a las 12?"), llega como message.received: atiéndelo en tu sistema o con un bot.
  • Comparte la dirección del consultorio como ubicación (Ubicaciones y contactos).

Pruébalo gratis

Crea tu cuenta: 50 mensajes de prueba, sin tarjeta. Después, $400 MXN al mes, IVA incluido, sin cobro por mensaje.