API-referencia
Live — v1 available now

REST API

Indítson AI-alapú hanghívásokat, szinkronizálja a kontaktokat, és olvassa ki a híváseredményeket bármely backendből, CRM-ből vagy no-code eszközből.

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

Authentication

Generate an API key from Dashboard → Settings → API Keys. Adja meg Bearer tokenként minden kérésnél.

Authorization: Bearer oc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

A kulcsokat hash-elve tároljuk, és csakonly oncea létrehozáskor jelenítjük meg. Bármikor rotálhatja vagy visszavonhatja őket ugyanazon a Beállítások oldalon.

Amit csatlakoztathat

Az API egyszerű REST + Bearer token alapú, így bármivel működik, ami HTTPS-en kommunikál — SDK nem szükséges.

Zapier

Webhookok + HTTP

Indítson hívásokat, amikor új lead kerül a CRM-be, táblázatba vagy űrlapba.

Make (Integromat)

HTTP-modul

Építsen vizuális munkafolyamatokat: űrlap → OutboundCalls → Slack/e-mail/CRM-frissítés.

n8n

HTTP-kérés csomópont

Saját üzemeltetésű automatizálás. Csatlakoztassa adatbázisát, ütemezőjét vagy üzenetküldési rendszerét.

HubSpot / Salesforce / Pipedrive

CRM

Automatikusan küldje az új kontaktokat egy kampányba, a hívásösszefoglalókat pedig tevékenységrekordként kérje le.

Egyedi backend (Node, Python, PHP, Go, Ruby)

Bármely programnyelv

Szabványos REST + Bearer token. Minden olyan rendszerrel működik, amely HTTPS-hívást tud indítani.

No-code platformok (Bubble, Retool, Airtable Automations)

No-code

Illessze be a végpontot egy munkafolyamat-műveletbe — SDK nélkül.

Valódi munkafolyamatok, amelyeket felépíthet

Egy új lead kitölti a Typeform-űrlapot → hívja fel 30 másodpercen belül
Booking confirmation in Calendly → AI agent calls 24h before to confirm
Failed Stripe payment → reminder call instead of just an email
Napi CSV-feltöltés a CRM-ből → az AI-ügynök munkaidőben felhívja az összes kontaktot
WhatsApp inbound message → callback from voice agent if requested
A hosszú ideig futó kampány előrehaladása 15 percenként szinkronizálódik az adattárházába

Endpoints

Fiók

GET/me

Ügynökök

GET/agents
GET/agents/:id

Kontaktok

GET/contacts
POST/contacts

Hívások

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

Kampányok

GET/campaigns
GET/campaigns/:id

További végpontok (ügynökök létrehozása/frissítése/törlése, CSV-import, kampányvezérlés) szerepelnek a fejlesztési tervben. Sürgősen szüksége van valamelyikre?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

Állítson be webhook URL-t minden ügynöknél. Minden hívás után az OutboundCalls POST-kéréssel aláírt JSON-payloadot küld az Ön végpontjára, amely tartalmazza:

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

Minden payload HMAC-SHA256 aláírással van ellátva. Ellenőrizze a fejlécet az ügynök webhook-titkos kulcsával.

Vigye élesbe percek alatt, ne hetek alatt

Hozzon létre fiókot, generáljon API-kulcsot, és indítsa el első hívását kevesebb mint 5 perc alatt.