Integrazione delle chiamate SIP WhatsApp

Panoramica

WhatsApp ora supporta le chiamate SIP tramite l’API WhatsApp Cloud, consentendo di effettuare chiamate vocali utilizzando il protocollo SIP su TLS/SRTP.

Ciò consente un’integrazione nativa tra WhatsApp e 3CX, estendendo l’integrazione esistente, limitata alla messaggistica, per supportare anche le chiamate vocali di WhatsApp, che possono essere instradate verso interni 3CX, code, sistemi IVR o agenti IA.

Si noti che l’attuale implementazione per le chiamate vocali supporterà solo le chiamate WhatsApp in entrata verso 3CX.

Prerequisiti

  • Per abilitare WhatsApp SIP è necessario che nel portale per sviluppatori di Meta sia presente un’applicazione WhatsApp attiva, dotata delle autorizzazioni di messaggistica relative al numero di telefono aziendale per il quale si desidera abilitare il protocollo SIP.
  • Se non hai ancora effettuato la configurazione sopra indicata, segui i passaggi illustrati nella nostra Guida all’integrazione di WhatsApp e ottieni l’ID del numero di telefono e il token di accesso utente indicati nella guida, necessari per autenticare le richieste richieste all’API Graph di Meta per l’abilitazione del protocollo SIP.
  • Poiché l’abilitazione delle chiamate SIP sulla propria applicazione WhatsApp non è attualmente disponibile tramite il portale UI di Meta, è necessario utilizzare uno strumento di terze parti come Postman per inviare richieste POST all’API Graph di Meta.
  • Per integrare più numeri di telefono WhatsApp contemporaneamente, ogni numero deve essere associato a una propria applicazione WhatsApp distinta all’interno del portale Meta for Developers. Il processo di configurazione descritto in questa guida, dalla creazione di un’applicazione WhatsApp alla configurazione del trunk SIP su 3CX, deve essere ripetuto per ogni numero di telefono WhatsApp che si desidera integrare.
  • Per ulteriori informazioni, consultare la Guida ufficiale per WhatsApp SIP.

Passo 1: Creare un’applicazione WhatsApp

  • Se hai già configurato la messaggistica WhatsApp sul tuo 3CX, puoi saltare questo passaggio e recuperare l'ID del numero di telefono e il token di accesso utente dalla configurazione WhatsApp già presente in 3CX, nella Admin console > Voce e chat > Il tuo trunk di messaggistica WhatsApp
  • In caso contrario, segui i passaggi illustrati nella nostra Guida all'integrazione di WhatsApp e recupera l'ID del numero di telefono e il token di accesso utente

Passo 2: Abilitare il protocollo SIP sul tuo numero WhatsApp

  • Invia la seguente richiesta POST all’API Graph di Meta utilizzando curl o qualsiasi altro strumento.
  • Puoi importare il comando curl direttamente in Postman selezionando “File → Importa” e incollando:

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>

          }

        ]

      }

    }

  }'

  • Assicurati di sostituire i seguenti elementi con i tuoi dati nel comando sopra riportato prima di inviarlo:
  • <PHONE_NUMBER_ID> = L'ID del numero di telefono ottenuto al punto 1 sopra,
  • <YOUR_ACCESS_TOKEN> = Il token di accesso utente ottenuto al punto 1 sopra,
  • <YOUR_3CX_FQDN> = Il FQDN del tuo centralino 3CX; ad esempio:  mypbx.3cx.com,
  • <YOUR_SIPS_PORT> = Di solito 5061 se il tuo centralino utilizza le porte predefinite.
  • Se la richiesta va a buon fine:

{"success":true}

  • Dovresti ricevere una risposta di successo in curl

  • Oppure in Postman

Passo 3: Verificare la configurazione SIP

  • Invia la seguente richiesta GET all’API Graph di Meta:

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>"

  • Assicurati di sostituire le seguenti parti con le tue informazioni nel comando sopra riportato prima di inviarlo:
  • <PHONE_NUMBER_ID> = L'ID del numero di telefono ottenuto al punto 1 sopra
  • <YOUR_ACCESS_TOKEN> = Il token di accesso utente ottenuto al punto 1 sopra
  • Se la richiesta va a buon fine, dovresti ricevere una risposta simile alla seguente:

{

    "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"

    }

}

  • In curl

  • Oppure in Postman

Passo 4: Abilitare le impostazioni delle chiamate in WhatsApp Business Manager

  • Se la voce “Numeri di telefono” non è visibile, clicca su “Tutti gli strumenti”

  • Apri la scheda Impostazioni chiamate e assicurati di aver abilitato le seguenti opzioni:
  • Consenti chiamate vocali
  • Consenti richiamate
  • Mostra i pulsanti di chiamata

Passo 5: Creare un trunk SIP su 3CX

Per creare il tuo nuovo trunk SIP WhatsApp:

  • Scarica il modello WhatsApp da qui
  • Nella tua console di amministrazione 3CX, vai alla scheda Admin → Avanzate → Modelli → Modelli provider
  • Clicca sul pulsante “Importa provider”, seleziona il modello scaricato in precedenza e clicca sul pulsante “Importa”:

  • Imposta un nome per il tuo nuovo trunk SIP WhatsApp
  • Imposta il percorso predefinito per le chiamate SIP WhatsApp in entrata
  • Deseleziona la casella di controllo Crea una regola in uscita
  • Imposta il numero del trunk principale sul tuo numero WhatsApp
  • Lascia tutti gli altri campi ai valori predefiniti
  • Clicca sul pulsante “Salva”
  • Ora potrai accettare le chiamate WhatsApp in entrata sul tuo numero WhatsApp, che verranno inoltrate alla destinazione 3CX selezionata.

In alternativa, puoi creare manualmente un trunk SIP generico su 3CX, assicurandoti di utilizzare la seguente configurazione:

  • Tipo di autenticazione: Basato su IP
  • Host: wa.meta.vc
  • Porta: Rilevamento automatico
  • Protocollo di trasporto: TLS
  • Modalità SRTP: Obbligatoria
  • Codec: OPUS

Per saperne di più

Ultimo aggiornamento

Il presente documento è stato aggiornato il 21 agosto 2026.

https://www.3cx.com/docs/whatsapp-sip-calling-integration/