API INFYNIA v1
Faites travailler vos agents vocaux depuis votre propre code
L'API INFYNIA lance des appels sortants avec vos agents, vous laisse suivre leur résultat et envoie des événements à vos systèmes par webhook. Une clé d'API par organisation, du JSON sur HTTPS, aucun SDK à installer.
À quoi sert l'API
Lancer et suivre des appels
Déclenchez un appel sortant depuis votre CRM ou votre back-office, puis lisez son statut, sa durée et les données collectées.
Réagir aux événements
Recevez des webhooks signés quand un appel démarre, se termine ou obtient sa transcription, et quand un agent change. Les livraisons en échec sont relancées.
Maîtriser les accès
Créez des clés par organisation avec des scopes, limitez-les à certains agents, renouvelez-les avec 24 heures de chevauchement.
Démarrage en 5 minutes
Il vous faut un compte INFYNIA sur un plan qui autorise les clés live, et un agent actif.
Créer une clé d'API
Dans le dashboard, ouvrez
Développeurs, puisClés, et créez une clé avec les scopesagents:readetcalls:write. La clé n'est affichée qu'une fois : rangez-la dans une variable d'environnementINFYNIA_API_KEY.Lister vos agents
Vérifiez que la clé fonctionne et repérez l'
idde l'agent qui passera l'appel.curl https://infynia.quantylcore.com/api/v1/agents \ -H "Authorization: Bearer $INFYNIA_API_KEY"Lancer un appel
Envoyez l'identifiant de l'agent et le numéro à appeler au format E.164. L'en-tête
Idempotency-Keypermet de réessayer sans risque. La réponse est201quand l'appel est lancé,202quand il est planifié.curl -X POST https://infynia.quantylcore.com/api/v1/calls \ -H "Authorization: Bearer $INFYNIA_API_KEY" \ -H "Idempotency-Key: order-1042-callback" \ -H "Content-Type: application/json" \ -d '{"agentId": "AGENT_ID", "to": "+15555550100"}'Recevoir les événements
Ajoutez un point de terminaison dans
Développeurs, puisWebhooks, et vérifiez la signature de chaque livraison. Le guide des webhooks contient des récepteurs complets en Node.js et en Python.