Instrukcja Obsługi: 📞 Contact by Phone (Odoo 18)

 Pro EXTREME

 Pro ULTIMATE

​ Midi BUSINESS

 Mini FREE

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ł:

1. Automatycznie wyszukuje kontakt w Odoo na podstawie numeru telefonu.
2. Otwiera kartę kontaktu, jeśli numer zostanie znaleziony.
3. Tworzy nową kartę kontaktu (z automatycznie wpisanym numerem), jeśli numer nie istnieje w bazie Odoo.

Kup moduł tutaj...

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).

O module

Contact by Phone to inteligentny moduł integracyjny łączący system telefoniczny 3CX v20 z bazą kontaktów Odoo 18.

Funkcjonalność umożliwia automatyczne otwieranie karty kontaktu w Odoo na podstawie numeru telefonu dzwoniącego lub wybieranego przez użytkownika.

Główne funkcjonalności

• Automatyczne wyszukiwanie kontaktu - po numerze telefonu przychodzącego połączenia
• Automatyczne tworzenie kontaktu - dla nieznanego numeru z automatycznym wpisaniem numeru telefonu
• Elastyczne wyszukiwanie - obsługuje różne formaty numerów (spacje, myślniki, nawiasy)
• Bezpieczeństwo - dostęp tylko dla zalogowanych użytkowników Odoo
• Kompatybilność - pełna obsługa Odoo 18 w Docker
• Szybkość - wyszukiwanie przez SQL dla maksymalnej wydajności

💡 Wskazówka: Moduł inteligentnie obsługuje różne formaty numerów. Numer zapisany w Odoo jako +48 123 456 789 będzie znaleziony nawet jeśli 3CX wyśle 123456789.

Wymagania systemowe

• Odoo 18.0
• Zainstalowany moduł base i web
• 3CX v20 (dla integracji telefonicznej)
• Dostęp do Internetu

Instalacja modułu

1. Rozpakuj moduł do folderu addons Odoo
   unzip contact_by_phone_v11.0.0.zip -d /path/to/addons/
2. Ustaw uprawnienia (jeśli Odoo w Docker)
   chmod -R 755 contact_by_phone
3. Zrestartuj Odoo
   docker compose down && docker compose up -d
4. Zainstaluj moduł w Odoo
   • Zaloguj się do Odoo
   • Przejdź do: Ustawienia → Aplikacje
   • Kliknij Aktualizuj listę aplikacji
   • Wyszukaj: "Contact by Phone"
   • Kliknij Zainstaluj

Konfiguracja 3CX

Aby aktywować integrację z centralą 3CX v20:

1. Zaloguj się do panelu 3CX (zwykle na porcie 5001)
2. Przejdź do Settings → Integration
3. Włącz opcję: "Enable Auto launch a Custom Contact URL using variables"
4. Wpisz URL:
   https://odo.ovh/contact_by_phone?phone=%CallerNumber%
5. Zapisz ustawienia i gotowe!

✓ Po konfiguracji: Przy każdym przychodzącym połączeniu lub wyborze numeru w 3CX, Odoo automatycznie otworzy kartę odpowiedniego kontaktu.

Testowanie

Aby przetestować moduł bez 3CX, użyj bezpośrednio URL:

Test 1 - Istniejący kontakt

https://odo.ovh/contact_by_phone?phone=+48123456789

Jeśli kontakt istnieje, otworzy się jego karta.

Test 2 - Nowy kontakt

https://odo.ovh/contact_by_phone?phone=+48987654321

Jeśli kontakt nie istnieje, zostanie automatycznie utworzony z wpisanym numerem telefonu.

Format Numerów Telefonów

Moduł obsługuje wiele formatów numerów:

Rozwiązywanie Problemów

Kontakt nie otwiera się

Sprawdź:

• Czy jesteś zalogowany do Odoo?
• Czy numer w Odoo jest zapisany dokładnie tak jak wysyła 3CX?
• Czy w URL znajduje się parametr ?phone=?

Tworzenie się duplikaty kontaktów

Przyczyna: Numery mogą być zapisane w różnych formatach w bazie.

Rozwiązanie: Ujednolic format numerów telefonów w bazie kontaktów (np. zawsze +48 XXX XXX XXX)

Moduł się nie zainstalował

Sprawdź logi:

docker logs projekt_web_odo.ovh | grep contact_by_phone

FAQ - Najczęstsze Pytania

P: Czy moduł pracuje z innymi centrami VoIP?

O: Moduł pracuje z każdą centralą, która obsługuje konfigurację custom URL. Może wymagać dostosowania.

P: Czy mogę edytować automatycznie tworzony kontakt?

O: Tak! Nowo utworzony kontakt otwiera się do edycji. Możesz zmienić nazwę, dodać więcej informacji i zapisać.

P: Czy moduł obsługuje numery międzynarodowe?

O: Tak, pełna obsługa różnych formatów i kodów krajowych.

P: Czy dane są bezpieczne?

O: Moduł wymaga zalogowania do Odoo. Wszystkie operacje są logowane przez Odoo.

Parametry URL (Advanced)

Moduł obsługuje dodatkowe parametry dla zaawansowanych użytkowników:

Przykłady:

# Otwiera w przeglądarce (domyślnie) https://odo.ovh/contact_by_phone?phone=+48123456789 # Otwiera w Odoo Chrome App https://odo.ovh/contact_by_phone?phone=+48123456789&app=chrome