Cómo crear tu propia integración con Atendalia
Una integración propia conecta eventos de Atendalia con tu sistema mediante webhooks salientes, o consulta y crea citas con una llave de API. Antes de programar, define la dirección de los datos, los eventos necesarios y cómo validarás el resultado.
Qué puedes hacer con tu propio sistema
Puedes llevar las citas y avisos de Atendalia al programa que ya usa tu negocio. Por ejemplo, mostrar una cita nueva en tu sistema o avisar a recepción cuando el cliente la cancela. No necesitas Zapier si tu sistema puede recibir la información directamente.
Tu equipo técnico necesita preparar esa conexión. Un webhook es un aviso automático de que algo ocurrió; la API permite que tu sistema consulte información o solicite una acción. Si solo quieres agenda, primero prueba el calendario de Atendalia o la conexión directa con Google Calendar.
Elige la dirección de los datos
Si quieres recibir avisos cuando ocurre una cita o cambia su estado, configura un webhook saliente. Atendalia enviará un evento a una URL HTTPS de tu sistema. Si tu aplicación necesita consultar disponibilidad o administrar citas, revisa la API pública y crea una llave desde el panel.
No todas las integraciones son bidireccionales. Dibuja primero qué sistema es la fuente de verdad de cada dato para evitar reservas duplicadas.
Prepara un endpoint seguro
Para un webhook propio necesitas una URL HTTPS pública. El panel rechaza direcciones privadas o locales. Guarda el secreto de firma en el servidor y valida cada solicitud antes de procesar nombres, teléfonos o datos de citas.
Tu endpoint debe responder de forma predecible y registrar los errores sin volcar datos personales innecesarios. Prueba con información ficticia antes de conectar la operación real.
- Usa HTTPS y un dominio bajo tu control.
- Selecciona solo los eventos que necesita tu flujo.
- Protege el secreto y rota las credenciales si se exponen.
- Haz que el procesamiento tolere eventos repetidos.
Configura y prueba desde el panel
Abre Integraciones en el panel, elige Mi propio sistema, proporciona la URL y el secreto, y marca los eventos que quieres recibir. Después ejecuta una prueba y comprueba tanto el historial de la integración como el registro de tu servidor.
Si prefieres conectar una herramienta sin mantener un endpoint propio, revisa primero las guías de Zapier y Make. Esas plataformas tienen límites y costos independientes.
Usa la API solo para los flujos que la requieren
Una llave de API se muestra una sola vez al crearla. Guárdala en el servidor, nunca en JavaScript público ni en una aplicación móvil sin intermediario. Revoca las llaves que ya no se usen.
La API pública ofrece rutas para citas y disponibilidad. Revisa los campos, respuestas y errores de cada ruta antes de construir una sincronización automática; prueba la creación y cancelación con datos de ejemplo.
Verifica el recorrido completo
Haz una reserva de prueba, confirma que llegó el evento esperado, revisa qué campos recibió tu sistema y comprueba que no se creó una segunda cita. Repite con una cancelación y con una respuesta fallida de tu endpoint.
La guía específica de Mi propio sistema contiene el ejemplo del payload y los eventos disponibles. Úsala como contrato de referencia antes de conectar clientes reales.