Dodaj adres https w Integracje → Webhooki i powiadomienia, aby otrzymywać zdarzenia połączeń:
| Zdarzenie | Kiedy |
|---|---|
call.started | Agent odebrał |
call.ended | Połączenie się zakończyło, z czasem trwania i kredytami |
call.analyzed | Gotowe są podsumowanie, wynik, wyodrębnione pola i transkrypcja |
call.transcript | W trakcie połączenia, nowe wiersze transkrypcji co kilka sekund |
call.tool_called | Agent wywołał jedną z Twoich funkcji: name, arguments, status, durationMs |
call.handed_off | Połączenie przekazano innemu agentowi: fromAgentId, toAgentId |
call.transferred | Połączenie przekierowano do człowieka: destination |
call.voicemail | Połączenie wychodzące trafiło na pocztę głosową |
call.do_not_call | Osoba w połączeniu wychodzącym poprosiła, by więcej do niej nie dzwonić: phone |
call.recording_ready | Dwukanałowe nagranie zapisane: recordingUrl (ważny 24 godziny), durationMs |
call.message_sent | Agent pokazał karty na ekranie rozmówcy z weba lub aplikacji: items, quickReplies |
alert.triggered | Jeden z Twoich alertów (Webhooki i powiadomienia → Alerty) przekroczył próg |
alert.resolved | Ten alert wrócił do normy |
Zdarzenia wysyłane w trakcie połączenia niosą data.call (id, agentId, channel, direction, numery). Każde żądanie jest podpisane:
EvaSay-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
EvaSay-Delivery: <delivery id>
Zweryfikuj podpis sekretem webhooka pokazanym przy jego tworzeniu i odpowiedz statusem 2xx. Nieudane dostarczenia są ponawiane po 1 minucie, 5 minutach, 30 minutach, 2 godzinach i 12 godzinach z tą samą treścią i tym samym identyfikatorem EvaSay-Delivery, więc powtórzenia możesz ignorować. Ostatnie dostarczenia webhooka, z dokładną wysłaną treścią i statusem, jaki zwrócił Twój endpoint, wyświetla GET /webhooks/{id}/deliveries oraz panel; POST /webhooks/{id}/deliveries/{delivery_id} wysyła jedno z nich ponownie.
Oprócz e-maila i webhooków alert.triggered / alert.resolved alerty mogą trafiać na kanał Slack (incoming webhook), do bota grupowego WeCom lub na Telegram w Webhooki i powiadomienia → Alerty → Wysyłaj też do.
Utwórz webhook przez POST /webhooks z { "url": "https://crm.example.com/evasay-events", "events": ["call.analyzed"] }. Odpowiedź zawiera subskrypcję i wygenerowany sekret podpisu, zwracany tylko przy utworzeniu. Zweryfikuj EvaSay-Signature, deduplikuj po EvaSay-Delivery i zaktualizuj swój CRM. Webhooki zdarzeń to powiadomienia asynchroniczne; narzędzia w trakcie połączenia zwracają wyniki bezpośrednio agentowi.