¿Qué son las claves API de AI4CALL?
Las claves API de AI4CALL son las credenciales con las que tus aplicaciones acceden a las API de AI4CALL. Se crean desde el portal con el botón Nueva API Key, se muestran en claro una sola vez y se incluyen en el header de las solicitudes. Puedes eliminar cada clave por separado, pero atención: la eliminación es inmediata y definitiva.
AI4CALL ofrece asistentes de voz que responden al teléfono, entienden y actúan. Las empresas los usan sin escribir código; los desarrolladores y los integradores de sistemas pueden conectarlos con su propio software mediante API completas. Las claves API son la puerta de entrada a esas integraciones: en este videotutorial vemos cómo generarlas, guardarlas y eliminarlas de forma segura.
Cómo se usan las claves API: header y documentación de los endpoints
Una clave API es una clave única que tu aplicación envía en el header de cada solicitud a las API de AI4CALL. La documentación completa de los endpoints está disponible en swagger.ai4call.com, con los parámetros y formatos de cada llamada.
Dos endpoints para llamadas salientes
Entre los endpoints disponibles, hay dos que conviene conocer desde el principio: permiten iniciar llamadas salientes con los asistentes de AI4CALL.
- Webhook outbound call PBX: inicia llamadas salientes desde tu centralita. El parámetro IP PBX debe coincidir con una dirección habilitada en Gestión › Habilitar IP.
- Webhook outbound call: la llamada sale de los trunks VoIP de AI4CALL, sin necesidad de configurar tu centralita. El caller ID debe ser un número demo o comprado que esté en tu cuenta.
En resumen, lo que cambia es el punto desde el que sale la llamada: tu centralita, con una dirección IP habilitada, o los trunks VoIP de AI4CALL, sin tocar la configuración de la centralita.
Cómo generar una nueva clave API
Desde el portal de AI4CALL bastan cuatro pasos:
- Haz clic en Nueva API Key.
- Se abre la ventana Crear nueva API Key, que te avisa de que se generará una nueva clave única.
- Pulsa Generar API Key.
- Copia de inmediato la clave que aparece en pantalla y guárdala en un lugar seguro.
Guardar la clave API: solo se muestra una vez
Este es el paso más importante: la clave se muestra en claro una sola vez. Cópiala y guárdala en un lugar seguro antes de cerrar la ventana. Después aparece en la tabla enmascarada, junto con su fecha de creación, y ya no se puede recuperar completa.
Varias claves API para distintas aplicaciones y entornos
Puedes generar varias claves y asignar una a cada aplicación o entorno. La ventaja es concreta: si una clave se ve comprometida, o si das de baja una integración, eliminas solo esa. Todas las integraciones que usan otras claves siguen funcionando sin interrupciones.
Cómo eliminar una clave API de forma segura
Para eliminar una clave, haz clic en el icono rojo de su fila y confirma. Atención: la eliminación es inmediata y definitiva. Cualquier aplicación que usara esa clave deja de funcionar al instante. Por eso, lleva siempre un registro de qué clave está asignada a cada integración.
Seguridad de las claves API: trátalas como contraseñas
La última recomendación del videotutorial es sencilla: trata las claves API como contraseñas. Es decir, nunca pongas una clave:
- en código fuente compartido;
- en correos electrónicos o mensajes de chat;
- en aplicaciones del lado del navegador, donde cualquiera podría verla.
Claves API de AI4CALL en resumen
Crea la clave con Nueva API Key › Generar API Key y cópiala de inmediato: solo se muestra en claro una vez. Inclúyela en el header de las solicitudes y consulta los endpoints en swagger.ai4call.com. Usa una clave por aplicación o entorno. Elimínala con el icono rojo: el efecto es inmediato y definitivo. Y trátala siempre como una contraseña.
Preguntas frecuentes sobre las claves API de AI4CALL
¿Puedo recuperar una clave API después de generarla?
No. La clave se muestra en claro una sola vez, en el momento de generarla. Después aparece enmascarada en la lista y ya no se puede recuperar completa. Si la has perdido, genera una nueva clave y elimina la anterior.
¿Qué ocurre cuando elimino una clave API?
La eliminación es inmediata y definitiva: cualquier aplicación que usara esa clave deja de funcionar. Tus demás claves siguen activas.
¿Qué endpoint uso para llamar sin configurar mi centralita?
El endpoint Webhook outbound call: la llamada sale de los trunks VoIP de AI4CALL. El caller ID debe ser un número demo o comprado que esté en tu cuenta.
¿Quieres integrar AI4CALL con tu software?
Habla con nuestro equipo: te ayudamos a conectar los asistentes de voz de AI4CALL con tus aplicaciones a través de las API.