.png)
Webhook - Wygenerowana transkrypcja i podsumowanie
Webhooki informują o zakończeniu procesu generowania transkrypcji lub podsumowania i automatycznie wysyłane są do wskazanego systemu zewnętrznego. Dzięki nim integracje mogą natychmiast reagować na dostępność nowych danych, bez konieczności cyklicznego odpytywania API. Webhook zawiera informacje pozwalające jednoznacznie powiązać podsumowanie z konkretnym połączeniem oraz pobrać jego treść poprzez EAPI. Rozwiązanie to usprawnia przepływ danych i umożliwia automatyzację procesów opartych na analizie rozmów.
Struktura webhooka – wygenerowana transkrypcja
{
"eventName":"TranscriptionCreated",
"fccInstance":"domena",
"customerId":0000,
"version":1,
"createdAt":"2025-11-21T13:09:24+01:00",
"data":
{
"calls_id":136,
"date_time":"2025-11-21T13:09:24+01:00",
"campaigns_id":5
}
}
Opis pól webhooka
| Pole | Opis |
|---|---|
| eventName | Nazwa zdarzenia webhooka informująca o wygenerowaniu transkrypcji |
| fccInstance | Domena / identyfikator instancji Welyo, z której pochodzi powiadomienie |
| customerId | Identyfikator klienta w systemie Welyo |
| version | Wersja struktury webhooka |
| createdAt | Data i godzina wygenerowania powiadomienia |
| data | Obiekt zawierający szczegóły dotyczące wygenerowanej transkrypcji |
Opis pól w sekcji data
| Pole | Opis |
|---|---|
| calls_id | Identyfikator połączenia, dla którego została wygenerowana transkrypcja |
| date_time | Data i godzina wygenerowania transkrypcji |
| campaigns_id | Identyfikator kampanii, w której obsługiwane było połączenie (pole może być puste, jeśli połączenie było poza kampanią) |
ℹ️ Jak pobrać treść transkrypcji?
Wystarczy wywołać akcję EAPI pobierania transkrypcji, przekazując otrzymane calls_id.
⚠️ Dlaczego treść nie jest wysyłana w webhooku?
Transkrypcja może być bardzo długa. Umieszczenie jej bezpośrednio w webhooku mogłoby:
- znacząco wydłużyć czas generowania powiadomienia,
- spowodować problemy z przetwarzaniem po stronie systemu odbierającego.
Struktura webhooka – wygenerowane podsumowanie
{
"eventName":"SummaryCreated",
"fccInstance":"domena",
"customerId":0000,
"version":1,
"createdAt":"2025-11-21T13:11:14+01:00",
"data":
{
"calls_id":136,
"date_time":"2025-11-21T13:11:14+01:00",
"campaigns_id":5
}
}
Opis pól webhooka
| Pole | Opis |
|---|---|
| eventName | Nazwa zdarzenia webhooka informująca o wygenerowaniu podsumowania |
| fccInstance | Domena / identyfikator instancji Welyo, z której pochodzi powiadomienie |
| customerId | Identyfikator klienta w systemie Welyo |
| version | Wersja struktury webhooka |
| createdAt | Data i godzina wygenerowania powiadomienia |
| data | Obiekt zawierający szczegóły dotyczące wygenerowanego podsumowania |
Opis pól w sekcji data
| Pole | Opis |
|---|---|
| calls_id | Identyfikator połączenia, dla którego wygenerowano podsumowanie |
| date_time | Data i godzina wygenerowania podsumowania |
| campaigns_id | Identyfikator kampanii, w której obsługiwane było połączenie (pole może być puste, jeśli połączenie było poza kampanią) |
ℹ️ Jak pobrać treść podsumowania?
Wywołaj akcję EAPI pobierania podsumowania, przekazując calls_id.
⚠️ Dlaczego treść nie jest wysyłana w webhooku?
Podsumowanie, podobnie jak transkrypcja, może być obszerne. Przesyłanie pełnej treści mogłoby:
- wydłużyć generowanie powiadomienia,
- utrudnić przetwarzanie danych po stronie systemu odbiorcy.
FAQ
-
Kiedy wysyłany jest webhook dotyczący transkrypcji lub podsumowania?
Webhook jest wysyłany automatycznie w momencie zakończenia procesu generowania transkrypcji lub podsumowania dla danego połączenia. Obejmuje jedynie dane identyfikacyjne - pełna treść jest dostępna przez EAPI.
-
Dlaczego treść transkrypcji lub podsumowania nie jest wysyłana w webhooku?
Transkrypcje i podsumowania mogą być bardzo obszerne. Wysyłanie ich w całości w webhooku mogłoby spowodować opóźnienia, problemy z obsługą danych lub niepotrzebne obciążenie systemu odbiorcy. Dlatego webhook przekazuje tylko metadane, a właściwą treść można pobrać poprzez EAPI.
-
Jak pobrać zawartość transkrykcji lub podsumowania?
Wystarczy wywołać odpowiednią akcję EAPI, przekazując calls_id otrzymane w webhooku:
- pobranie transkrypcji,
- pobranie podsumowania (jeżeli transkrypcja istnieje).