Utwórz połączenie
Inicjuje połączenie wychodzące: agent dzwoni z Twojego numeru na wskazany numer i prowadzi rozmowę według swojej konfiguracji. Status zmian dostajesz przez webhook.
Parametry
agent_idstring · wymaganyIdentyfikator agenta, który poprowadzi rozmowę.
z_numerustring · wymaganyTwój numer w formacie E.164, np. +48220000000.
dostring · wymaganyNumer odbiorcy w formacie E.164.
zmienneobjectWartości wstawiane do skryptu agenta, np. imię klienta, numer zamówienia.
webhook_urlstringAdres, na który wyślemy zdarzenia tej rozmowy. Domyślnie adres z ustawień konta.
max_czasinteger · sekundyLimit długości rozmowy. Domyślnie 600.
Odpowiedź
Zwraca obiekt połączenia ze statusem dzwoni. Kolejne statusy: rozmowa, zakonczona, nieodebrane, blad.
Zdarzenia webhooka
call.startedOdbiorca odebrał połączenie.
call.tool_calledAgent wywołał narzędzie. Odpowiedz w ciągu 5 sekund.
call.endedKoniec rozmowy z transkrypcją, streszczeniem i kosztem.
# Żądanie curl https://api.telefonia-ai.pl/v1/calls \ -H "Authorization: Bearer $KLUCZ" \ -H "Content-Type: application/json" \ -d '{ "agent_id": "recepcja-01", "z_numeru": "+48220000000", "do": "+48600000000", "zmienne": { "imie": "Anna" } }' # Odpowiedź 201 { "id": "call_8Kq2xL", "status": "dzwoni", "agent_id": "recepcja-01", "utworzono": "2026-11-17T14:02:11Z" } # Webhook call.ended { "typ": "call.ended", "czas_s": 142, "koszt_zl": 0.95, "streszczenie": "Umówiono wizytę wt 16:30" }