Kalendia

Cómo integrar mi chatbot con Kalendia

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.

Conectar Chatbot a Kalendia Asistente IA para automatización empresarial

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

  1. Consulta la información pública del negocio.
  2. Prueba la disponibilidad o el catálogo.
  3. Realiza una operación de prueba con un cliente autorizado.
  4. Comprueba el resultado dentro de Kalendia.
  5. 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.

Scroll al inicio