Przewodnik po Mokapen

3CX

3CX łączy centralę telefoniczną z Mokapen: popup kontaktu, dziennik połączeń i — jeśli skonfigurujesz — click-to-call. Mokapen nie staje się centralą: generuje klucz API i szablon XML, który wgrywasz w adminie 3CX. Stamtąd 3CX pyta Mokapen, kim jest numer, a Mokapen może zapisać notatkę połączenia na kontakcie lub firmie.

Przegląd: Integracje.

Wymagania

• Instalacja 3CX, w której możesz otworzyć Admin → Integrations → CRM i wczytać szablon.
• Plan Mokapen Medium.
• Do click-to-call dodatkowo: plan 3CX z Call Control / WebAPI (Enterprise), host 3CX osiągalny z Mokapen oraz wewnętrzny zmapowany na użytkownika, który klika.

Klucz API i szablon

Menu użytkownika → Integracje → 3CX. Mokapen pokazuje klucz API do szablonu CRM: jako nazwę użytkownika Basic auth albo w nagłówku X-Api-Key. Pobierz szablon XML. Klucz jest już wpisany jako wartość domyślna. Wczytaj go w 3CX Admin → Integrations → CRM.

Na stronie znajdziesz też bazowy URL API CRM: to adres, który wywołuje szablon. Jeśli 3CX jest za siecią, która nie osiąga Mokapen, popup się nie otworzy mimo wczytanego szablonu.

Możesz wygenerować klucz ponownie przy zapisie. Poprzedni przestaje obowiązywać: wczytaj szablon ponownie albo zaktualizuj klucz już wklejony w 3CX. Pozostawienie starego klucza w centrali daje błędy uwierzytelniania, nie drugie połączenie.

Notatki połączeń i click-to-call

Dwa przełączniki decydują o zachowaniu wobec książki adresowej:

• Zapisuj notatki połączeń na kontaktach i firmach — na końcu rozmowy Mokapen zapisuje notatkę na znalezionej karcie.
• Zezwól na tworzenie kontaktów z 3CX, jeśli numer jest nieznany — gdy numeru nie ma w książce, Mokapen tworzy kontakt. Wyłącz, jeśli centrala przyjmuje ogólny ruch (centrala siedziby, numery grzecznościowe): inaczej każdy nieznany staje się kartą.

Click-to-call jest osobne. Potrzebne są host 3CX (FQDN) i klucz WebAPI / Call Control. Bez klucza Mokapen mówi, że klucz Call Control nie jest skonfigurowany. Bez hosta — że brakuje FQDN. Bez mapowania rozmowa nie wie, który wewnętrzny ma dzwonić.

Mapowanie to jeden wiersz na osobę w formie wewnętrzny=user_id (przykład 102=15). Służy zarówno do przypisania notatki połączenia właściwemu użytkownikowi, jak i do click-to-call. Jeśli Twój użytkownik nie ma wiersza, Mokapen mówi, że nie ma zmapowanego wewnętrznego. Zwykłe kliknięcie dzwoni przez 3CX; Shift, Ctrl lub Alt razem z kliknięciem otwiera dialer urządzenia.

Jeśli 3CX odrzuca żądanie, sprawdź kolejno FQDN, klucz Call Control i wewnętrzny. Komunikat na stronie mówi, że 3CX nie zaakceptowało połączenia.

Kiedy popup się nie pojawia

• Szablon nie został wczytany albo został wczytany przed ponownym wygenerowaniem klucza.
• Numer przychodzący nie zgadza się z telefonem w książce, a automatyczne tworzenie jest wyłączone. Popup nie ma karty do otwarcia.
• Szukasz wideorozmowy spotkania. 3CX nie umieszcza Meet ani Teams na karcie spotkania.