API și webhook-uri

Conectează isahar Voice cu propriile sisteme

Citește datele contului prin API, adaugă note pe apeluri și trimite cereri de apel către agenți. Prin webhook-uri, propriile aplicații pot primi evenimentele importante imediat ce apar.

Vezi documentația API Intră în cont

Autentificare Basic Auth · Chei cu permisiuni explicite · Răspunsuri JSON

curl -u "key_xxxxx:secretul_tau" \
  https://api.voice.isahar.io/v1/ping

{
  "ok": true,
  "api_version": "v1",
  "tenant_id": "tenant_xxxxx"
}

Începi cu o cheie API

Creezi cheia din panoul de administrare și alegi exact ce poate accesa. La creare primești un ID și un secret. Secretul este afișat o singură dată și nu poate fi recuperat ulterior.

Autentificare prin HTTP Basic Auth
keyId este username
secretul este password
toate request-urile se trimit către https://api.voice.isahar.io

curl -u "key_xxxxx:secretul_tau" \
  https://api.voice.isahar.io/v1/ping

{
  "ok": true,
  "api_version": "v1",
  "tenant_id": "tenant_xxxxx"
}

Deschide documentația interactivă →

Ce poți face prin API

Apeluri, agenți, cozi și numere

Accesezi datele contului fără exporturi manuale și fără acces la baza de date. Toate răspunsurile sunt izolate la nivelul companiei asociate cheii API.

GET /v1/pingGET /v1/callsGET /v1/calls/:idGET /v1/agentsGET /v1/agents/:idGET /v1/queuesGET /v1/queues/:idGET /v1/numbers

Note direct din propriul CRM

Poți adăuga o notă unui apel existent, iar aceasta devine vizibilă și în isahar Voice. Operațiunea necesită permisiunea notes:write și un Idempotency-Key unic.

POST /v1/calls/:call_id/notes

curl -u "key_xxxxx:secretul_tau" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nota-crm-001" \
  -d '{"content":"Clientul dorește să fie contactat mâine."}' \
  https://api.voice.isahar.io/v1/calls/CALL_ID/notes

Nota nu poate fi editată sau ștearsă prin API.

Click-to-dial cu confirmarea agentului

Sistemul tău poate trimite o cerere de apel către un agent disponibil. Agentul vede destinația în aplicație și decide dacă acceptă sau respinge cererea. Apelul nu pornește automat.

POST /v1/agents/:agent_id/dial

curl -u "key_xxxxx:secretul_tau" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: dial-crm-001" \
  -d '{
    "to": "+40700000000",
    "from_number_id": "NUMBER_ID"
  }' \
  https://api.voice.isahar.io/v1/agents/AGENT_ID/dial

Necesită scope-ul calls:dial

Agentul trebuie să fie disponibil

Numărul-sursă trebuie să aparțină contului

Cererea expiră dacă agentul nu răspunde

Apelul real pornește numai după confirmarea agentului

Pentru cererile de scriere, trimite header-ul Idempotency-Key. Folosește aceeași cheie când reîncerci aceeași acțiune, pentru a evita crearea unei note sau a unei solicitări de apel de două ori.

Idempotency-Key: <identificator-unic>

Găsești exact apelurile de care ai nevoie

Lista de apeluri poate fi filtrată și ordonată direct din request, fără să descarci întregul istoric.

fromtodirectionstatusagent_idqueue_idphone_numberpageper_pageorder

curl -u "key_xxxxx:secretul_tau" \
  "https://api.voice.isahar.io/v1/calls?direction=INBOUND&from=2026-08-01T00%3A00%3A00Z&per_page=20&order=desc"

Toate listele sunt paginate
per_page acceptă maximum 200 de rezultate
Răspunsurile includ obiectul meta cu pagina curentă, totalul și pagina următoare

Fiecare cheie primește doar accesul necesar

Citire

calls:readagents:readqueues:readnumbers:read

Scriere

notes:writecalls:dial

Permisiunile de scriere nu sunt acordate implicit. Ele trebuie selectate explicit atunci când cheia este creată. O cheie veche fără scope-uri explicite are doar acces de citire.

Cheile pot fi redenumite

Cheile pot fi revocate

Secretul poate fi rotit

Acțiunile importante sunt păstrate într-un jurnal de audit

Rotația secretului are o perioadă de tranziție, astfel încât integrarea să poată fi actualizată fără întrerupere

Webhooks

Primești evenimentele imediat ce se întâmplă

Înregistrezi unul sau mai multe URL-uri și alegi evenimentele pe care vrei să le primești. Astfel, CRM-ul, dashboardul intern sau sistemul de alerte poate reacționa fără interogări repetate.

call.createdcall.endedcall.missedrecording.ready

Exemplu de payload

{
  "id": "evt_xxxxx",
  "type": "call.ended",
  "version": "1",
  "created_at": "2026-08-24T10:30:00Z",
  "data": {
    "callId": "call_xxxxx",
    "direction": "INBOUND",
    "from": "+40711111111",
    "to": "+40788800000",
    "status": "COMPLETED"
  }
}

Livrare sigură

Fiecare request este semnat cu HMAC-SHA256

Header-ul folosit este X-Isahar-Signature

Formatul semnăturii este t=timestamp,v1=semnatura

Timestamp-ul inclus în semnătură îți permite să respingi livrările prea vechi; recomandăm o toleranță maximă de 5 minute

Sunt efectuate maximum 5 încercări în total: livrarea inițială și 4 reîncercări

Pauza dintre încercări crește progresiv

După eșecuri repetate, webhook-ul este dezactivat și administratorii sunt anunțați prin email

În dashboard există istoric de livrare, livrare de test și reîncercare manuală

Apel terminat↓Webhook semnat↓CRM / dashboard / sistem de alerte

Erori ușor de urmărit

Toate erorile folosesc aceeași structură și includ un request_id pe care îl poți folosi când investighezi o problemă.

{
  "error": {
    "code": "agent_unavailable",
    "message": "Agentul nu este disponibil.",
    "request_id": "req_xxxxx"
  }
}

X-Request-Id este trimis și ca header
Codurile HTTP folosite includ 400, 401, 403, 404, 409, 422, 429 și 500
Resursele din alt cont răspund ca resurse inexistente, fără să dezvăluie existența lor

Limite clare, fără surprize

API-ul aplică limite atât per cheie, cât și per cont, pentru a proteja datele și disponibilitatea serviciului.

Limita generală implicită este de 60 de request-uri pe minut

Click-to-dial are o limită separată, implicit 10 cereri pe minut

Răspunsurile includ headerele X-RateLimit-*

La depășire se răspunde cu 429 și Retry-After

Construiești o integrare cu isahar Voice?

Explorează endpoint-urile, testează request-uri direct din documentație și conectează apelurile la sistemele pe care echipa ta le folosește deja.

Deschide documentația API Contactează-ne

Funcționalități·Integrări·Prețuri