Integracja połączeń WhatsApp SIP

Informacje ogólne

WhatsApp obsługuje teraz połączenia SIP za pośrednictwem WhatsApp Cloud API, umożliwiając wykonywanie połączeń głosowych przy użyciu protokołu SIP przez TLS/SRTP.

Pozwala to na natywną integrację między WhatsApp a 3CX, rozszerzając dotychczasową integrację (ograniczoną tylko do wiadomości) o obsługę połączeń głosowych WhatsApp. Połączenia te mogą być kierowane do numerów wewnętrznych 3CX, kolejek, wirtualnych recepcjonistów (IVR) lub Agentów AI.

Należy pamiętać, że obecna implementacja połączeń głosowych obsługuje wyłącznie połączenia przychodzące z WhatsApp do 3CX.

Wymagania wstępne

  • Włączenie funkcji WhatsApp SIP wymaga posiadania aktywnej aplikacji WhatsApp („Live WhatsApp Application”) w portalu Meta for Developers z uprawnieniami do przesyłania wiadomości dla firmowego numeru telefonu, dla którego chcesz włączyć SIP.
  • Jeśli nie masz jeszcze skonfigurowanej powyższej aplikacji, postępuj zgodnie z krokami opisanymi w naszym przewodniku integracji WhatsApp i uzyskaj identyfikator numeru telefonu („Phone number ID”) oraz token dostępu użytkownika („User Access Token”). Będą one potrzebne do uwierzytelnienia żądań do interfejsu Graph API firmy Meta w celu włączenia SIP.
  • Ponieważ włączanie połączeń SIP w aplikacji WhatsApp nie jest obecnie dostępne bezpośrednio w portalu Meta, musisz użyć zewnętrznego narzędzia, takiego jak Postman, aby wysłać żądania POST do Meta Graph API.
  • Aby zintegrować wiele numerów telefonów WhatsApp jednocześnie, każdy numer musi być powiązany z własną, oddzielną aplikacją WhatsApp w portalu Meta for Developers. Proces konfiguracji opisany w tym przewodniku – od utworzenia aplikacji WhatsApp po konfigurację SIP Trunku w 3CX – musi zostać powtórzony dla każdego numeru telefonu WhatsApp, który chcesz zintegrować.
  • Więcej informacji znajdziesz w oficjalnym przewodniku Official Guide for WhatsApp SIP.

Krok 1: Utworzenie aplikacji WhatsApp

  • Jeśli masz już skonfigurowaną obsługę wiadomości WhatsApp w 3CX, możesz pominąć ten krok i pobrać swój „Phone number ID” oraz „User Access Token” z aktualnej konfiguracji WhatsApp w Konsoli Administracyjnej: „Admin” → „Voice & Chat” (Głos i czat) → „Your WhatsApp Messaging Trunk” (Twój SIP Trunk wiadomości WhatsApp).
  • Jeśli nie, postępuj zgodnie z krokami opisanymi w naszym przewodniku integracji WhatsApp i uzyskaj „Phone number ID” oraz „User Access Token”.

Krok 2: Włączenie obsługi SIP dla numeru WhatsApp

  • Wyślij poniższe żądanie POST do Meta Graph API, używając narzędzia curl lub dowolnego innego.
  • Możesz zaimportować polecenie curl bezpośrednio do programu Postman, przechodząc do „File” (Plik) → „Import” (Importuj) i wklejając:

curl -X POST "https://graph.facebook.com/v24.0/<PHONE_NUMBER_ID>/settings" \

  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \

  -H "Content-Type: application/json" \

  -d '{

    "calling": {

      "status": "ENABLED",

      "callback_permission_status": "ENABLED",

      "call_icon_visibility": "DEFAULT",

      "srtp_key_exchange_protocol": "SDES",

      "sip": {

        "status": "ENABLED",

        "servers": [

          {

            "hostname": "<YOUR_3CX_FQDN>",

            "port": <YOUR_SIPS_PORT>

          }

        ]

      }

    }

  }'

  • Przed wysłaniem upewnij się, że zastąpiłeś poniższe parametry własnymi danymi:
  • <PHONE_NUMBER_ID> = identyfikator numeru telefonu uzyskany w kroku 1.
  • <YOUR_ACCESS_TOKEN> = token dostępu użytkownika uzyskany w kroku 1.
  • <YOUR_3CX_FQDN> = FQDN Twojej centrali 3CX; na przykład: mojapbx.3cx.pl.
  • <YOUR_SIPS_PORT> = zazwyczaj 5061, jeśli Twoja centrala korzysta z domyślnych portów.
  • Jeśli żądanie zakończy się sukcesem, powinieneś otrzymać odpowiedź:

