Pro vývojáře

Všechno, co umí rozhraní, umí i váš kód

Veřejné API s ověřením klíčem, podepsané webhooky při ukončení hovoru, zápis aktivity zpět do CRM a server MCP, díky němuž postavíte celý pracovní prostor z Claude nebo ChatGPT.

Stručně

Existuje API pro telefonního agenta?

Ano. Existuje veřejné REST API ověřované klíčem odeslaným v hlavičce Authorization; umožňuje zařadit odchozí hovor do fronty, číst konverzace a přepisy a spravovat agenty, hovorové scénáře i znalostní bázi. Když hovor skončí, na vámi nastavený endpoint dorazí webhook podepsaný HMAC, takže nikdy nemusíte dotazovat systém dokola. Pokud pracujete v Salesforce nebo HubSpotu, systém může hovor zapsat zpět jako dokončenou aktivitu navázanou na lead nebo kontakt. Vše je dostupné i přes vzdálený server MCP, díky němuž klient LLM postaví a obsluhuje pracovní prostor, aniž byste psali kód. Úplná dokumentace, pole po poli a cesta po cestě, je v dokumentaci OpenAPI odkazované z této stránky.

Živá dokumentace

Dokumentace se generuje přímo z kódu, takže vždy odpovídá tomu, co skutečně běží. Cesta, pole nebo chybový kód, který tam vidíte, je to, co server vrací.

Otevřít dokumentaci API

https://server.daber.ai/v1/docs

Veřejné REST API

Ověření klíčem u každého požadavku, snake_case na drátě a scopes na úrovni jednotlivých cest — každý klíč nese definovanou sadu scopes a klíč bez patřičného scope prostě cestu nedostane. Klíč se zobrazí jen jednou při vytvoření; u nás se ukládá pouze jeho otisk.

Zařazení odchozího hovoru do fronty, volitelně navázaného na kampaň, aby se výsledek promítl do jejích ukazatelů
Čtení konverzací: metadata, přepis, shrnutí, sentiment a důvod předání člověku
Správa agentů a hovorových scénářů, včetně vygenerování toku z existujícího dokumentu se scénářem
Zápis do znalostní báze — záznamy vytvořené přes API přicházejí jako koncepty a teprve schválení v rozhraní je zpřístupní k vyhledání
Každá změna agenta či toku je verzovaná, i když přišla přes API — a lze se vrátit zpět

Zařadit odchozí hovor do fronty

Minimální požadavek: id agenta a číslo k vytočení. Hovor vstoupí do fronty a projde stejnou vytáčecí cestou, jakou používají kampaně, takže neexistuje druhá větev kódu, která by se chovala jinak.

curl -X POST https://server.daber.ai/v1/calls \
  -H "Authorization: Bearer dbr_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "3f9c1a52-7b41-4f0e-9c8d-2a5b6e7d8f10",
    "phone": "+972501234567"
  }'

Odpověď vrací id požadavku na hovor. Výsledek — přijato či nepřijato, co bylo řečeno a co shrnuto — dorazí na dokončovacím webhooku, nikoli v odpovědi na tento požadavek.

Webhooky při dokončení

Místo dotazování API až do konce hovoru zaregistrujete endpoint a událost přijde k vám. Každý požadavek nese podpis HMAC-SHA256 nad časovým razítkem a tělem — jeho ověření na vaší straně je rozdíl mezi endpointem a endpointem, který může krmit kdokoli.

Události životního cyklu hovoru objednaného přes API: zařazen do fronty, dokončen, selhal
Událost dokončení konverzace pro každou ukončenou hlasovou konverzaci, nejen pro ty objednané přes API
Podpis putuje ve vyhrazené hlavičce a obsahuje časové razítko, takže můžete odmítnout staré opakované doručení
Tajemství lze v nastavení zobrazit a vyměnit a záznam doručení uchovává poslední pokusy pro každý endpoint

Kam dokončený hovor putuje dál

Dokončený hovor je záznamem nejméně ve dvou systémech — v našem a ve vašem. Dva způsoby, jak tuto mezeru uzavřít bez ručně psané synchronizace.

Zápis aktivity do CRM

Pokud hovor není v CRM, pro obchodníka se nestal. Po dokončení může systém vytvořit dokončenou aktivitu v Salesforce nebo HubSpotu, navázanou na správný lead či kontakt a přiřazenou jeho vlastníkovi, se shrnutím a výsledkem. Selhání zápisu do CRM nikdy neshodí samotný hovor — zaznamená se a zobrazí, a konverzace u nás zůstane neporušená.

Vzdálený server MCP

Totéž API vystavené jako server MCP — pracovní prostor tak můžete připojit ke klientovi LLM, jako je Claude nebo ChatGPT, a stavět jej v konverzaci: převést dokument se scénářem na hovorový tok, vytvořit agenta, navázat na něj tok a modely, přidat záznamy do znalostní báze a zavolat testovací hovor. Ověření probíhá stejným klíčem API a klientovi se nabízejí jen nástroje, které scopes daného klíče dovolují — klient LLM nikdy nedostane víc, než dostane klíč, který drží.

Než půjdete do produkce

Ostrý klíč je tajemství jako každé jiné: zobrazí se jednou a nikdy se neodesílá z prohlížeče
Platí omezení frekvence na klíč a zjištěná záplava vytáčení může klíč automaticky pozastavit — pozastavení lze v nastavení zrušit
Ověření podpisu webhooku na vaší straně je povinné, ne volitelné
Shrnutí a sentiment se zapisují až po skončení hovoru, nikoli v okamžiku zavěšení — proto přicházejí webhookem a ne v odpovědi na požadavek k vytočení

Zavolejte AI agentovi

Skutečný hovor, v hebrejštině. Přesně to, co uslyší vaši volající.

Nechte si zavolat od AI agenta

Zanechte číslo — agent zavolá do minuty.