Riferimento API
Live — v1 available now

REST API

Attiva chiamate vocali AI, sincronizza contatti e leggi i risultati delle chiamate da qualsiasi backend, CRM o strumento no-code.

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

Authentication

Generate an API key from Dashboard → Settings → API Keys. Passalo come un Bearer token in ogni richiesta.

Authorization: Bearer oc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Le chiavi sono hashate a riposo e mostrateonly oncealla creazione. Ruota o revoca in qualsiasi momento dalla stessa pagina Impostazioni.

Cosa puoi connettere

L'API è REST semplice + Bearer token, quindi funziona con qualsiasi cosa parli HTTPS — nessun SDK richiesto.

Zapier

Webhooks + HTTP

Attiva chiamate quando un nuovo lead viene aggiunto al tuo CRM, foglio di calcolo o modulo.

Make (Integromat)

Modulo HTTP

Crea flussi di lavoro visivi: Modulo → OutboundCalls → aggiornamento Slack/Email/CRM.

n8n

Nodo richiesta HTTP

Automazione self-hosted. Collega il tuo database, pianificatore o stack di messaggistica.

HubSpot / Salesforce / Pipedrive

CRM

Invia nuovi contatti in una campagna automaticamente; recupera i riepiloghi delle chiamate come registrazioni di attività.

Backend personalizzato (Node, Python, PHP, Go, Ruby)

Qualsiasi linguaggio

Standard REST + Bearer token. Funziona con qualsiasi cosa possa effettuare una chiamata HTTPS.

Piattaforme no-code (Bubble, Retool, Automazioni Airtable)

No-code

Collega l'endpoint a un'azione di flusso di lavoro — nessun SDK necessario.

Flussi di lavoro reali che puoi costruire

Un nuovo lead compila il tuo Typeform → chiamali entro 30 secondi
Booking confirmation in Calendly → AI agent calls 24h before to confirm
Failed Stripe payment → reminder call instead of just an email
Caricamento CSV giornaliero dal tuo CRM → l'agente AI chiama ogni contatto durante l'orario lavorativo
WhatsApp inbound message → callback from voice agent if requested
Il progresso della campagna a lungo termine sincronizzato nel tuo data warehouse ogni 15 minuti

Endpoints

Account

GET/me

Agenti

GET/agents
GET/agents/:id

Contatti

GET/contacts
POST/contacts

Chiamate

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

Campagne

GET/campaigns
GET/campaigns/:id

Altri endpoint (crea/aggiorna/elimina agenti, importazione CSV, controllo campagne) sono in programma. Ne hai bisogno urgentemente?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

Configura un URL webhook su ogni agente. Dopo ogni chiamata, OutboundCalls POSTa un payload JSON firmato al tuo endpoint con:

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

Tutti i payload sono firmati con HMAC-SHA256. Verifica l'intestazione rispetto al segreto webhook del tuo agente.

Spedisci in minuti, non in settimane

Crea un account, genera una chiave API e attiva la tua prima chiamata in meno di 5 minuti.