System voxCRM oferuje integrację z usługą Play Wirtualna Centralka, dzięki której połączenia telefoniczne z Państwa centralki automatycznie trafiają na listę połączeń w voxCRM — wraz z przypisanym klientem i doradcą, bez konieczności ręcznego wprowadzania danych.
Spis treści
- Czym jest integracja z Play Wirtualna Centralka
- Co otrzymują Państwo w voxCRM
- Wymagania po stronie Play
- Konfiguracja w voxCRM
- Ustawienia dodatkowe
- Znane ograniczenia
- Najczęstsze problemy
- Kontakt
1. Czym jest integracja z Play Wirtualna Centralka
Play Wirtualna Centralka to usługa operatora Play dla firm, która obsługuje numer główny (infolinię) oraz numery telefonów pracowników. Centralka rejestruje wszystkie połączenia — przychodzące, wychodzące i nieodebrane.
Integracja z voxCRM pozwala automatycznie przenosić tę historię na listę połączeń, dzięki czemu zespół sprzedaży i kierownictwo widzą rozmowy z klientami w jednym miejscu — razem z połączeniami z aplikacji mobilnej voxCRM i innych centralek — oraz mogą na ich podstawie tworzyć raporty.
2. Co otrzymują Państwo w voxCRM
Dla każdego połączenia zarejestrowanego przez centralkę Play system voxCRM zapisze na liście połączeń następujące dane:
| Pole połączenia | Co się tam zapisuje |
| Źródło pochodzenia | „Play”. |
| Typ połączenia | Przychodzące, wychodzące lub nieodebrane. |
| Data i czas trwania | Data i godzina rozpoczęcia połączenia oraz czas rozmowy (dla nieodebranych 0:00). |
| Klient | Dopasowany automatycznie po numerze telefonu do istniejącego klienta. Integracja nie zakłada nowych klientów ani leadów. |
| Doradca | Użytkownik voxCRM, któremu przypisano numer telefonu z centralki — szczegóły w sekcji 4. |
| Wpis na wallu klienta | Informacja o połączeniu z dopiskiem „Połączenie Play”. |
Sposób zapisu w zależności od rodzaju połączenia:
| Sytuacja | Jak wygląda na liście połączeń |
| Klient dzwoni na infolinię, odbiera handlowiec | Przychodzące, czas rozmowy, doradca = osoba, która odebrała. |
| Klient dzwoni na infolinię, nikt nie odbiera | Nieodebrane, 0:00, bez doradcy. |
| Klient dzwoni bezpośrednio na numer handlowca* | Przychodzące lub nieodebrane, doradca = właściciel numeru. |
| Handlowiec dzwoni do klienta ze swojego numeru* | Wychodzące, czas rozmowy (0:00, gdy klient nie odebrał), doradca = handlowiec. |
| Handlowiec dzwoni z numeru głównego | Wychodzące, bez doradcy. |
| Numer odbierającego nie jest przypisany w voxCRM | Połączenie zapisane bez doradcy. |
* wymaga funkcji Play Numer Wewnętrzny — patrz sekcja 3.
Na listę połączeń nie trafiają: połączenia wewnętrzne (między numerami centralki), połączenia z numerów zastrzeżonych oraz numery dodane do listy „Ignorowane numery połączeń”. Połączenie usunięte ręcznie z listy nie wraca przy kolejnym pobraniu.
3. Wymagania po stronie Play
Przed konfiguracją w voxCRM prosimy sprawdzić w panelu Play (uslugidlafirm.play.pl → Wirtualna Centralka):
- Dane dostępowe API — w sekcji API → Konfiguracja znajdują się Client ID i Client Secret, potrzebne w kroku 2 konfiguracji.
- Funkcja Numer Wewnętrzny dla handlowców — w Użytkownicy → edycja użytkownika każdy handlowiec, którego połączenia mają być przypisywane, powinien mieć aktywną funkcję Numer Wewnętrzny (płatna usługa Play, 5 zł netto miesięcznie za numer). Bez niej połączenia wychodzące handlowca są widoczne w Play jako wykonane z numeru głównego i voxCRM nie przypisze ich do handlowca. Połączenia odebrane z infolinii są przypisywane także bez tej funkcji.
- „Prezentacja numerem głównym” — w edycji użytkownika w Play ta opcja powinna być wyłączona, aby połączenia wychodzące handlowca były rejestrowane z jego numeru.
4. Konfiguracja w voxCRM
Po aktualizacji systemu integracja jest wyłączona. Konfigurację wykonuje administrator voxCRM w trzech krokach.
Krok 1 — przypisanie numerów handlowcom
- Administracja → Użytkownicy → wybór użytkownika → Edytuj.
- Zakładka „Integracja Play”.
- W polu „Numer telefonu w centralce Play” należy wpisać numer telefonu handlowca z centralki Play (ten sam, który w Play widnieje jako „Numer telefonu”), np.
600 100 200. - Zapisz.
- Należy wpisać pełny numer telefonu, a nie 4-cyfrowy numer wewnętrzny z Play. Numer można podać ze spacjami lub z prefiksem
+48— system zapisze go jako 9 cyfr. - Jeden numer może być przypisany tylko do jednego użytkownika.
- Do łączenia połączeń z doradcą służy wyłącznie to pole — pola „Tel. firmowy” i „Tel. kom.” w profilu użytkownika nie są brane pod uwagę.
- Zakładka „Integracja Play” jest widoczna dla użytkowników z uprawnieniem do ustawień Play (domyślnie administrator).
Krok 2 — dane dostępowe i włączenie integracji
- Administracja → Ustawienia → „Ustawienia Play Wirtualna Centralka”.
- Należy wpisać Client ID i Client Secret z panelu Play.
- Zaznaczyć „Włącz integrację z Play” i zapisać.
Przykładowy wygląd danych dostępowych (wartości fikcyjne):
| Pole | Format | Przykład |
| Client ID | 16 znaków (litery i cyfry) | DAtEpQnG7uQvsmJF |
| Client Secret | 64 znaki (litery i cyfry) | WEhkOP2cy570RjMmhBjK6voMCsqo1RkUlHY34DOr1gdhTNHUdkNzfhadjqjFaoyx |
Krok 3 — włączenie zadania cyklicznego
- Administracja → Ustawienia → Lista zadań Cron.
- Włączyć zadanie „Pobieranie historii połączeń z Play Wirtualna Centralka”.
Zadanie uruchamia się co 5 minut; przyciskiem „Uruchom” można wywołać pobranie ręcznie. Pierwsze pobranie obejmuje połączenia od północy dnia włączenia.
5. Ustawienia dodatkowe
| Gdzie | Co włączyć | Po co |
| Administracja → Ustawienia listy połączeń | Kolumna „Źródło pochodzenia” i filtr „Źródło” | Odróżnienie połączeń z Play od połączeń z aplikacji mobilnej i innych centralek (domyślnie kolumna i filtr są ukryte). |
| Administracja → Ustawienia aplikacji mobilnej | „Automatycznie rejestruj połączenie telefoniczne z klientem jako aktywność o typie telefon” | Aktywność „Telefon” u doradcy po rozmowie trwającej min. 10 s. |
| Administracja → Klienci | Automatyczna zmiana statusu na „Zainteresowany” | Zmiana statusu klienta po rozmowie dłuższej niż 15 s. |
6. Znane ograniczenia
- Podwójne wpisy z aplikacją mobilną — jeśli handlowiec z funkcją Numer Wewnętrzny korzysta również z aplikacji mobilnej voxCRM, każde jego połączenie pojawi się na liście dwukrotnie (źródło „Aplikacja” i „Play”).
- Czas rozmowy przy połączeniach z infolinii — dla połączeń odebranych z infolinii czas na liście obejmuje także oczekiwanie klienta (zapowiedź, kolejka, dzwonienie u handlowca), zwykle o 20–60 s więcej niż sama rozmowa. Połączenia wychodzące i przychodzące bezpośrednio na numer handlowca mają czas samej rozmowy.
- Widoczność połączeń bez doradcy — nieodebrane połączenia na infolinię (bez doradcy) widzą użytkownicy z uprawnieniem do wszystkich połączeń.
- Nagrania i powiadomienia — nagrania rozmów, powiadomienia o połączeniu przychodzącym oraz dzwonienie z karty klienta (click2call) nie są objęte integracją.
- Jedna centralka Play na instancję voxCRM.
- Historia — Play przechowuje połączenia przez ok. 3 miesiące; starszych połączeń nie można pobrać.
7. Najczęstsze problemy
| Objaw | Co sprawdzić |
| Brak połączeń z Play na liście | Czy integracja jest włączona (krok 2) i zadanie cron aktywne (krok 3); czy od rozmowy minęło 10–15 minut. |
| Połączenia przestały się pojawiać | Play okresowo zmienia Client Secret — należy pobrać aktualny z panelu Play (API → Konfiguracja) i zapisać go w ustawieniach Play w voxCRM. |
| Połączenie bez doradcy | Czy numer handlowca jest wpisany w zakładce „Integracja Play”; przy połączeniach wychodzących — czy handlowiec ma w Play funkcję Numer Wewnętrzny i wyłączoną „Prezentację numerem głównym”. |
| Komunikat „Numer musi składać się z 9 cyfr” | Wpisano za krótki lub za długi numer albo numer wewnętrzny zamiast numeru telefonu. |
| Komunikat „Ten numer jest już przypisany do innego użytkownika” | Numer jest już wpisany u innego użytkownika — należy go najpierw usunąć z jego profilu. |
| Brak konkretnego połączenia | Czy numer klienta nie znajduje się na liście „Ignorowane numery połączeń” oraz czy klient nie dzwonił z numeru zastrzeżonego. |
Aby wyłączyć integrację, należy w Administracja → Ustawienia → „Ustawienia Play Wirtualna Centralka” odznaczyć „Włącz integrację z Play” i zapisać. Nowe połączenia przestaną być pobierane, a zapisane wcześniej pozostaną na liście.
Kontakt
W razie pytań lub problemów prosimy o kontakt z działem wsparcia technicznego:
- E-mail: kontakt@voxcommerce.pl
- Telefon: 534 571 638