Przejdź do głównej zawartości
Akcje

Wysyłanie danych połączenia do Twojego systemu

Po każdej rozmowie wyślij podsumowanie, transkrypcję i zebrane dane do swojego CRM, webhooka lub bazy danych.

Wywołanie API po zakończeniu rozmowy wysyła połączenie do Twojego własnego systemu — podsumowanie, transkrypcję, nastrój i wszystko, co zebrał agent. Użyj go, aby utworzyć lead w CRM, uruchomić automatyzację albo prowadzić własne rejestry. Jeśli Twój system jest niedostępny, żądanie zostanie ponowione i nic nie zginie.

Konfiguracja​

  1. Dodaj akcję

    Otwórz agenta → Akcje → Dodaj narzędzie → Post call → Wywołanie API.

  2. Wskaż swój endpoint
    PoleCo wpisać
    Nazwanp. Synchronizacja leadów z CRM
    WarunekKiedy wysyłać, np. jeśli dzwoniący chce kupić. Puste: po każdej rozmowie
    URL endpointu APITwój endpoint, np. https://hooks.example.com/hanc
    Metoda HTTPPOST dla większości systemów; działają też GET, PUT, PATCH, DELETE
    Nagłówki, Parametry zapytaniaOpcjonalne, np. klucz API
  3. Ukształtuj żądanie (opcjonalnie)
    • Treść (JSON) — Twoje własne pola. Wpisz {{, aby wstawić zmienną połączenia, np. {"lead": "{{firstname}} {{lastname}}", "phone": "{{call_from}}"}.
    • Wysyłaj tylko moje pola — pomija standardowe dane połączenia, dla systemu, który przyjmuje tylko własną strukturę.
  4. Zdecyduj, co ma się stać przy błędzie
    • Ponowienia przy błędzie — przerwy przed każdą kolejną próbą, gdy Twój endpoint nie odpowiada kodem 2xx. Domyślnie: 1 min, 5 min, 30 min, 2 godz., 6 godz., 24 godz., 48 godz.
    • Powiadomienie o błędzie — e-mail po ostatniej próbie (domyślnie), po każdej nieudanej próbie albo nigdy. Wyślij do: puste oznacza właściciela konta.

Przycisk Co otrzyma mój endpoint? w edytorze pokazuje dokładne żądanie.

Co otrzymuje Twój endpoint​

Dla POST, PUT i PATCH treść JSON — Twoje pola połączone z polami połączenia:

{
  "id": "6ac7ea6eca60c6024b465c70",
  "agent_id": "6ac2a93e36bad261cf088684",
  "call_from": "+431234567890",
  "call_to": "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "success",
  "start_timestamp": 1730000000000,
  "end_timestamp": 1730000187000,
  "duration": 187000,
  "transcription": [
    { "speaker": "agent", "content": "Hello…", "timestamp": 1730000001000 },
    { "speaker": "user", "content": "Hi…", "timestamp": 1730000003000 }
  ],
  "call_summary": "Customer asked about pricing…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": { "name": "John", "email": "john@example.com" },
  "collected_data": {},
  "transfer_history": [],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

Dla GET i DELETE te same pola trafiają do query stringa, bez pól zagnieżdżonych (transkrypcja, nastrój, zebrane dane).

Każde żądanie zawiera X-Hanc-Delivery-Id — takie samo przy każdej próbie jednego doręczenia, więc możesz pomijać duplikaty — oraz X-Hanc-Attempt z numerem próby. Każda próba wygasa po 30 sekundach. Wszystkie próby są widoczne w CRM → Komunikacja, gdzie nieudane doręczenie można wysłać ponownie. Szczegóły: Webhooki i dostarczanie.

Przykłady zastosowań​

  • Utworzenie leada lub zgłoszenia w Twoim CRM.
  • Uruchomienie automatyzacji no-code z danymi połączenia.
  • Prowadzenie własnego archiwum połączeń.
Na tej stronie