Integracja Creatio

Integracja Welyo z Creatio umożliwia realizację i obsługę połączeń telefonicznych bezpośrednio z poziomu CRM, bez konieczności przełączania się między systemami. Wszystkie rozmowy są automatycznie rejestrowane przy odpowiednich kontaktach, wraz z historią, parametrami połączenia i nagraniami. Dzięki temu organizacja zyskuje pełną widoczność działań w kanale telefonicznym w kontekście pracy handlowej i obsługowej. Integracja pozwala także na synchronizację i mapowanie użytkowników, zapewniając spójność uprawnień oraz danych. Creatio pozostaje głównym środowiskiem pracy, a Welyo pełni rolę zintegrowanego kanału komunikacji.

Konfiguracja w Creatio

Celem przygotowania platformy Creatio do integracji z Welyo konieczne jest przejście następujących kroków:

1. Zainstalowanie paczki do Creatio
2. Dodanie OAuth dla zintegrowanych aplikacji
3. Nadanie uprawnień użytkownikowi technicznemu integracji
4. Konfiguracja dedykowanych ustawień dla WebPhone w Creatio
5. Włączenie biblioteki WebPhone do komunikacji
6. Nadawanie użytkownikowi Creatio uprawnień do WebPhone
7. Dodanie WebPhone do zaufanych źródeł

Zainstalowanie paczki

1. Klikamy Settings w prawym górnym rogu panelu.
2. Przechodzimy do sekcji Application management > Application Hub.

3. Wybieramy New application > Install from file.

4. Wgrywamy plik zip z paczką do instalacji.

   ℹ️ Paczkę do instalacji przekazuje opiekun techniczny.

5. Klikamy Install.

Dodanie OAuth dla zintegrowanych aplikacji

Po zalogowaniu jako administrator platformy Creatio przechodzimy:

Settings > Import and integration > OAuth integrated applications > +New > Server-to-server (client credentials)

Następnie, w oknie dodawania nadajemy nazwę, podajemy adres platformy Welyo (twojadomena.welyo.pl), opcjonalnie dodajemy opis. Ważne, aby chceck box odpowiedzialny za stworzenie użytkownika technicznego dla tej integracji był zaznaczony. Zapisujemy poprzez wybranie przycisku Save.

Po zapisaniu zmian wyświetli się automatycznie okno z Client Id oraz Client secret, które będzie potrzebne w kolejnych krokach podczas łączenia integracji po stronie panelu Welyo.  

Nadanie uprawnień użytkownikowi technicznemu

Z poziomu widoku OAuth integrated applications klikamy na nazwę użytkownika w wierszu z dodaną integracją.

1. W widoku edycji użytkownika przechodzimy do zakładki Roles.
2. Klikamy plus (+) obok Functional roles i nadajemy uprawnienie Administrator.
3. Przechodzimy do Settings (koło zębate w prawym górnym rogu panelu).
4. W sekcji Users and administration wybieramy Operation permissions.

5. Z listy Operation permissions wybieramy Access to Focus Webphone > Open.

6. Klikamy Dodaj (plus) w sekcji Operation permission.

   

7. Wyszukujemy użytkownika.
8. Wybieramy go z listy poprzez zaznaczenie checkboxa przy nazwie użytkownika.

9. Zatwierdzamy wybór poprzez wybranie przycisku Select.

   

Konfiguracja dedykowanych ustawień dla WebPhone

1. Klikamy Settings w prawym górnym rogu panelu.
2. Sekcja System Setup > System settings.

3. Filtrujemy listę Code = Focus.

4. W pozycji FocusTelecomWebphoneDomain zmieniamy Default value na domenę instancji Welyo, czyli to co znajduje się w adresie platformy Welyo przed welyo.pl. Domena dla adresu strony firma.welyo.pl to firma.
5. W pozycji FocusTelecomWebphoneChange zmieniamy Default value na 50 losowych znaków, które będą pełniły funkcję change podczas autoryzacji.
6. W pozycji FocusTelecomWebphoneAuthEndpoint zmieniamy Default value na adres www platformy welyo, czyli np. https://domena.welyo.pl/external-api/webphone-login

7. W pozycji FocusTelecomWebphoneApiKey zmieniamy Default value na klucz API wygenerowany przez administratora na platformie Welyo.

   ℹ️ Aby wygenerować / pobrać klucz API z Welyo przechodzimy z poziomu panelu Administratora:

   Administracja > Integracje > Klucz API

   Jeśli klucz jest już wygenerowany - kopiujemy go.

   Jeśli musimy dopiero wygenerować klucz klikamy Generuj klucz.

   

Włączenie biblioteki WebPhone do komunikacji

1. Klikamy Settings w prawym górnym rogu panelu.
2. Wybieramy sekcję System Setup > System settings.
3. Filtrujemy listę Code = SysMsgLib.
4. Zmieniamy Default value na Focus Telecom Webphone integration library.

5. Zapisujemy zmiany poprzez wybranie przycisku Save.

Nadawanie użytkownikowi Creatio uprawnień do WebPhone

1. Klikamy Settings w prawym górnym rogu panelu.
2. W sekcji Users and administration wybieramy Operation permissions.

3. Z listy Operation permissions wybieramy Access to Focus Webphone > Open.

4. Klikamy Dodaj (plus) w sekcji Operation permission.

5. Wyszukujemy użytkownika.
6. Wybieramy go z listy poprzez zaznaczenie checkboxa przy nazwie użytkownika.

7. Zatwierdzamy wybór poprzez wybranie przycisku Select.

   

