EvaSay tiene su propio calendario de reservas: los agentes con las funciones de reserva consultan en él las horas libres, reservan y cancelan durante llamadas y chats, y tu equipo lo ve en la página Citas. La API trabaja sobre el mismo calendario, así que tu sitio web, tu sistema de reservas o tu recepción también pueden usarlo. Los días y horas de apertura, la duración de una cita y el personal se configuran en Citas → Horario de reservas; las fechas y horas están en la zona horaria del calendario.
| Método | Ruta | Qué hace |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | Las horas de inicio libres ese día; staff para las de una persona |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | Las citas desde ese día (days hasta 31), con los settings del calendario |
| POST | /api/v1/voice/appointments | Reserva una cita |
| GET | /api/v1/voice/appointments/{id} | Una cita |
| PATCH | /api/v1/voice/appointments/{id} | Cambia su status, sus notes o su service |
curl https://evasay.com/api/v1/voice/appointments \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{ "date": "2030-01-07", "time": "10:00", "name": "Ana Silva", "phone": "+14155550123", "service": "Haircut" }'
date, time y name son obligatorios; phone, email, service, staff y notes son opcionales. Una reserva sigue las reglas del agente: el calendario debe estar abierto a esa hora y alguien debe estar libre, la persona pedida en staff o, si no se indica, cualquiera (sin personal, el negocio atiende una cita a la vez). Una hora ocupada o fuera del horario responde 409 con el código appointment_conflict. Un teléfono en formato internacional vincula la cita a ese cliente, o lo añade a tus clientes. La respuesta es la cita, con source api.
Una cita está booked, completed (atendida), no_show o cancelled; la que espera un hueco está waitlisted. Marca la visita después:
{ "status": "completed" }
Una visita completada cuenta en las visitas del cliente. Cancelar una cita libera su hora; si faltan más de 15 minutos, la primera persona en la lista de espera para esa hora queda reservada. Una cita en lista de espera solo se puede cancelar. Tus sistemas se enteran de las reservas en cuanto ocurren con los eventos de webhook appointment.created y appointment.updated.