Telefonia Voys

Dzięki integracji z Voys Tillor widzi, kto dzwoni, i od razu pokazuje dane klienta. Rozmowy, nagrania i transkrypcje trafiają potem do sekcji Połączenia telefoniczne. Voys to dostawca telefonii dla firm.

Zanim zaczniesz:

• Potrzebujesz aktywnego konta Voys VoIP oraz dostępu do ustawień planu połączeń w Voys.
• Potrzebujesz uprawnienia Zarządzanie integracjami.
• Numer telefonu dzwoniącego musi być zapisany w profilu klienta lub u osoby kontaktowej, w przeciwnym razie Tillor nie powiąże rozmowy z klientem.

Konfiguracja VoysKopiuj link do tej sekcji

1. Przejdź do Ustawienia (pasek boczny, w sekcji Pomoc)

2. Wybierz Integracje i otwórz Voys na liście
3. Na stronie szczegółów wpisz swoje dane Voys (username, password, client_uuid, token) i kliknij Zainstalować

Potrzebujesz aktywnego konta Voys VoIP.

Gdzie znaleźć adresy URL dla VoysKopiuj link do tej sekcji

Tillor i Voys komunikują się ze sobą przez adresy (URL). Na niektórych etapach Voys oczekuje odpowiedzi od Tillora, na przykład czy jesteście otwarci. Ta odpowiedź to ACK (tak, kontynuuj) lub NAK (nie, idź inną ścieżką). Webhook to taki adres, który Voys wywołuje w trakcie rozmowy.

Dla webhooków, wyszukiwania nazwy dzwoniącego i kodów dostępu używasz adresów URL, które Tillor generuje dla Ciebie.

1. Przejdź do Ustawienia > Integracje i otwórz Voys
2. Po instalacji na stronie szczegółów, w sekcji Ustawienia, znajdziesz blok Adresy URL do skonfigurowania - skopiuj stamtąd odpowiedni adres URL dla danego celu

Znajdziesz tam między innymi:

• Powiadomienia o rozmowach - adres URL webhooka dla zdarzeń rozmów
• Webhook do wyszukiwania rozmówców - adres URL do wyszukiwania nazwy dzwoniącego (caller name lookup) w planie połączeń Voys
• Książka telefoniczna XML - adres URL, z którego telefony VoIP pobierają książkę telefoniczną
• Kody dostępu - adres URL do obsługi punktu dostępu (szlaban, brama lub drzwi) przez plan połączeń
• Webhook godzin otwarcia - ACK, gdy Tillor jest otwarty, NAK, gdy Tillor jest zamknięty
• Webhook dozwolonego dzwoniącego - ACK, gdy dzwoniącego można połączyć, NAK, gdy dzwoniący ma trafić na pocztę głosową
• Webhook routingu - ACK z miejscem docelowym, NAK, gdy nie ustawiono miejsca docelowego

W planie połączeń Voys używaj tych samych zmiennych, które podano w Tillorze (takich jak {callerid}, {did}, {callername}, {callid} i {code}).

Konfiguracja powiadomień o rozmowach w VoysKopiuj link do tej sekcji

1. Otwórz w Voys moduł Powiadomienia o rozmowach
2. Kliknij Dodaj
3. W polu package/service wybierz Aangepast (własne)
4. Wklej adres URL z Tillora z pozycji Powiadomienia o rozmowach
5. Zapisz

Dokumentacja Voys:

• Powiadomienia o rozmowach

Konfiguracja nazw dzwoniących (caller lookup) w planie połączeńKopiuj link do tej sekcji

Do wyszukiwania nazwy dzwoniącego używasz w Voys kroku webhook w planie połączeń.

1. Otwórz w Tillorze adres URL Webhook do wyszukiwania rozmówców (w Ustawienia > Integracje > Voys, w bloku Adresy URL do skonfigurowania) i skopiuj go
2. Otwórz w Voys moduł Webhooks i utwórz webhook z tym szablonem URL
3. Aktywuj ten webhook w planie połączeń przez krok webhook
4. W szablonie URL używaj zmiennych obsługiwanych przez Voys ({callerid}, {did}, {callername} oraz w razie potrzeby {code})
5. W routingu webhooka ustaw Variabele bellernaam, aby zwrócona nazwa była wyświetlana na urządzeniach

Webhooki godzin otwarcia i routingu nie wyszukują nazwy dzwoniącego. Do tego służy ten osobny krok.

Więcej informacji:

• Webhooks
• Czym są powiadomienia o rozmowach (różnica względem webhooków)

Godziny otwarcia i miejsca docelowe w planie połączeńKopiuj link do tej sekcji

Tillor jest źródłem godzin otwarcia, urlopów i wyjątków w dni świąteczne. Voys nie musi już sam znać tego kalendarza.

1. W Ustawienia > Integracje > Voys wybierz urządzenie Voys dla stanu otwarte oraz opcjonalnie dla stanu zamknięte
2. Skopiuj Webhook godzin otwarcia lub Webhook routingu z bloku Adresy URL do skonfigurowania
3. Utwórz w Voys webhook z tym szablonem URL
4. Ustaw ten webhook jako krok w planie połączeń, powyżej ewentualnych menu wyboru
5. Pozostaw Menu gebruiken wyłączone

Dwa wzorce:

• Webhook godzin otwarcia - status=ACK prowadzi ścieżką HTTP en menu gelukt (otwarte), status=NAK prowadzi ścieżką HTTP of menu mislukt (zamknięte). Jeśli ustawiono miejsce docelowe dla stanu otwartego, trafia ono do ACK jako destination.
• Webhook routingu - Tillor wybiera miejsce docelowe. Ustaw w kroku udanym Variabele eindbestemming. ACK + destination, gdy jest miejsce docelowe, w przeciwnym razie NAK.

