Wersja 10.23

TL;DR:  Wprowadzono nowe akcje EAPI oraz webhooki umożliwiające automatyczne generowanie i odbieranie transkrypcji oraz podsumowań rozmów.

Zmiana dotyczy użytkowników korzystających z integracji API i wpływa na obszar automatyzacji oraz komunikacji systemowej.

Konsultacja z działem IT jest potrzebna tylko wtedy, gdy platforma korzysta z EAPI lub chce wdrożyć nowe webhooki czy obsługę transkrypcji/podsumowań w swoich systemach.

Transkrypcje i podsumowania dostępne przez EAPI

Webhooki informujące o wygenerowaniu transkrypcji lub podsumowania

Struktura webhooka – wygenerowanie transkrypcji

Struktura webhooka – wygenerowanie podsumowania

Parametry wersji

Cel wersji

Celem tej wersji systemu Welyo jest udostępnienie nowych możliwości związanych z automatycznym przetwarzaniem rozmów — transkrypcjami i podsumowaniami — oraz zapewnienie mechanizmów ich integracji z systemami zewnętrznymi.

W ramach aktualizacji dodano:

• nowe akcje EAPI umożliwiające zlecanie oraz pobieranie transkrypcji i podsumowań rozmów,
• webhooki informujące o wygenerowaniu transkrypcji lub podsumowania, co pozwala systemom zewnętrznym na automatyczne reagowanie na te zdarzenia,
• konfigurację webhooków w kampaniach, z opcją dodania adresu URL i danych autoryzacyjnych.

Dzięki tym funkcjom integracje stają się szybsze, bardziej elastyczne i pozwalają na automatyczne przetwarzanie danych rozmów bez konieczności manualnej obsługi.

Zmiany

Transkrypcje i podsumowania dostępne przez EAPI

System Welyo został rozszerzony o możliwość obsługi transkrypcji oraz podsumowań rozmów poprzez EAPI. Dodano akcje pozwalające na:

• zlecenie wygenerowania transkrypcji,
• zlecenie wygenerowania podsumowania (jeżeli dla połączenia dostępna jest transkrypcja),
• pobranie transkrypcji,
• pobranie podsumowania.

Szczegóły dotyczące wykorzystania nowych akcji EAPI znajdują się w panelu Administratora Welyo:

Administracja > Integracje > Dokumentacja API (wersja on-line).

Webhooki informujące o wygenerowaniu transkrypcji lub podsumowania

W kampaniach Welyo dodano możliwość konfiguracji webhooków informujących o wygenerowaniu transkrypcji lub podsumowania połączenia.

Jak uruchomić webhooki?

1. W panelu Administratora wejdź w edycję kampanii.

2. W zakładce Podstawowe parametry zaznacz opcję:

   „Webhook – wysyłaj na adres URL informacje o zdarzeniach w systemie:”

3. Kliknij Konfiguruj – pojawi się okno umożliwiające dodanie zdarzeń wywołujących webhook.

4. Po kliknięciu Dodaj wybierz zdarzenie z listy:

• Wygenerowano transkrypcję
• Wygenerowano podsumowanie

5. Dla każdego zdarzenia można wskazać:
   • adres URL, na który zostanie wysłany webhook,
   • dane autoryzacyjne (Basic Auth), dostępne po kliknięciu Autoryzacja.

Struktura webhooka – wygenerowanie transkrypcji

{
  "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:

• eventName – nazwa zdarzenia
• fccInstance – domena Welyo, z której pochodzi powiadomienie
• customerId – identyfikator klienta
• version – wersja webhooka
• createdAt – data i godzina wygenerowania powiadomienia

W sekcji data  :

• calls_id – identyfikator połączenia, dla którego wygenerowano transkrypcję
• date_time – data i godzina wygenerowania transkrypcji
• campaigns_id – identyfikator kampanii (wartość pusta, jeśli połączenie było realizowane poza kampanią)

Struktura webhooka – wygenerowanie podsumowania

{
"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

• eventName – nazwa zdarzenia
• fccInstance – domena Welyo, z której pochodzi powiadomienie
• customerId – identyfikator klienta
• version – wersja webhooka
• createdAt – data i godzina wygenerowania powiadomienia

W sekcji data  :

• calls_id – identyfikator połączenia, dla którego wygenerowano podsumowanie
• date_time – data i godzina wygenerowania podsumowania
• campaigns_id – identyfikator kampanii (lub pusty, jeśli połączenie nie dotyczyło kampanii)

Kogo dotyczą zmiany?

Zmiany dotyczą wszystkich klientów korzystających z integracji z systemem Welyo poprzez EAPI. Zmiana jest istotna zarówno dla administratorów konfigurujących kampanie, jak i dla zespołów technicznych odpowiedzialnych za integracje.

Na jaki obszar wpływa zmiana?

Zmiana wpływa na obszar:

Integracji systemowych (EAPI) — dodanie nowych akcji związanych z transkrypcjami i podsumowaniami,

Webhooków w kampaniach — możliwość wysyłania powiadomień o wygenerowaniu transkrypcji lub podsumowania,

Automatyzacji pracy — umożliwienie systemom zewnętrznym reagowania na zdarzenia związane z połączeniami.

Zmiana nie wpływa na sposób prowadzenia kampanii przez użytkowników końcowych — dotyczy jedynie rozszerzenia funkcjonalności integracyjnych.

Czy zmiana wymaga konsultacji z wewnętrznym działem IT?

Tak, jeśli platforma korzysta z integracji poprzez API lub zamierza używać webhooków.

W takim przypadku dział IT lub zespół odpowiedzialny za integracje powinien:

• ocenić, czy nowe webhooki i akcje API mają zostać wdrożone,
• przygotować lub dostosować endpointy do odbioru powiadomień,
• zaplanować obsługę pobierania transkrypcji i podsumowań na podstawie calls_id  .

Nie, jeśli platforma nie korzysta z integracji ani z webhooków.

W takim przypadku zmiany nie wymagają żadnych działań po stronie IT.