Połączenia

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.

POSThttps://api.telefonia-ai.pl/v1/calls

Parametry

agent_idstring · wymagany

Identyfikator agenta, który poprowadzi rozmowę.

z_numerustring · wymagany

Twój numer w formacie E.164, np. +48220000000.

dostring · wymagany

Numer odbiorcy w formacie E.164.

zmienneobject

Wartości wstawiane do skryptu agenta, np. imię klienta, numer zamówienia.

webhook_urlstring

Adres, na który wyślemy zdarzenia tej rozmowy. Domyślnie adres z ustawień konta.

max_czasinteger · sekundy

Limit długości rozmowy. Domyślnie 600.

Odpowiedź

Zwraca obiekt połączenia ze statusem dzwoni. Kolejne statusy: rozmowa, zakonczona, nieodebrane, blad.

Zdarzenia webhooka

call.started

Odbiorca odebrał połączenie.

call.tool_called

Agent wywołał narzędzie. Odpowiedz w ciągu 5 sekund.

call.ended

Koniec rozmowy z transkrypcją, streszczeniem i kosztem.

cURLPHPNode.jsPython
# Żą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"
}