{"success":true}

  • Powinieneś otrzymać odpowiedź o powodzeniu w curl.

  • Lub w programie Postman.

Krok 3: Weryfikacja konfiguracji SIP

  • Wyślij poniższe żądanie GET do Meta Graph API:

curl -X GET "https://graph.facebook.com/v17.0/<PHONE_NUMBER_ID>/settings?fields=calling&include_sip_credentials=true" \

  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"

  • Przed wysłaniem upewnij się, że zastąpiłeś poniższe parametry własnymi informacjami w powyższym poleceniu:
  • <PHONE_NUMBER_ID> = identyfikator numeru telefonu uzyskany powyżej w kroku 1.
  • <YOUR_ACCESS_TOKEN> = token dostępu użytkownika uzyskany powyżej w kroku 1.
  • Jeśli żądanie zakończy się sukcesem, powinieneś otrzymać odpowiedź podobną do poniższej:

{

    "calling": {

        "status": "ENABLED",

        "call_icon_visibility": "DEFAULT",

        "callback_permission_status": "ENABLED",

        "srtp_key_exchange_protocol": "SDES",

        "sip": {

            "status": "ENABLED",

            "servers": [

                {

                    "app_id": 112233445566778,

                    "hostname": "pbx.3cx-example.com",

                    "port": 5061,

                    "sip_user_password": "aabbccddeeffgghhiijjkkllmmnnoopp"

                }

            ]

        }

    },

    "storage_configuration": {

        "status": "DEFAULT"

    }

}

  • W curl.

  • Lub w programie Postman.

Krok 4: Włączenie ustawień połączeń w WhatsApp Business Manager

  • Otwórz zakładkę „Call Settings” (Ustawienia połączeń) i upewnij się, że włączyłeś następujące opcje:
  • „Allow voice calls” (Zezwalaj na połączenia głosowe)
  • „Allow callbacks” (Zezwalaj na oddzwanianie)
  • „Display call buttons” (Wyświetlaj przyciski połączeń)

Krok 5: Utworzenie SIP Trunk w 3CX

Aby utworzyć nowy SIP Trunk dla WhatsApp:

  • Pobierz szablon WhatsApp tutaj.
  • W Konsoli Administracyjnej 3CX przejdź do zakładki „Admin” → „Advanced” (Zaawansowane) → „Templates” (Szablony) → „Provider Templates” (Szablony operatorów).
  • Kliknij przycisk „Import Provider” (Importuj operatora), wybierz pobrany wcześniej szablon i kliknij przycisk „Import” (Importuj).

  • Ustaw „Name” (Nazwa) dla swojego nowego SIP Trunku WhatsApp.
  • Ustaw „Default route” (Domyślna trasa) dla przychodzących połączeń WhatsApp SIP.
  • Odznacz pole wyboru „Create an outbound rule” (Utwórz regułę wychodzącą).
  • W polu „Main Trunk Number” (Główny numer trunku) wpisz swój numer WhatsApp.
  • Pozostaw wszystkie inne pola z wartościami domyślnymi.
  • Kliknij przycisk „Save” (Zapisz).
  • Teraz będziesz mógł odbierać połączenia przychodzące na swój numer WhatsApp, które będą dostarczane do wybranego miejsca docelowego w 3CX.

Alternatywnie możesz ręcznie utworzyć generyczny SIP Trunk („Generic SIP Trunk”) w 3CX, upewniając się, że używasz następującej konfiguracji:

  • Authentication Type (Typ uwierzytelniania): IP-based (Oparte na IP)
  • Host: wa.meta.vc
  • Port: Auto discovery (Autowykrywanie)
  • Transport Protocol (Protokół transportowy): TLS
  • SRTP Mode (Tryb SRTP): Enforced (Wymuszony)
  • Codecs (Kodeki): OPUS

Zobacz również



Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 3 sierpnia 2026 r.
https://www.3cx.pl/docs/integracja-polaczen-whatsapp-sip/