Integracja z systemem telefonicznym 3CX. Cel modułu: Moduł "Contact by Phone" to narzędzie integracyjne, które łączy system telefoniczny 3CX z bazą kontaktów Odoo 18.
Główna funkcjonalność: Podstawową funkcją modułu jest automatyzacja pracy z kontaktami podczas rozmów telefonicznych. Gdy użytkownik odbiera połączenie przychodzące lub sam wybiera numer, moduł:
- Automatycznie wyszukuje kontakt w Odoo na podstawie numeru telefonu.
- Otwiera kartę kontaktu, jeśli numer zostanie znaleziony.
- Tworzy nową kartę kontaktu (z automatycznie wpisanym numerem), jeśli numer nie istnieje w bazie Odoo.
Kluczowe cechy:
- Elastyczne wyszukiwanie: Moduł inteligentnie rozpoznaje numery telefonów zapisane w różnych formatach (np. +48 123 456 789, 123-456-789, (123) 456789), dopasowując je do numeru przesłanego przez 3CX.
- Szybkość: Wyszukiwanie odbywa się bezpośrednio przez SQL, co zapewnia wysoką wydajność.
- Bezpieczeństwo: Dostęp do funkcji wymaga bycia zalogowanym w systemie Odoo.
- Kompatybilność: Pełne wsparcie dla Odoo 18 działającego w środowisku Docker.
Wymagania i Konfiguracja:
- Systemowe: Wymagane jest Odoo 18.0 (z modułami base i web) oraz centrala 3CX v20.
- Instalacja: Standardowa instalacja modułu Odoo (rozpakowanie do addons, restart, instalacja w panelu Aplikacji).
- Konfiguracja 3CX: Wymaga włączenia w panelu 3CX opcji "Enable Auto launch a Custom Contact URL" i ustawienia adresu URL na: https://odo.ovh/contact_by_phone?phone=%CallerNumber%.
Testowanie i Rozwiązywanie Problemów:
- Moduł można testować bez podłączonej centrali 3CX, wywołując bezpośrednio odpowiedni URL w przeglądarce.
- Dokumentacja opisuje typowe problemy, takie jak nieotwieranie się kontaktu (problem z logowaniem lub formatem numeru) czy tworzenie duplikatów (zalecenie ujednolicenia formatów numerów w bazie).
Instalacja
1 Pobierz moduł
Rozpakuj archiwum contact_by_phone do katalogu z modułami Odoo:
unzip contact_by_phone -d /home/user/katalog_projektu/addons
2 Restart serwera Odoo
Zrestartuj serwer Odoo aby załadować nowy moduł:
docker compose down && docker compose up -d
3 Aktualizacja listy aplikacji
W interfejsie Odoo przejdź do Apps → Update Apps List lub usuń filtr "Apps" i wyszukaj moduł.
4 Instalacja modułu
Wyszukaj "Contact by Phone" i kliknij przycisk Install.
✅ Instalacja zakończona! Po zainstalowaniu moduł działa automatycznie