API de Calendario y Citas
Cómo consultar horarios disponibles y crear citas en el módulo de Calendario de Omnifox por API.
Mira este paso en el video · Automatizaciones con citas
El módulo de Calendario permite agendar citas (reuniones, demos, soporte) vinculadas a un contacto, un agente y opcionalmente una conversación o una oportunidad del CRM. La API expone el mismo motor que usan los enlaces de reserva públicos.
Requisitos
- Token Bearer del workspace.
- Un
calendar_idexistente (GET /api/v1/calendar/calendars) y, si aplica, unservice_id(GET /api/v1/calendar/services).
Endpoints principales
GET/POST /api/v1/calendar/calendars— calendarios del workspace (uno por agente o recurso).GET/POST /api/v1/calendar/services— tipos de servicio/duración (ej: "Demo 30 min").GET /api/v1/calendar/slots— horarios disponibles para un calendario/servicio en un rango de fechas.GET/POST /api/v1/calendar/appointments— listar o crear citas.PUT /api/v1/calendar/appointments/{id}— reprogramar.POST /api/v1/calendar/appointments/{id}/cancel— cancelar.GET/POST /api/v1/calendar/booking-links— enlaces públicos de auto-reserva.
Campos para crear una cita
{
"calendar_id": 3,
"service_id": 7,
"contact_id": 55,
"starts_at": "2026-07-20T15:00:00-05:00",
"ends_at": "2026-07-20T15:30:00-05:00",
"title": "Demo de Omnifox",
"notes": "Cliente interesado en el módulo CRM"
}
Solo calendar_id y starts_at son obligatorios; si mandas service_id, la duración se calcula sola.
Ejemplo: consultar horarios libres antes de agendar
curl -X GET "https://app.omnifox.io/api/v1/calendar/slots?calendar_id=3&service_id=7&from=2026-07-20&to=2026-07-22" \
-H "Authorization: Bearer TU_TOKEN"
Consejos
- Siempre consulta
/slotsantes dePOST /appointmentspara evitar choques de horario; el endpoint de creación igual valida disponibilidad server-side. - Vincula
deal_idoconversation_ida la cita para que quede trazada en el historial del contacto y en la línea de tiempo del CRM.
Solución de problemas
- 422 al crear la cita: el rango
starts_at/ends_atse solapa con otra cita del mismo calendario. - El slot aparecía libre pero la creación falla: puede haberse reservado entre la consulta y el envío; vuelve a pedir
/slots. - La cita no muestra el contacto: confirma que
contact_idcorresponde al workspace correcto.
Artículos relacionados
-
Cómo conectar integraciones y apps externas
Conecta Omnifox con tus herramientas favoritas desde el catálogo de integraciones en pocos pasos.
-
Guía completa de integraciones y API
Integraciones y API a fondo, en 30 capítulos: claves API, llamadas reales, webhooks firmados, n8n, MCP y SDK, todo funcionando de verdad.
-
Integrar Omnifox con Azur, Siigo, Alegra, QuickBooks u otro sistema contable o ERP
Omnifox no tiene hoy un conector nativo con sistemas contables o ERP. Te explicamos cómo conectarlos igual con workflows, el nodo HTTP, n8n, Make, Zapier o la API, con ejemplos.
-
Generar y usar API keys y webhooks
Crea claves de API para acceder a Omnifox por código y configura webhooks para recibir eventos en tiempo real.
-
Introducción a las integraciones (webhook / OAuth / API key)
Conecta Omnifox con tus otras herramientas: qué está disponible hoy, qué llega pronto y cuándo usar un webhook, una conexión OAuth o una clave de API.