Przy błędzie lub przekroczeniu czasu Voys wybiera ścieżkę nieudaną. Traktuj to jako zamknięte.

Dokumentacja Voys: Webhooks.

Automatyczne kierowanie dzwoniących na pocztę głosowąKopiuj link do tej sekcji

Dzięki Webhook dozwolonego dzwoniącego pozwalasz Voys zdecydować dla każdego dzwoniącego, czy rozmowa zostanie połączona. Tillor sprawdza, czy numer dzwoniącego należy do klienta, który ma włączoną automatyczną pocztę głosową.

Najpierw skonfiguruj plan połączeń:

1. Skopiuj Webhook dozwolonego dzwoniącego z bloku Adresy URL do skonfigurowania w Ustawienia > Integracje > Voys
2. Utwórz w Voys webhook z tym szablonem URL
3. Ustaw ten webhook jako krok w planie połączeń, powyżej kroków, które łączą rozmowę
4. Pozostaw Menu gebruiken wyłączone
5. Ścieżkę HTTP en menu gelukt skieruj do zwykłego routingu, a ścieżkę HTTP of menu mislukt do poczty głosowej
6. W Ustawienia > Integracje > Voys, w sekcji Przekierowanie połączeń, zaznacz Automatyczna poczta głosowa w Voys

Dopóki ta opcja jest wyłączona, nie zobaczysz Kieruj połączenia na pocztę głosową w profilu klienta.

Następnie włącz automatyczną pocztę głosową dla każdego klienta:

1. Otwórz profil klienta i przejdź do karty Komunikacja
2. W Ustawienia komunikacji zaznacz opcję Kieruj połączenia na pocztę głosową
3. Kliknij Zapisz

Tak działa odpowiedź:

• ACK - dzwoniący może zostać połączony. Dotyczy to także nieznanych numerów i dzwoniących z ukrytym numerem.
• NAK - numer należy do klienta z automatyczną pocztą głosową. Voys wybiera ścieżkę nieudaną.

Tillor porównuje numer dzwoniącego z numerem telefonu w profilu klienta, niezależnie od spacji i zapisu numeru kierunkowego kraju. Numery telefonów osób kontaktowych nie są brane pod uwagę.

Ten webhook nie uwzględnia godzin otwarcia. Połącz go z webhookiem godzin otwarcia lub routingu, umieszczając oba jako osobne kroki w planie połączeń.

Dokumentacja Voys: Webhooks.

Stałe przekierowanie dla dzwoniącegoKopiuj link do tej sekcji

Ten sam Webhook routingu może od razu przekierować dzwoniącego na wybrane urządzenie Voys, numer wewnętrzny lub numer telefonu. Dotyczy to tylko klientów, dla których wybrano miejsce docelowe, i tylko wtedy, gdy włączone jest Stałe przekierowanie w Voys.

1. Umieść Webhook routingu w planie połączeń, tak jak przy godzinach otwarcia
2. Ustaw w kroku udanym Variabele eindbestemming
3. W Ustawienia > Integracje > Voys, w sekcji Przekierowanie połączeń, zaznacz Stałe przekierowanie w Voys

Dopóki ta opcja jest wyłączona, nie zobaczysz Stałe przekierowanie rozmów w profilu klienta. Webhook używa wtedy tylko urządzenia dla stanu otwartego lub zamkniętego.

Następnie ustaw miejsce docelowe dla każdego klienta:

1. Otwórz profil klienta i przejdź do karty Komunikacja
2. W polu Stałe przekierowanie rozmów wybierz urządzenie Voys albo Inne dla numeru telefonu lub numeru wewnętrznego (na przykład 411)
3. Wybierz Brak, aby wyłączyć stałe przekierowanie
4. Kliknij Zapisz

Tak webhook routingu wybiera miejsce docelowe:

• Jeśli dla tego dzwoniącego ustawiono stałe miejsce docelowe, jest ono wartością destination.
• W przeciwnym razie destination to urządzenie Voys dla stanu otwartego lub zamkniętego.
• NAK - nie ma stałego miejsca docelowego ani urządzenia dla bieżącego stanu. Dotyczy to także nieznanych numerów i dzwoniących z ukrytym numerem, dopóki nie ustawiono urządzenia dla stanu otwartego lub zamkniętego.

Tillor porównuje numer dzwoniącego z numerem telefonu w profilu klienta, niezależnie od spacji i zapisu numeru kierunkowego kraju. Numery telefonów osób kontaktowych nie są brane pod uwagę.

Przy błędzie lub przekroczeniu czasu Voys wybiera ścieżkę nieudaną.

Dokumentacja Voys: Webhooks.

Co dzieje się potem?Kopiuj link do tej sekcji

• Każda rozmowa przychodząca lub wychodząca znajduje się w KomunikacjaPołączenia telefoniczne, razem z klientem, jeśli numer się zgadza. Zobacz Połączenia telefoniczne.
• Przy rozmowie przychodzącej dzwoniący pojawia się jako karta w prawym dolnym rogu Tillora, wraz z danymi klienta.
• Nagrania i transkrypcje pojawiają się po zakończeniu rozmowy, jeśli nagrywanie rozmów jest włączone na Twoim koncie Voys.

Problemy?Kopiuj link do tej sekcji

Zobacz takżeKopiuj link do tej sekcji