Webhooki: wyniki połączeń
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?}}"}