Que sont les clés API AI4CALL ?
Les clés API AI4CALL sont les identifiants avec lesquels vos applications accèdent aux API d'AI4CALL. Elles se créent depuis le portail avec le bouton Nouvelle API Key, ne s'affichent en clair qu'une seule fois et se placent dans l'en-tête des requêtes. Chaque clé peut être supprimée individuellement, mais attention : la suppression est immédiate et définitive.
AI4CALL propose des assistants vocaux qui répondent au téléphone, comprennent et agissent. Les entreprises les utilisent sans écrire de code ; les développeurs et les intégrateurs peuvent les connecter à leurs propres logiciels grâce à des API complètes. Les clés API sont la porte d'entrée de ces intégrations : dans ce tutoriel vidéo, nous voyons comment les générer, les conserver et les supprimer en toute sécurité.
Utiliser les clés API : en-tête et documentation des endpoints
Une clé API est une clé unique que votre application transmet dans l'en-tête de chaque requête vers les API d'AI4CALL. La documentation complète des endpoints est disponible sur swagger.ai4call.com, avec les paramètres et formats de chaque appel.
Deux endpoints pour les appels sortants
Parmi les endpoints disponibles, deux sont à connaître dès le départ : ils permettent de lancer des appels sortants avec les assistants AI4CALL.
- Webhook outbound call PBX : lance des appels sortants depuis votre standard téléphonique. Le paramètre IP PBX doit correspondre à une adresse autorisée dans Gestion › Autoriser IP.
- Webhook outbound call : l'appel part des trunks VoIP d'AI4CALL, sans aucune configuration sur votre standard. Le caller ID doit être un numéro de démo ou acheté présent dans votre compte.
En résumé, c'est le point de départ de l'appel qui change : votre standard, avec une adresse IP autorisée, ou les trunks VoIP d'AI4CALL, sans toucher à la configuration du standard.
Comment générer une nouvelle clé API
Depuis le portail AI4CALL, quatre étapes suffisent :
- Cliquez sur Nouvelle API Key.
- La fenêtre Créer une nouvelle API Key s'ouvre et vous indique qu'une nouvelle clé unique va être générée.
- Cliquez sur Générer l'API Key.
- Copiez immédiatement la clé affichée à l'écran et conservez-la en lieu sûr.
Conserver la clé API : elle ne s'affiche qu'une fois
C'est l'étape la plus importante : la clé ne s'affiche en clair qu'une seule fois. Copiez-la et mettez-la en lieu sûr avant de fermer la fenêtre. Ensuite, elle apparaît dans le tableau sous forme masquée, avec sa date de création, et ne peut plus être récupérée en entier.
Plusieurs clés API pour différentes applications et environnements
Vous pouvez générer plusieurs clés et en attribuer une à chaque application ou environnement. L'avantage est concret : si une clé est compromise, ou si vous abandonnez une intégration, vous supprimez uniquement celle-ci. Toutes les intégrations qui utilisent d'autres clés continuent de fonctionner sans interruption.
Comment supprimer une clé API en toute sécurité
Pour supprimer une clé, cliquez sur l'icône rouge de sa ligne et confirmez. Attention : la suppression est immédiate et définitive. Toute application qui utilisait cette clé cesse aussitôt de fonctionner. Gardez donc toujours une trace de la clé attribuée à chaque intégration.
Sécurité des clés API : traitez-les comme des mots de passe
La dernière recommandation du tutoriel vidéo est simple : traitez les clés API comme des mots de passe. Ne placez donc jamais une clé :
- dans du code source partagé ;
- dans un e-mail ou un message de chat ;
- dans une application côté navigateur, où elle serait visible par tous.
Les clés API AI4CALL en bref
Créez la clé avec Nouvelle API Key › Générer l'API Key et copiez-la aussitôt : elle ne s'affiche en clair qu'une seule fois. Placez-la dans l'en-tête des requêtes et consultez les endpoints sur swagger.ai4call.com. Utilisez une clé par application ou environnement. Supprimez-la avec l'icône rouge : l'effet est immédiat et définitif. Et traitez-la toujours comme un mot de passe.
Questions fréquentes sur les clés API AI4CALL
Puis-je récupérer une clé API après l'avoir générée ?
Non. La clé ne s'affiche en clair qu'une seule fois, au moment de sa génération. Ensuite, elle apparaît masquée dans la liste et ne peut plus être récupérée en entier. Si vous l'avez perdue, générez une nouvelle clé et supprimez l'ancienne.
Que se passe-t-il quand je supprime une clé API ?
La suppression est immédiate et définitive : toute application qui utilisait cette clé cesse de fonctionner. Vos autres clés restent actives.
Quel endpoint utiliser pour appeler sans configurer mon standard ?
L'endpoint Webhook outbound call : l'appel part des trunks VoIP d'AI4CALL. Le caller ID doit être un numéro de démo ou acheté présent dans votre compte.
Vous souhaitez intégrer AI4CALL à vos logiciels ?
Parlez à notre équipe : nous vous aidons à connecter les assistants vocaux AI4CALL à vos applications via les API.