Référence API
Live — v1 available now

REST API

Déclenchez des appels vocaux AI, synchronisez des contacts et lisez les résultats des appels depuis n'importe quel backend, CRM ou outil sans code.

Base URL:https://outboundcalls.ai/api/v1

Authentication

Generate an API key from Dashboard → Settings → API Keys. Passez-le en tant que token Bearer à chaque requête.

Authorization: Bearer oc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Les clés sont hachées au repos et affichéesonly onceà la création. Faites tourner ou révoquez à tout moment depuis la même page de paramètres.

Ce que vous pouvez connecter

L'API est un REST simple + token Bearer, donc elle fonctionne avec tout ce qui parle HTTPS — aucun SDK requis.

Zapier

Webhooks + HTTP

Déclenchez des appels lorsqu'un nouveau prospect est ajouté à votre CRM, feuille de calcul ou formulaire.

Make (Integromat)

Module HTTP

Créez des workflows visuels : Formulaire → OutboundCalls → mise à jour Slack/Email/CRM.

n8n

Nœud de requête HTTP

Automatisation auto-hébergée. Connectez votre base de données, planificateur ou pile de messagerie.

HubSpot / Salesforce / Pipedrive

CRM

Ajoutez automatiquement de nouveaux contacts dans une campagne ; récupérez les résumés d'appels en tant qu'enregistrements d'activité.

Backend personnalisé (Node, Python, PHP, Go, Ruby)

N'importe quelle langue

REST standard + jeton Bearer. Fonctionne avec tout ce qui peut effectuer un appel HTTPS.

Plateformes sans code (Bubble, Retool, Automatisations Airtable)

Sans code

Branchez le point de terminaison dans une action de workflow — pas de SDK nécessaire.

Des workflows réels que vous pouvez créer

Un nouveau lead remplit votre Typeform → appelez-le dans les 30 secondes
Booking confirmation in Calendly → AI agent calls 24h before to confirm
Failed Stripe payment → reminder call instead of just an email
Téléchargement quotidien de CSV depuis votre CRM → l'agent IA appelle chaque contact pendant les heures d'ouverture
WhatsApp inbound message → callback from voice agent if requested
Progrès de campagne longue durée synchronisés dans votre entrepôt de données toutes les 15 minutes

Endpoints

Compte

GET/me

Agents

GET/agents
GET/agents/:id

Contacts

GET/contacts
POST/contacts

Appels

POST/calls
GET/calls
GET/calls/:id

Campagnes

GET/campaigns
GET/campaigns/:id

D'autres points de terminaison (créer/mettre à jour/supprimer des agents, importation CSV, contrôle de campagne) sont sur la feuille de route. En avez-vous besoin de toute urgence ?Tell us.

Code examples

cURL
# Trigger an outbound call from your agent
curl -X POST https://outboundcalls.ai/api/v1/calls \
  -H "Authorization: Bearer oc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "clxAGENT123",
    "toNumber": "+14155551212",
    "contactId": "clxCONTACT456"
  }'

# Response
{
  "id": "clxCALL789",
  "phoneFrom": "+12025550100",
  "phoneTo": "+14155551212",
  "status": "RINGING",
  "elevenlabsConvId": "conv_abc...",
  "createdAt": "2026-04-29T10:32:11.000Z"
}
JavaScript / Node.js
// Trigger a call from any Node.js / browser app
const r = await fetch('https://outboundcalls.ai/api/v1/calls', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.OC_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    agentId: 'clxAGENT123',
    toNumber: '+14155551212',
  }),
});
const call = await r.json();
console.log(call.id, call.status); // RINGING

// Later — fetch transcript & summary
const detail = await fetch(`https://outboundcalls.ai/api/v1/calls/${call.id}`, {
  headers: { Authorization: `Bearer ${process.env.OC_API_KEY}` },
}).then(r => r.json());
console.log(detail.summary, detail.transcript);

Post-call webhook

Configurez une URL webhook sur chaque agent. Après chaque appel, OutboundCalls POSTe un payload JSON signé à votre point de terminaison avec :

  • Full transcript
  • Recording URL
  • AI-generated summary
  • Sentiment score
  • Goal achieved (true/false)
  • Extracted data fields
  • Duration + credits charged
  • Voicemail flag

Tous les payloads sont signés avec HMAC-SHA256. Vérifiez l'en-tête par rapport au secret webhook de votre agent.

Expédiez en quelques minutes, pas en semaines

Créez un compte, générez une clé API et déclenchez votre premier appel en moins de 5 minutes.