Authentification
Toutes les requêtes nécessitent un token JWT fourni lors de l'activation de votre compte partenaire. Passez le token dans l'en-tête Authorization.
curl https://api.appel-intelligent.fr/v2/calls \
-H "Authorization: Bearer {votre_token_jwt}" \
-H "Content-Type: application/json"Rotation de clés : Les tokens partenaires expirent au bout de 90 jours. Utilisez le endpoint POST /v2/auth/refresh pour obtenir un nouveau token sans interruption de service.
Base URL
L'API Appel Intelligent est hébergée sur notre infrastructure opérateur-grade avec points de présence en Europe.
https://api.appel-intelligent.fr/v2
Stable
https://sandbox-api.appel-intelligent.fr/v2
Tests & intégration
Appels & sessions
/v2/callsInitie un nouvel appel téléphonique avec suivi en temps réel.
{
"to": "+33612345678",
"from_number": "+33100999887",
"options": {
"record": true,
"transcribe": true,
"agent_id": "ag_9f3b2c1d"
},
"webhook_url": "https://votre-domaine.fr/webhooks/call-ended"
}/v2/calls/{call_id}Récupère le détail d'un appel : métadonnées, transcription, résumé IA.
/v2/calls/{call_id}Termine un appel actif et libère les ressources.
Transcription IA
/v2/transcriptionsDemande une transcription asynchrone d'un fichier audio.
{
"audio_url": "https://storage.appel-intelligent.fr/recordings/rc_7a8b9c0d.mp3",
"language": "fr-FR",
"speaker_labels": true,
"diarization": true
}Retourne un objet transcription avec segments horodatés par interlocuteur.
Traduction temps réel
/v2/translate/streamOuvre un flux WebSocket de traduction simultanée audio → texte.
{
"source_lang": "fr",
"target_lang": "en",
"domain": "business",
"voice_output": false
}Compatible avec les flux audio PCM 16kHz mono. Latence moyenne : 280 ms.
Agent vocal IA
/v2/agentsCrée un agent vocal personnalisé avec prompt système et voix.
{
"name": "Assistant Accueil",
"system_prompt": "Vous êtes un assistant téléphonique professionnel...",
"voice": "claire-fr",
"language": "fr-FR",
"tools": ["appointment_booking", "faq_lookup"],
"max_duration": 600
}/v2/agents/{agent_id}/invokeDéclenche l'agent sur un numéro de téléphone.
Notes & résumés
/v2/summariesGénère un résumé structuré à partir d'une transcription.
{
"transcription_id": "tr_4f5g6h7i",
"format": "structured",
"sections": ["sujet", "actions", "sentiment", "follow_up"]
}Formats disponibles : brief, structured, minutes, crm_ready.
SMS & notifications
/v2/sms/sendEnvoie un SMS via notre infrastructure opérateur.
{
"to": "+33612345678",
"body": "Votre rendez-vous est confirmé pour demain 14h.",
"sender_id": "AppelIntel",
"delivery_report": true
}Tarification à la consultation partenaire. Supporte l'envoi programmé et les modèles de message approuvés.
Webhooks
Configurez des webhooks pour recevoir des événements en temps réel sur vos endpoints sécurisés (HTTPS obligatoire).
Événements disponibles
call.initiatedcall.answeredcall.completedtranscription.doneagent.transfersms.delivered
{
"event": "call.completed",
"timestamp": "2026-07-02T12:34:56Z",
"data": {
"call_id": "ca_8e7d6c5b",
"duration": 247,
"recording_url": "https://...",
"transcription_id": "tr_4f5g6h7i",
"summary_id": "su_1a2b3c4d"
},
"signature": "sha256=abc123..."
}