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 |
call.message_status | Co operator ostatecznie zgłosił o SMS-ie wysłanym przez agenta: status (delivered, failed lub unconfirmed), reason |
alert.triggered | Jeden z Twoich alertów (Webhooki i powiadomienia → Alerty) przekroczył próg |
alert.resolved | Ten alert wrócił do normy |
conversation.created | W skrzynce zaczęła się rozmowa: conversation |
conversation.message | Do rozmowy dodano wiadomości: conversation, messages (role, content, via) |
conversation.updated | Rozmowa zmieniła prowadzącego lub status (także rozwiązana): conversation, changes |
conversation.needs_human | Rozmowa czeka na członka zespołu: conversation, reason |
conversation.closed | Rozmowa została rozwiązana: conversation |
conversation.unanswered_timeout | Rozmowa czekała na zespół tak długo, jak pozwala przepływ „Zespół nie odpowiedział”: conversation, minutes |
contact.created | Dodano nowego klienta: contact_id |
contact.updated | Zmieniły się dane klienta: contact_id, fields |
contact.consent_changed | Zmieniła się zgoda klienta: contact_id, kind, status, source |
contact.merged | Połączono dwóch klientów: contact_id (zachowany), from_id |
appointment.created | W kalendarzu zarezerwowano wizytę: przez agenta, Twój zespół, API lub formularz rezerwacji (status booked lub waitlisted): appointment |
appointment.updated | Zmienił się stan, notatki lub usługa wizyty: appointment, previous_status |
workflow.webhook | Workflow doszedł do kroku Wyślij do webhooka: name, workflow, conversation, contact, answers |
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.