Conectar Doctoralia con un asistente virtual no tiene por qué ser complejo. Si defines bien el flujo de datos y eliges el método correcto, puedes confirmar, mover y cancelar citas desde el asistente sin tocar la agenda manualmente.
Antes de empezar: requisitos y mapa de datos
Antes de integrar, asegúrate de que tu flujo cubre el 80% de las situaciones reales en recepción. Un diseño claro evita parches posteriores y previene errores costosos al paciente.
Datos que viajarán y mapeo
Empieza por listar qué campos son imprescindibles para crear/modificar una cita y qué actor los genera:
- Identificación del paciente: nombre y teléfono (el correo es recomendable para recordatorios).
- Motivo/servicio: la categoría que usa Doctoralia para esa visita.
- Profesional/sillón: el recurso al que se asigna.
- Fecha y duración: respetando “tiempos de preparación” si los usas.
- Notas internas: alergias, advertencias o preferencias relevantes.
Mapea estos campos contra tu calendario de referencia (Google/Outlook). Si ya dependes de la agenda de Doctoralia, el calendario será tu “puente” técnico: el asistente escribirá y leerá eventos ahí; Doctoralia los reflejará vía sincronización.
Para evitar incidencias comunes, define también reglas de negocio: ventanas mínimas de antelación, huecos bloqueados por tratamiento, campos obligatorios y el comportamiento ante solapes.
Consulta además buenas prácticas para evitar fallos recurrentes en la gestión de agenda en este análisis de errores que vemos a menudo en clínicas: Errores al gestionar citas dentales manualmente.
Permisos, consentimiento y privacidad
El tratamiento de datos de salud exige garantías reforzadas. En España, la LOPDGDD desarrolla el RGPD e impone medidas técnicas y organizativas adecuadas. Revísala antes de desplegar la integración: LOPDGDD (Ley Orgánica 3/2018).
Recomendaciones clave: minimiza datos (solo los estrictamente necesarios), cifra en tránsito y en reposo, limita accesos por rol, registra auditorías y establece acuerdos de encargo de tratamiento con proveedores.
Métodos de integración disponibles
Hay dos enfoques prácticos y complementarios para conectar Doctoralia con tu asistente virtual sin requerir acceso directo a un API propio de la plataforma.
Opción 1: Sincronización de calendario
Es la ruta más estable. Muchas clínicas conectan Doctoralia con Google Calendar u Outlook. Tu asistente virtual operará sobre ese calendario “puente” creando, moviendo o cancelando eventos. Ventajas: sincronización bidireccional, control de conflictos y uso de APIs maduras.
- Google Calendar: crea/lee eventos y sus metadatos a través de la API oficial (Google Calendar API).
- Outlook/Office 365: gestiona eventos con Microsoft Graph (Microsoft Graph Calendar).
Opción 2: Email parsing + webhooks
Si Doctoralia envía correos de notificación por nuevas reservas/modificaciones, puedes “escucharlos” en un buzón dedicado. Un servicio de automatización extrae los datos y dispara un webhook al asistente para actualizar el calendario o confirmar al paciente. Es útil cuando el calendario no refleja todos los detalles o como redundancia.
Herramientas como Zapier permiten recibir y enviar webhooks sin código (Zapier Webhooks).
Además, si tu asistente gestiona llamadas entrantes, conviene revisar cómo reducir cuellos de botella en picos de demanda. Aquí tienes contexto sobre saturación y su impacto en la experiencia del paciente: Saturación telefónica y experiencia del paciente dental.
Paso a paso: Sincronización vía Google/Outlook Calendar
Este método se apoya en el calendario que Doctoralia sincroniza. Es el más directo para que un asistente virtual gestione la agenda sin intervención manual.
Paso 1: Configura la sincronización
Paso 1: Verifica que tu cuenta de Doctoralia tiene activa la sincronización con Google Calendar u Outlook y qué calendario específico se usa por profesional. Documenta: nombre del calendario, zona horaria y reglas de disponibilidad.
Paso 2: Normaliza la nomenclatura de eventos. Por ejemplo: “Paciente | Servicio | Teléfono”. Añade etiquetas en la descripción como “Motivo: …” para facilitar el parsing del asistente si necesitas datos adicionales.
Paso 3: Reserva bloques no disponibles (p. ej., cirugía, formación). El asistente debe respetar estos eventos como “bloqueos” para evitar solapes.
Consejo práctico: si trabajas con varios profesionales, crea un calendario por profesional o por sillón. Evitarás conflictos y mejorarás la precisión al consultar “próxima disponibilidad”.
Paso 2: Conecta el calendario con el asistente
Paso 1: Autoriza al asistente a leer/escribir en el calendario. En Google, usa OAuth con el scope de Calendar; en entornos corporativos, valora una cuenta de servicio con acceso delegado. En Microsoft, usa Microsoft Graph y permisos aplicativos o delegados según política.
Paso 2: Define la estructura del evento. Incluye título (Paciente + Motivo), fecha/hora, duración, ubicación (presencial/online), teléfono y notas. Evita poner datos clínicos sensibles en el título; usa la descripción si fuera imprescindible y bajo políticas claras.
Paso 3: Implementa reglas de creación y actualización:
- El asistente consulta huecos según especialidad, duración y profesional.
- Antes de crear, valida que no exista un evento coincidente ±5 minutos.
- Al reprogramar, conserva el ID del evento y registra en notas el cambio (fecha/hora anterior) para auditoría.
Tip: distingue estados con colores o prefijos: “PTE CONF” (pendiente de confirmación), “CONF” (confirmada), “NO SHOW” (ausencia). Tu asistente puede cambiar el estado tras confirmar por SMS/llamada.
Paso 3: Prueba, excepciones y bloqueos
Pruebas funcionales: crea, mueve y cancela citas de prueba con diferentes motivos y duraciones. Verifica que Doctoralia refleja los cambios en minutos y que no se crean duplicados.
Excepciones: define qué hacer si no hay hueco (lista de espera, clínica alternativa, propuesta de primer hueco siguiente).
Bloqueos: eventos marcados como “privado” o con palabra clave (p. ej., “BLOQUEO”) no deben ser modificables por el asistente. Implántalo desde el código del bot o la herramienta que uses.
Errores comunes a evitar: usar zonas horarias distintas, no filtrar festivos locales, permitir que dos agentes escriban a la vez sin control de concurrencia y no registrar quién/qué cambió cada evento.
Paso a paso: Integración por emails + webhooks
Cuando las notificaciones por correo son tu fuente de verdad, crea un flujo robusto que convierta esos avisos en acciones del asistente.
Flujo propuesto y errores a evitar
Paso 1: Crea un buzón dedicado (p. ej., agenda@tuclinica.es) solo para notificaciones de Doctoralia. Configura filtros para etiquetar “nueva reserva”, “modificación” y “cancelación”.
Paso 2: En tu plataforma de automatización, escucha el buzón y extrae campos clave con reglas o expresiones (nombre, teléfono, servicio, profesional, fecha/hora).
Paso 3: Dispara un webhook al asistente virtual con un payload estándar (JSON) y una firma compartida para validar la procedencia.
Paso 4: El asistente crea/actualiza el evento en el calendario puente. Si hay conflicto, responde al webhook con error y registra incidencia para revisión humana.
Paso 5: Envía confirmación al paciente por el canal acordado (SMS/correo). Si la clínica devuelve “no disponible”, ofrece alternativas.
Errores a evitar: basarte en plantillas de correo que cambian sin aviso, no contemplar codificación de caracteres (acentos), no validar zona horaria y carecer de reintentos si el webhook falla.
Si optas por webhooks, herramientas sin código pueden acelerar el montaje y reducir mantenimiento. Por ejemplo, puedes recibir y enviar webhooks en minutos con esta guía: Zapier Webhooks.
Seguridad, pruebas y despliegue
La integración maneja datos sensibles; la seguridad y el cumplimiento no son negociables. Asegúrate de que tu proveedor y tu clínica cumplen el RGPD y la LOPDGDD, con acuerdos de tratamiento y medidas técnicas.
Checklist de seguridad
- Minimización: solo los campos necesarios para agendar/comunicar.
- Cifrado: TLS en tránsito; cifrado en reposo donde aplique.
- Control de accesos: principio de mínimo privilegio y registro de auditoría.
- Retención: purga de logs y mensajes según política.
- Contratos: encargo de tratamiento con terceros y evaluación de impacto si procede.
- Respuesta a incidentes: procedimiento y ventana máxima de notificación.
Plan de pruebas mínimo
- Casos de uso: alta, reprogramación, cancelación, hueco sin disponibilidad.
- Conflictos: citas consecutivas con buffers, bloqueos, recursos no disponibles.
- Integridad: mismo evento visto igual en calendario y en Doctoralia.
- Resiliencia: caídas del servicio, reintentos, colas y alertas.
- Trazabilidad: cada acción del asistente tiene un ID y un registro claro.
Métricas que importan tras el despliegue: confirmación de citas en primera interacción, reprogramaciones exitosas, eventos duplicados (objetivo: 0), tiempo medio hasta la primera cita disponible y ausencias. Para reducir pérdidas por llamadas, revisa estas tácticas: Cómo reducir llamadas perdidas en tu clínica dental.
Recuerda: si el volumen de llamadas y mensajes crece, tu asistente puede absorber la entrada y operar siempre sobre el calendario puente. Cuando la sincronización esté bien afinada, Doctoralia reflejará el estado real sin fricciones ni sorpresas para el equipo.
Como opción, si buscas un asistente preparado para clínicas dentales que ya contempla estos flujos de calendario y cumplimiento, puedes evaluar soluciones como SmartDentalBot.
Fuentes consultadas:
- Google Calendar API: https://developers.google.com/calendar/api
- Microsoft Graph Calendar: https://learn.microsoft.com/en-us/graph/api/resources/event?view=graph-rest-1.0
- Zapier Webhooks: https://zapier.com/help/create/code-webhooks/use-webhooks-in-zaps
- LOPDGDD (Ley Orgánica 3/2018): https://www.boe.es/eli/es/lo/2018/12/05/3