Ringostat
Zaloguj

Webhooki: wyniki połączeń

~5 min · Kiedy wysyłany jest raport, payload, autoryzacja Basic/OAuth 2.0 i dostarczanie.

Po każdym zakończonym połączeniu Ringostat wysyła raport na Twój URL. Podaj go w kampanii → blok „Webhook i raporty” (albo webhookURL w voiceagent_create_campaign).

„Kiedy wysłać webhook”: all — każde połączenie (domyślnie); answered — tylko odebrane; interaction — połączenia, w których rozmówca nacisnął klawisz lub, w kampaniach z agentem AI, mówił. Numer, który wyczerpał wszystkie próby, jest wysyłany tylko przy all.

Domyślnie to POST z Content-Type: application/json i treścią JSON-RPC 2.0: method zawsze callCompleted, dane połączenia są w params.

POST https://your-app.example/webhooks/ringostat
Content-Type: application/json

{ "jsonrpc":"2.0", "method":"callCompleted", "id":1760437456000000000,
  "params":{ "campaign_id":799, "campaign_name":"Potwierdzanie zamówień",
    "number_id":1001, "phone_number":"+48512345678", "status":"completed",
    "start_time":1760437400, "answered_time":1760437408, "end_time":1760437456,
    "duration":56, "connected_duration":48, "wait_time":8,
    "custom_fields":{"name":"Jan"}, "dtmf_responses":[],
    "voicemail_detected":false, "transferred_to":"",
    "aisdr_final_response":{ … } } }

status: completed, answered, transferred, voicemail, abandoned, failed lub retry. Czas to sekundy Unix, czasy trwania są w sekundach. aisdr_final_response to ustrukturyzowany raport połączenia agenta AI (aisdr); jego klucze wynikają z ustawień raportu kampanii. Numer, który wyczerpał próby, przychodzi ze status failed oraz polami attempt_count i max_attempts. Nagrania nie ma w payload: zwraca je voiceagent_get_call_detail.

W kampaniach z agentem AI payload zawiera też tools: ostatni udany wynik każdego narzędzia, które agent wywołał w rozmowie, pod jego nazwą. W ten sposób do webhooka trafia na przykład numer rezerwacji Servio HMS czy numer utworzonego zamówienia. Nieudane wywołania i odmowy nie są tu uwzględniane; narzędzie, którego nie wywołano, nie ma klucza.

"tools": {
  "servio_create_booking": { "ok": true, "booking_id": "100245",
    "payment_link": "https://pay.example.com/booking?account=100245", … } }

We własnym szablonie treści odwołuj się do nich tak: {{tools.<narzędzie>.<pole>}}. Dodaj ? na końcu, jeśli narzędzie mogło nie zostać wywołane: wtedy pole będzie null, a bez ? webhook takiego połączenia nie zostanie wysłany. Testowe żądanie z panelu nie ma wyników narzędzi: pole z ? będzie tam null, a pole bez ? pokaże wzorzec <sample: tools…>.

{"phone":"{{phone_number}}","booking":"{{tools.servio_create_booking.booking_id?}}",
 "payment":"{{tools.servio_create_booking.payment_link?}}"}

Tak samo działa każde narzędzie integracji. Na przykład list przewozowy Nova Poshta utworzony podczas rozmowy: nova_poshta_create_waybill zwraca ttn, delivery_cost, estimated_delivery_date, warehouse i city.

{"phone":"{{phone_number}}","ttn":"{{tools.nova_poshta_create_waybill.ttn?}}",
 "delivery_date":"{{tools.nova_poshta_create_waybill.estimated_delivery_date?}}"}
Zapytania nie są podpisywane. Aby je uwierzytelnić, wybierz HTTP Basic lub OAuth 2.0 w sekcji „Autoryzacja” bloku „Webhook i raporty” (administratorzy projektu). Tam też zmienisz metodę na PUT lub PATCH i zastąpisz treść własnym szablonem JSON lub form. Webhook z autoryzacją wymaga adresu https i nie podąża za przekierowaniami.
Odpowiedz kodem 2xx w ciągu 30 sekund (20 sekund z Basic lub OAuth 2.0). Nieudane dostarczenie nie jest ponawiane, poza jedną powtórką po OAuth 401. Każda próba jest widoczna w karcie połączenia → „Dostarczenie webhooka”; raport wyślesz ponownie przyciskiem „Wyślij webhook ponownie” lub przez voiceagent_resend_call_webhook. Duplikaty odrzucaj po number_id + end_time.