Métodos de Autenticación de AI Actions

Métodos de Autenticación

AI Actions admite varios métodos de autenticación para conectarse de manera segura a sus API externas. Elija el método que coincida con los requisitos de su API.

Ninguno

No se envía autenticación con la solicitud. Use esto para API públicas que no requieren credenciales.

Cuándo usar: Puntos finales de datos públicos, API abiertas o servicios internos detrás de una VPN.

Token Bearer

Se envía un token fijo en el encabezado Authorization con cada solicitud:

Authorization: Bearer your-token-here

El token se almacena cifrado en su espacio de trabajo y nunca se expone a los clientes ni en las respuestas de la API.

Cuándo usar: La mayoría de las API REST que utilizan claves de API o tokens de acceso. Este es el método de autenticación más común.

Token Bearer del Cliente

En lugar de un único token a nivel de espacio de trabajo, este método utiliza el propio token bearer del cliente, pasado a través de Helpium.identify({ bearerToken: "..." }).

Authorization: Bearer <customer-specific-token>

Si un cliente no tiene un token configurado, la acción vuelve al token predeterminado configurado en la acción misma.

Cuándo usar: API donde cada cliente tiene sus propias credenciales, por ejemplo, buscando la cuenta de un cliente en su sistema utilizando su clave de API personal.

Configuración de tokens de cliente: Los tokens de cliente se pueden configurar a través de la API o manualmente en la página de perfil del cliente. También puede pasarlos durante la inicialización del widget.

Consideraciones de Seguridad

• Todos los tokens de autenticación están cifrados en reposo. Nunca se almacenan en texto plano.
• Los tokens nunca se exponen en las respuestas del chatbot a los clientes.
• Las acciones se ejecutan con un tiempo de espera configurable (1–30 segundos) para evitar solicitudes colgadas.
• Cada llamada de acción está registrada con entrada, salida, estado y duración para auditoría.
• Solo los Propietarios del espacio de trabajo pueden crear, editar o eliminar AI Actions.