Kalendia permite conectar chatbots creados en n8n, Make o con desarrollo propio mediante una API segura. La conexión puede consultar información autorizada del negocio, sus productos, servicios y recursos reservables y, si le concedes permisos, crear citas, pedidos, enlaces de pago o solicitudes de atención.

Antes de comenzar
- Debes tener acceso administrativo al negocio.
- El sistema externo debe poder enviar solicitudes HTTPS con encabezados personalizados.
- Define previamente qué información y operaciones necesita realmente el chatbot.
1. Crea una conexión
En el panel de Kalendia abre Configuración → Integraciones → Chatbots externos. En la pestaña Conexiones, selecciona Crear conexión, indica un nombre reconocible, la plataforma y los permisos necesarios.
Al crearla, Kalendia mostrará una credencial una sola vez. Cópiala y guárdala en el gestor de secretos de n8n, Make o tu servidor. No la envíes por chat ni la insertes en páginas públicas.
2. Configura la autenticación
La URL base se muestra en la pestaña Actividad y seguridad. Cada petición debe enviar la credencial en el encabezado Authorization usando el formato Bearer TU_CREDENCIAL y solicitar respuestas JSON.
3. Elige permisos mínimos
Empieza únicamente con permisos de lectura. Agrega permisos de creación o modificación solo cuando el flujo los necesite. Los datos privados requieren una verificación independiente del cliente; la credencial identifica al sistema externo, no a la persona que conversa.
4. Prueba el flujo completo
- Consulta la información pública del negocio.
- Prueba la disponibilidad o el catálogo.
- Realiza una operación de prueba con un cliente autorizado.
- Comprueba el resultado dentro de Kalendia.
- Revisa la pestaña Actividad y seguridad para confirmar el estado HTTP.
5. Activa eventos y webhooks
Si necesitas recibir cambios sin consultar continuamente la API, abre Eventos y webhooks, registra un endpoint HTTPS y selecciona los eventos. Guarda el secreto del webhook y valida siempre la firma antes de procesar el mensaje.
Buenas prácticas
- Usa una conexión distinta por plataforma o entorno.
- Rota la credencial si crees que pudo quedar expuesta.
- Pausa una conexión durante mantenimiento y revócala si ya no se utilizará.
- No guardes tokens, datos bancarios ni información privada dentro de mensajes del chatbot.
- Confirma pagos únicamente con el estado verificado por Kalendia.
Para los nombres exactos de rutas, parámetros y respuestas, consulta también el Contrato API. Para conocer el alcance técnico y las validaciones de seguridad, revisa el Informe técnico.

