API d'appels IA avec une spécification OpenAPI 3.1 : construisez dès aujourd'hui.
Une API REST à l'usage pour les appels téléphoniques sortants avec IA, décrite dans une spécification publique OpenAPI 3.1. Clés bearer, gestion complète des prospects et des campagnes, transcriptions, enregistrements et rapports.
Ce que couvre l'API FoxEra Calls
L'API REST de FoxEra Calls permet à votre propre code, votre plateforme d'automatisation ou votre GPT Action de déclencher et de gérer des appels téléphoniques sortants avec IA. Elle couvre l'ensemble du cycle de vie d'une campagne :
- Prospects — créez, mettez à jour et organisez vos prospects en dossiers.
- Campagnes — prévisualisez une campagne (effectif, coût estimé, agent d'appel), créez-la, planifiez-la, approuvez-la ou annulez-la.
- Résultats — consultez le résultat de chaque appel : répondu, messagerie vocale, sans réponse, et la réaction du prospect.
- Transcriptions et enregistrements — récupérez la transcription complète et un lien vers l'enregistrement de tout appel terminé.
- Rapports — résumés au niveau de la campagne : total d'appels, minutes connectées, coût, prospects intéressés.
- Compte — vérifiez le solde de crédit, définissez les horaires d'appel, choisissez l'agent IA (Cass, Alex ou Andrea), modifiez et approuvez le discours.
L'authentification utilise des clés d'API bearer (format fxk_...). Chaque clé est limitée à un espace de travail et peut être révoquée instantanément depuis vos paramètres développeur.
La spécification OpenAPI 3.1
L'API complète est décrite dans un document OpenAPI 3.1 à une URL publique :
https://app.foxera.co.uk/api/public/openapi.json
Vous pouvez importer cette spécification dans n'importe quel outil qui lit OpenAPI : Postman, Insomnia, Swagger UI, ou votre propre générateur de code. C'est aussi le format que les GPT Actions acceptent directement — collez l'URL et votre GPT personnalisé peut appeler l'API sans écrire de code d'intégration.
La spécification documente chaque endpoint, corps de requête, format de réponse et code d'erreur. Si vous voulez transformer la spécification en outils MCP pour un assistant IA, la comparaison MCP contre clé d'API explique quand chaque approche convient.
Comment démarrer
- Créez un compte FoxEra Calls gratuit sur foxera.co.uk. Les nouveaux comptes reçoivent £7 de crédit d'appel gratuit.
- Allez dans vos paramètres développeur et générez une clé d'API. La clé commence par
fxk_et agit uniquement dans votre espace de travail. - Incluez la clé comme jeton bearer dans l'en-tête
Authorizationde chaque requête. - Commencez par ajouter quelques prospects via l'API, puis prévisualisez une campagne pour voir l'effectif et le coût estimé avant d'approuver.
L'API utilise les conventions REST standards : corps de requête et de réponse en JSON, codes de statut HTTP pour les erreurs, et pagination sur les endpoints de liste. Tous les détails sont dans le guide développeur.
Sécurité et flux d'approbation
L'API applique les mêmes règles de sécurité que le tableau de bord et le serveur MCP :
- Effectif confirmé — chaque campagne exige que le nombre exact de prospects soit confirmé avant l'approbation.
- Étape d'approbation séparée — créer une campagne ne démarre pas les appels. Vous devez l'approuver explicitement dans une seconde requête.
- Horaires d'appel — les appels ne sont passés que pendant les horaires que vous configurez. En dehors de ces horaires, la campagne attend.
- Clés limitées — chaque clé d'API fonctionne uniquement dans un espace de travail. Révoquer une clé coupe tout accès immédiatement.
- Journalisation complète — chaque action de l'API est enregistrée avec un horodatage, pour que vous puissiez auditer exactement ce qui s'est passé et quand.
Ces règles sont appliquées côté serveur, quel que soit le client ou le modèle qui appelle l'API. Pour en savoir plus, consultez les garde-fous pour agents IA sur les appels sortants.
Cas d'usage de l'API
L'API est conçue pour les développeurs et les créateurs d'automatisations qui veulent intégrer les appels sortants dans leurs propres systèmes :
- Intégration CRM — envoyez les nouveaux prospects de votre CRM vers FoxEra et récupérez les résultats d'appels, en gardant les deux systèmes synchronisés.
- Plateformes d'automatisation — déclenchez une campagne d'appels depuis n8n, Make ou un webhook Zapier quand un nouveau prospect arrive dans votre pipeline.
- GPT Actions — importez la spécification OpenAPI dans un GPT personnalisé pour qu'il puisse gérer les campagnes de façon conversationnelle.
- Tableaux de bord de reporting — récupérez les données de campagne dans votre propre analyse ou votre CRM d'appels sortants pour un reporting combiné.
- Agents personnalisés — construisez un agent autonome qui recherche des prospects, les ajoute à FoxEra, prévisualise une campagne et demande votre approbation avant de composer.
Si vous préférez une interface conversationnelle plutôt que du code, vous pouvez connecter ChatGPT ou tout autre assistant via le serveur MCP.
Tarification
L'API elle-même est gratuite. Vous ne payez que pour les appels qui se connectent, à partir de 21p par minute connectée, sans abonnement ni frais de plateforme. Les nouveaux comptes démarrent avec £7 de crédit d'appel gratuit.
Chaque aperçu de campagne affiche le coût estimé avant que vous n'approuviez, donc pas de surprises. Comparez cela aux modèles à l'abonnement mensuel sur la page tarifs ou utilisez le calculateur de coût pour estimer une campagne.
Questions fréquentes
Où est hébergée la spécification OpenAPI ?
La spécification se trouve à https://app.foxera.co.uk/api/public/openapi.json. Elle est publique et toujours à jour. Importez-la dans Postman, Swagger UI, ou tout outil qui lit OpenAPI 3.1.
Combien coûte l'utilisation de l'API ?
L'API est gratuite. Vous ne payez que les minutes d'appel connectées, à partir de 21p par minute connectée. Les nouveaux comptes reçoivent £7 de crédit d'appel gratuit.
L'API peut-elle démarrer des appels sans mon approbation ?
Non. Créer une campagne ne démarre pas les appels. Vous devez confirmer l'effectif et envoyer une demande d'approbation séparée. Ceci est appliqué côté serveur.
L'API fonctionne-t-elle avec les GPT Actions ?
Oui. La spécification OpenAPI 3.1 peut être importée directement dans une GPT Action. Votre GPT personnalisé peut alors gérer les prospects, les campagnes et les résultats de façon conversationnelle.