Sí, puedes gestionar servicios, horarios y citas vía API usando el módulo de Citas de Papo. La API REST te permite listar servicios, profesionales y pacientes, consultar la agenda y crear nuevas citas de forma programática, integrando todo el flujo de reservas con tu sitio web, aplicación o sistema externo.
El módulo de Citas de Papo está diseñado para ser el centro de control de tu agenda. Organiza cuatro pilares: los servicios que ofreces (con nombre, duración y precio), los profesionales que los realizan, la disponibilidad de horarios de cada uno y las citas realizadas. Con la API, puedes automatizar estas operaciones sin acceder manualmente al panel, manteniendo una integración fluida entre Papo y tus otras herramientas.
Resumen de las operaciones de Citas vía API
| Operación | Qué hace | Cuándo usarla |
|---|---|---|
| Listar servicios | Devuelve los servicios de citas registrados, con duración y precio. | Sincronizar el catálogo de servicios con tu sitio web o aplicación para que el cliente vea las opciones en tiempo real. |
| Listar profesionales | Devuelve la lista de profesionales o miembros del equipo que realizan los servicios. | Mostrar los profesionales disponibles y sus especialidades en una interfaz externa de reservas. |
| Listar pacientes | Devuelve los pacientes registrados, con nombre, teléfono e ID. | Verificar si un cliente ya existe en el CRM antes de crear una nueva cita o vincularlo a un registro existente. |
| Listar citas | Devuelve las citas con filtro por estado (ej.: confirmada, pendiente). | Auditar reservas, integrar con sistemas de informes o verificar la ocupación de la agenda antes de ofrecer nuevos horarios. |
| Agendar una cita | Crea una cita real en la agenda de un profesional, para un servicio y paciente específicos. | Permitir que los clientes agenden directamente desde tu sitio web o aplicación, o automatizar la creación de reservas desde sistemas externos. |
Cómo funciona la autenticación de la API
Todas las operaciones de escritura en Citas requieren la clave secreta de tu cuenta de Papo, enviada como token Bearer en el encabezado de autorización. La clave pública de la cuenta es opcional, pero, si se envía, debe corresponder a la misma cuenta de la clave secreta.
La URL base de la API es https://app.papo.global/api/v1. Las claves se generan en el área de desarrollador del panel de Papo. La clave secreta se muestra una única vez al crearla; guárdala en un lugar seguro y revócala de inmediato si sospechas de una filtración.
Cómo usarla en la práctica
- Accede al área de desarrollador/API en el panel de Papo y genera una clave secreta. Copia también la clave pública de la cuenta.
- En cada solicitud, autentícate con la clave secreta como token Bearer. Si quieres reforzar la validación, envía la clave pública en el encabezado indicado en la documentación.
- Para armar la interfaz de reservas, primero lista los servicios y profesionales disponibles. Así, puedes poblar dinámicamente las opciones en tu sitio web o app con los datos reales de tu cuenta de Papo.
- Para crear una cita, llama al endpoint de creación de citas, enviando en el payload JSON los identificadores del servicio, del profesional, del paciente y la fecha/hora deseada. La API validará la disponibilidad en la agenda configurada en el módulo de Citas y creará el compromiso.
- Consulta la documentación oficial en
https://papo.global/pt/docspara obtener las rutas exactas, los parámetros obligatorios y ejemplos de código. Todas las respuestas están en formato JSON.
La API también permite listar las citas existentes con filtro por estado. Esto es útil para construir paneles de seguimiento, enviar recordatorios automáticos o integrar el estado de las reservas con otros sistemas.
Para quién está indicada esta integración
- Clínicas, consultorios y salones de belleza que desean ofrecer reservas online en su propio sitio web, con disponibilidad en tiempo real.
- Plataformas SaaS y marketplaces que necesitan conectar la agenda de los prestadores de servicios a un sistema externo de reservas.
- Revendedores white label que crean soluciones personalizadas para clientes finales y quieren exponer el módulo de Citas vía API.
- Empresas con flujos automatizados que disparan la creación de citas a partir de eventos en CRMs, ERPs o herramientas de automatización.
Preguntas frecuentes
¿Necesito tener el módulo de Citas configurado para usar la API?
Sí. Es necesario que los servicios, profesionales y sus disponibilidades ya estén registrados en el módulo de Citas de Papo para que la API pueda listarlos y validar las citas.
¿La API permite crear un nuevo servicio o profesional?
Los recursos de la API se centran en listar servicios y profesionales existentes y agendar citas. Para crear o editar servicios y profesionales, utiliza el panel de Papo.
¿Cómo sabe la API si un horario está libre?
Al enviar una solicitud para agendar una cita, la API de Papo consulta la disponibilidad configurada para el profesional y el servicio elegido en ese día y horario. Si hay conflicto, la cita no se creará y la API devolverá un error.
¿Puedo usar la API para agendar una cita en nombre de un paciente que aún no está en el CRM?
Puedes usar primero la API de Contactos de Papo para crear el paciente (con nombre, correo electrónico y/o teléfono) y, luego, usar el ID devuelto para crear la cita. Consulta la documentación para el endpoint de creación de contactos.
¿La IA de Papo puede agendar automáticamente vía API?
La Inteligencia Artificial de Papo, como Super Chat, agenda directamente desde la conversación en WhatsApp, consultando la agenda del módulo de Citas. La API es el camino para integraciones programáticas externas, como un sistema de reservas online.
¿Dónde veo el formato exacto del payload para agendar?
En la documentación oficial de la API, en https://papo.global/pt/docs. Allí están los detalles de autenticación, parámetros, respuestas y ejemplos de código para los recursos de Citas.
Lea también
- Cómo usar la API de Papo para crear y actualizar contactos en masa
- Cómo usar la API de Papo para crear y gestionar etiquetas (tags)
Comienza a integrar tu agenda vía API →
Regístrate en Papo y accede a la API REST para automatizar tus citas desde el primer usuario.