Dodanie WebPhone do zaufanych źródeł

1. Klikamy Settings w prawym górnym rogu panelu.
2. Sekcja Security > Content Security Policy.
3. Przechodzimy do zakładki VIOLATIONS LOG.
4. Klikamy dwukrotnie w adres w kolumnie Blocked host.

5. Klikamy Add to trusted sources.

Konfiguracja w Welyo

Konfiguracja integracji z Creatio w Welyo odbywa się w panelu administracyjnym i obejmuje aktywację połączenia oraz uzupełnienie danych instancji. Administrator może tu także zsynchronizować i zmapować użytkowników obu systemów. Poprawne ustawienia zapewniają rejestrację połączeń oraz działanie funkcji Click2Dial.

Konfiguracja krok po kroku

1. Z poziomu panelu Administratora przechodzimy:

Administracja > Integracje > Creatio

2. Uzupełniamy pole Adres panelu Creatio - adres www witryny Creatio.
3. Podajemy Client ID i Client Secret.
4. Wybieramy kampanię pomocniczą i domyślnego użytkownika.
5. Klikamy Połącz.
6. Po prawidłowym nawiązaniu połączenia Lista użytkowników z Creatio zostanie pobrana do Welyo.
7. W sekcji Mapowanie użytkowników dopasowujemy użytkowników Welyo z użytkownikami Creatio. Możemy wykonać to ręcznie, lub skorzystać z opcji automatycznego dopasowania użytkowników.

8. Zaznaczamy opcję Aktywacja Integracji w systemie.

   

9. Klikamy Zapisz.

Omówienie widoku okna Integracja Creatio

Sekcja Połączenie z Creatio

Adres panelu Creatio - to pełny adres URL Twojego środowiska Creatio, pod którym logujesz się do systemu w przeglądarce.

Client ID -  to unikalny identyfikator aplikacji (integracji) w Creatio, jest on generowany podczas rejestracji aplikacji / konfiguracji OAuth w Creatio i służy do identyfikacji Twojej aplikacji, autoryzacji połączenia między Welyo a Creatio, uzyskania tokenu dostępowego (razem z Client Secret).

Client Secret -  to poufny klucz przypisany do Twojej aplikacji w Creatio. Działa jak „hasło aplikacji” i razem z Client ID służy do uwierzytelnienia integracji w procesie OAuth 2.0.

Sekcja Aktywna Integracja

Aktywacja Integracji w systemie - Włączenie tej opcji aktywuje integrację z systemem Creatio. Funkcja jest dostępna wyłącznie wtedy, gdy połączenie z panelem Creatio jest aktywne.

Kampania pomocnicza - Do wybranej kampanii zostaną przypisane połączenia, które zostały zrealizowane poza kampanią.

Domyślny użytkownik - Do wybranego użytkownika zostaną przypisane połączenia, które nie mają automatycznie przypisanego użytkownika.

Sekcja Mapowanie użytkowników

Dopasuj użytkowników - funkcja wywołuje automatycznie dopasowanie użytkowników, na podstawie adresów mailowych.

Odśwież użytkowników - Funkcja pobiera z Creatio listę użytkowników oznaczonych jako dostępni w ramach integracji Welyo <> Creatio.

Praca użytkownika w Creatio - Uruchomienie WebPhone

1. Po zalogowaniu na platformę Creatio otwieramy  Communication Panel w prawym górnym rogu platformy.
2. Przechodzimy do zakładki Calls

3. W zakładce Calls wchodzimy w ustawienia (koło zębate)

4. W oknie Call centes parameters base setup podajemy login użytkownika z Welyo.

5. Zatwierdzamy poprzez wybranie przycisku SAVE.
6. Odświeżamy stronę.
7. Na WebPhone klikamy Zezwól.

8. Wyrażamy zgodę dla witryny na wykorzystanie mikrofonu.

Troubleshooting – Integracja Welyo z Creatio

Nie mogę połączyć się z Creatio

Sprawdź wszystkie kroki konfiguracyjne (od 1 do 6)  z sekcji Konfiguracja w Creatio.

Switch integracji jest wyszarzony

To nie zawsze błąd. Switch aktywuje się dopiero po kliknięciu Połącz i otrzymaniu pozytywnej odpowiedzi z Creatio.

Nie widzę użytkownika z Creatio w Welyo

1. Najpierw kliknij Odśwież użytkowników (lista nie synchronizuje się automatycznie).
2. Jeśli mimo to lista nie została zaktualizowana, sprawdź ustawienia uprawnień w Creatio dla użytkowników:

Settings > Users and administration > Operation permissions > Access to Focus Webphone > Open

Webphone się nie ładuje

Sprawdź w Creatio:

• Call Center Parameters:
  • Webphone login ustawiony
  • „Disable call center integration” nie zaznaczone
• System settings:
  • code = SysMsgLib     
  • Default Value = Focus Telecom Webphone integration library
• CSP:
  • Security → Content Security Policy
  • Dodaj domeny webphone do trusted sources
  • Sprawdź zakładkę Violations log

Po zmianach wykonaj twarde odświeżenie (Ctrl + R).

Połączenia nie zapisują się w Creatio

Połączenia odebrane:

• Sprawdź auth endpoint i apikey

Połączenia nieodebrane:

• Sprawdź logi:

Console / Network

• fcc-external-api     
• fcc-wpi-integration     
• fcc-event-runner.log      (szukaj: UnansweredCall     )

Z logu możemy dowiedzieć się co jest przyczyną, jeśli nie możesz go zinterpretować skontaktuj się z naszym działem Customer Care.