Apariencia
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
- Tu sistema busca las citas de mañana (una tarea programada, por ejemplo a las 18:00).
- 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.
- Guardas el id del mensaje (
msg_...) en la cita. - Cuando el cliente vota, ZAPPIO te envía
message.poll_votecon el id de la encuesta y la opción elegida. - 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.