Pour les développeurs

La voix IA dans votre produit, en un appel d'API

API REST et webhooks pour que les assistants vocaux AI4CALL appellent, répondent et agissent dans vos systèmes. Spécification OpenAPI, exemples prêts à copier, aucun SDK à installer.

Essai gratuit avec crédit de départ inclus.

  • REST · JSON
  • OpenAPI 3.0.3
  • HTTPS / TLS
  • /api/v1
# Faites appeler un prospect par votre assistant IA
curl -X POST https://client-api.ai4call.com/webhook/outbound_call \
  -H "x-client-email: you@company.com" \
  -H "x-portal-api-key: $AI4CALL_PORTAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistantApiKey": "ast_xxx",
    "to": "+39081...",
    "from": "+3902...",
    "metadata": { "lead_id": "123" }
  }'
POST /webhook/outbound_call · l'assistant compose le numéro et reçoit vos metadata
Anatomie d'un appel

Là où votre code intervient

Un appel, couche par couche : la voix n'est que la première. Chaque ligne est un point où votre code peut intervenir.

En cours Entrant · Ligne rendez-vous · Assistant IA 00:00 Démo
Agent IA

Cabinet Bianchi, bonjour Marco. Comment puis-je vous aider ?

Voix
Compréhension
Intention · reportLLM Proposition · 2 optionsLLM
Connaissances
Règles de reportRAG
Systèmes
Appelant reconnu · Marco R.pre-call Agenda · disponibilitésMCP Résultat envoyé à votre endpointhangup
Actions
Rendez-vous déplacé · ven. 9h30tool
Opérateur
Opérateur disponible · transfert à tout momentredirect
  1. 1

    Avant de répondre

    Votre serveur reçoit le numéro de l'appelant, l'identifie et enrichit le prompt avec les données client.

    webhook pré-appel
  2. 2

    Pendant la conversation

    Le LLM répond grâce à la base de connaissances et appelle vos outils dès qu'il a besoin de données ou d'actions.

    outils HTTP · MCP · RAG
  3. 3

    À la fin de l'appel

    Transfert, redirection ou clôture. L'IA extrait les champs que vous définissez et les envoie en POST à votre URL de raccrochage.

    webhook de raccrochage
  4. 4

    Ensuite

    Historique des appels, consommations, événements outils et SMS à intégrer dans votre CRM, data warehouse ou BI.

    /account/analytics/*

Exemple : webhook pré-appel

AI4CALL envoie un POST à votre endpoint. Répondez avec enable pour accepter ou refuser l'appel, et avec callerInfo pour donner du contexte à l'assistant : les champs sont ajoutés au system prompt.

Spécification complète du webhook pré-appel →
Requête vers votre serveur
POST https://yourserver.com/api/verify-caller
Content-Type: application/json

{
  "number": "+393331234567",
  "timestamp": "2025-12-13T10:30:00Z",
  "assistantId": "ast_abc123",
  "callId": "call_xyz789"
}
Votre réponse
{
  "enable": true,
  "callerInfo": {
    "name": "Mario",
    "surname": "Rossi",
    "custom_field_1": "VIP since 2020"
  }
}
Points d'intégration

Cinq façons de connecter AI4CALL à votre code

N'utilisez que ce dont vous avez besoin : d'un simple webhook à l'automatisation complète de la plateforme.

REST · OpenAPI 3

API REST de la plateforme

Créez et configurez assistants, prompts, voix TTS/ASR/LLM, bases de connaissances RAG, outils et analytics. Tout ce que vous faites dans le portail, en code.

Webhook

Appels sortants

Un POST depuis votre backend et l'assistant appelle votre client, via le trunk AI4CALL ou votre PBX. Transmettez des metadata (lead, ticket, commande) et retrouvez-les dans les analytics.

Webhook entrant

Webhook pré-appel

Avant que l'assistant ne réponde, AI4CALL appelle votre endpoint avec le numéro de l'appelant. Vous décidez d'accepter l'appel et du contexte à donner à l'IA.

Function calling · MCP

Outils et serveurs MCP

Pendant l'appel, l'assistant invoque vos API : recherche client, ouverture de ticket, suivi de commande. Authentification Bearer, API Key ou OAuth2, ou votre propre serveur MCP.

SIP · FreePBX

Téléphonie : trunk SIP et PBX

Reliez l'assistant à votre standard via un trunk SIP ou le module FreePBX, en conservant vos numéros et votre routage.

API + portail

Le portail reste toujours à votre disposition

L'API ne remplace pas le portail AI4CALL : elle le complète, avec la même logique. Vous automatisez uniquement ce dont vous avez besoin et gardez l'interface graphique pour le reste, sans développer votre propre back-office.

Un flux typique : l'équipe configure et affine l'assistant dans le portail, le développeur intègre appels sortants, webhooks et analytics via API.

  • Prompts, voix, modèles, outils et base de connaissances configurables depuis l'interface
  • Tableau de bord avec historique des appels, consommations et recharges
  • Numéros, utilisateurs et profils de votre équipe
  • Marketplace de plugins et notifications
Quickstart

De l'inscription à la première réponse en quelques minutes

Pas de SDK, pas de dépendances : un simple client HTTP suffit.

  1. Créez votre compte

    Inscrivez-vous sur le portail et créez votre premier assistant. L'essai inclut du crédit pour les appels de test.

    Aller au portail →
  2. Générez la portalApiKey

    Créez une clé par environnement (test, production) dans le portail. Elle s'envoie dans les en-têtes avec votre e-mail.

    Comment générer la clé API →
  3. Faites votre première requête

    Listez vos assistants pour récupérer l'assistantApiKey, puis lancez un appel sortant ou configurez prompt et voix.

terminal
curl https://client-api.ai4call.com/api/v1/assistants \
  -H "x-client-email: you@company.com" \
  -H "x-portal-api-key: $AI4CALL_PORTAL_KEY"
Réponse : la liste de vos assistants en JSON
Carte des endpoints

Toute la plateforme, via API

Les principaux domaines exposés par client-api.ai4call.com. Requêtes, réponses et erreurs sont documentées dans Swagger.

Assistants et prompts

GET · POST /api/v1/assistants GET · PATCH /api/v1/assistants/{key}/prompt

Voix : TTS, ASR, LLM, DTMF

PATCH /api/v1/assistants/{key}/runtime/{tts|asr|llm|dtmf} GET /api/v1/catalog/providers/tts

Base de connaissances RAG

/api/v1/catalog/rag/… PATCH /api/v1/assistants/{key}/runtime/rag

Outils

GET /api/v1/catalog/tools PATCH /api/v1/assistants/{key}/runtime/tools

Pré-appel

/api/v1/assistants/{key}/runtime/precall/number-validation /api/v1/assistants/{key}/runtime/precall/mcp-config

Raccrochage et post-appel

PATCH /api/v1/assistants/{key}/runtime/hangup …/runtime/hangup/save-conversation · /schema

Appels sortants

POST /webhook/outbound_call POST /webhook/outbound_call_pbx

Analytics

GET /api/v1/account/analytics/calls …/calls-outbound · /recharges · /tool-responses

Compte et sécurité

GET · PATCH /api/v1/account/allowed-ips GET · PATCH /api/v1/account/call-limits
Choix des modèles

Vous choisissez le LLM, la voix et la transcription

Aucun verrouillage fournisseur : pour chaque assistant, choisissez le modèle le plus adapté en qualité, coût, latence et exigences de confidentialité. Et changez-le quand vous voulez, y compris via API.

LLM

20 provider
  • OpenAI
  • OpenAI EU
  • Anthropic
  • Google
  • Mistral
  • Azure OpenAI
  • Azure Foundry · API Key
  • Azure Foundry · Entra ID
  • Vertex AI
  • AWS Bedrock
  • xAI
  • OpenRouter
  • DeepInfra
  • IONOS
  • Nebius
  • OVHcloud
  • Perplexity
  • Scaleway
  • Together AI
  • Ollama

Voix temps réel (audio-to-audio)

2 provider
  • Google Gemini realtime
  • OpenAI realtime

Synthèse vocale (TTS)

5 provider
  • Azure
  • ElevenLabs
  • Google
  • KugelAudio
  • Mistral

Transcription (ASR)

3 provider
  • Azure
  • Mistral
  • OpenAI Whisper
GDPR

Un pipeline adapté aux exigences du RGPD

Le lieu de traitement des données d'un appel dépend aussi des modèles utilisés. Avec AI4CALL, vous composez le pipeline selon vos exigences de confidentialité et celles de vos clients.

Fournisseurs européens

Mistral, IONOS, OVHcloud et Scaleway, ou les modèles OpenAI servis depuis l'endpoint européen (OpenAI EU).

Votre cloud, votre région

Azure OpenAI, Azure Foundry, Vertex AI et AWS Bedrock avec vos propres identifiants : les modèles tournent dans votre compte, dans la région que vous configurez.

Auto-hébergé

Reliez Ollama à votre endpoint privé ou on-premise et gardez l'inférence LLM sur votre infrastructure.

Le fournisseur et le modèle de chaque assistant se changent aussi via API, sans passer par le portail :

PATCH /api/v1/assistants/{key}/runtime/llm
BYOK · Bring Your Own Key

Utilisez vos propres clés fournisseur

Avec BYOK, vous connectez à AI4CALL les identifiants de votre compte chez le fournisseur (clé API, service account, clés IAM ou token) à la place de ceux d'AI4CALL. Les requêtes aux modèles partent de votre compte et le fournisseur vous les facture directement.

Vous payez directement le fournisseur

La consommation du composant utilisé avec votre clé (LLM, voix ou transcription) ne débite pas votre crédit de recharge AI4CALL.

Aucune marge sur les volumes

À fort volume, c'est l'option la plus économique : vous payez les tarifs de votre contrat avec le fournisseur, sans majoration.

La relation fournisseur vous appartient

Compte, région et accord de traitement des données (DPA) se gèrent directement entre vous et le fournisseur : un atout de plus pour le RGPD.

Plus de modèles disponibles

Certains fournisseurs ne s'utilisent qu'avec vos propres identifiants, par exemple Anthropic, Google Gemini, OpenRouter, Vertex AI et AWS Bedrock.

Prêt pour la production

Conçu pour la production, pas seulement pour les démos

Authentification à deux niveaux

E-mail et portalApiKey dans les en-têtes pour le compte, assistantApiKey dans le chemin pour un assistant. HTTPS uniquement.

Liste blanche d'IP

Limitez l'accès à l'API à vos serveurs en gérant la liste via /account/allowed-ips.

Limites d'appels

Consultez et ajustez les appels simultanés et par période avec /account/call-limits.

Versioning stable

Endpoints sous /api/v1. Les changements non rétrocompatibles arriveront dans une nouvelle version majeure, avec une période de transition.

Données en Europe

Serveurs en Europe et conformité RGPD. Health check public sur GET /health pour votre monitoring.

Questions des développeurs

Oui. Le plan Trial inclut un crédit de départ pour les appels de test. Pour séparer test et production, utilisez des identifiants dédiés ; si vous avez besoin d'un compte de test supplémentaire, contactez-nous depuis le portail.

L'API est en REST/JSON standard décrite en OpenAPI 3.0.3 : elle fonctionne avec n'importe quel client HTTP. Depuis Swagger, téléchargez openapi.yaml et générez un client typé avec des outils comme OpenAPI Generator.

Définissez les propriétés à extraire (ex. email_client, resultat) et une URL de raccrochage : à la fin de l'appel, vous recevez un POST avec les données extraites. Vous pouvez aussi recevoir la transcription complète par e-mail.

Oui, grâce aux outils personnalisés : définissez endpoint, méthode HTTP, paramètres et authentification (Bearer, API Key, OAuth2) et l'IA les invoque au besoin. Pour des intégrations plus structurées, connectez votre propre serveur MCP.

La contrainte principale est le nombre d'appels simultanés et par période prévu par votre plan, consultable et ajustable via /account/call-limits. Pour de gros volumes, contactez-nous pour un plan dédié.

La consommation dépend de votre plan (à l'usage ou avec minutes incluses). Avec les plans Trial et Freedom, vous pouvez utiliser vos propres clés API pour les LLM et les voix et payer directement le fournisseur. Détails sur la page tarifs.

Tous les endpoints métier sont versionnés sous /api/v1/. Les éventuels breaking changes arriveront en /api/v2/, la v1 restant active pendant la transition.

Oui. Vous pouvez choisir des fournisseurs européens (Mistral, IONOS, OVHcloud, Scaleway), l'endpoint européen d'OpenAI, vos comptes Azure, Vertex AI ou AWS Bedrock dans la région de votre choix, ou un modèle auto-hébergé avec Ollama. L'évaluation finale de conformité revient au responsable du traitement : contactez-nous pour les cas spécifiques.

Commencez à construire dès aujourd'hui

Créez votre compte, générez votre clé et passez votre premier appel IA depuis votre code. Projet complexe ? Parlons-en avec notre équipe technique.


Quelques utilisateurs d'ai4call
AI4Call Demo

Chiama e prova la qualità dei nostri assistenti A.I.