Configurazione di Facebook

Introduzione

L'integrazione con Facebook consente ai tuoi operatori di rispondere ai messaggi della tua Pagina Facebook direttamente da 3CX senza dover accedere a Facebook Messenger. I messaggi possono essere indirizzati a una coda di chiamata, a un gruppo di suoneria o a un singolo interno. Gli operatori possono assumere la gestione di un messaggio o trasferirlo a un altro operatore o gruppo.

È necessario un account Facebook Business verificato.

La guida riportata di seguito segue l'aggiornamento del 2026 relativo al flusso di creazione delle app di Meta, con opzioni di autorizzazione semplificate.

Passo 1: Avvia la configurazione sul tuo 3CX

  • Accedere al tuo web client 3CX, andare su Admin → Voce e chat e cliccare su + Aggiungi messaggistica → Aggiungi Facebook.
  • Impostare il nome che preferisci.
  • Se sei un proprietario o un amministratore di sistema, puoi rendere l’integrazione disponibile a livello di sistema o solo per il gruppo.

  • Copiare l’URL del webhook 3CX in un editor di testo e tienilo a portata di mano.

Passo 2: Creare un’applicazione Facebook

  • Andare alla sezione Le mie app.
  • Cliccare su Crea app.
  • Assegnare un nome visualizzato alla tua applicazione, inserisci un indirizzo e-mail di contatto, quindi cliccare su Avanti.
  • Selezionare l’opzione Messaggistica aziendale.

  • Selezionare l’opzione Messenger di Meta, quindi cliccare su Avanti.
  • Scegliere il portafoglio aziendale a cui desideri collegare questa app; puoi scegliere di aggiungerlo in un secondo momento.
  • Se Meta prevede altri requisiti di pubblicazione che devi soddisfare prima di procedere, questi verranno elencati in questa schermata.
  • Cliccare su Avanti.

  • Prima di creare l’app, assicurarsi che il nome dell’app, l’indirizzo e-mail di contatto e gli altri dettagli siano corretti; cliccare su Crea app.
  • Confermare la password se richiesto.

  • La schermata successiva è la Dashboard dell'app:
  • Qui verrà visualizzato un elenco delle attività da completare prima della pubblicazione.
  • È necessario assicurarsi che tutte le attività richieste siano state completate.
  • Nel caso in cui si esca dal portale Facebook Developers, è possibile tornare a questo punto tramite la voce di menu Casi d'uso (icona a forma di matita).
  • Selezionare l’opzione Personalizza:
  • Scegliere Impostazioni API di Messenger.

  • Espandere Configura webhook:
  • Inserire il webhook salvato nel Passo 1 nel campo URL di callback.
  • Inserire la stringa lunga che segue l’ultimo “/” (ad es. aabbccddeeff000000001122334455) alla fine del webhook nel campo Verifica token.

  • Scorri verso il basso e aggiungi i campi Webhook richiesti utilizzando l’ultima versione dell’API disponibile:
  • messages
  • message_deliveries
  • messaging_customer_information
  • message_reads
  • message_echoes
  • Cliccare su Verifica e salva.

  • Espandere Genera token di accesso:
  • Cliccare su Aggiungi una pagina:
  • Completare la procedura di autenticazione e scegliere la pagina aziendale che desideri aggiungere.
  • Una volta aggiunta la pagina, prendere nota dell’ID della pagina Facebook.
  • Selezionare l’opzione di menu Aggiungi sottoscrizioni Webhook e aggiungi:

  • messages
  • message_deliveries
  • messaging_pre_checkouts
  • messaging_customer_information
  • message_reads
  • message_echoes
  • Cliccare su Genera per ottenere un token API e salvarlo.
  • Se torni a questa pagina, puoi passare il mouse sulle Sottoscrizioni per visualizzare l’opzione Modifica.
  • Per ora, NON procedere con Completa la revisione dell’app.

Passo 3: Proseguire con la configurazione in 3CX

  • Accedere alla sezione Utenti e creare un utente di prova temporaneo che verrà utilizzato per il processo di revisione dell'applicazione descritto nel Passo 4 riportato di seguito.
  • Incollare l'ID pagina e il token di accesso ottenuti durante il Passo 2.
  • Assicurarsi che l'instradamento dei messaggi sia configurato per il nuovo utente di prova temporaneo.

Passo 4: Modalità di sviluppo

La tua applicazione è ora configurata per funzionare con 3CX e puoi provare a inviare un messaggio alla tua pagina Facebook.

In questa fase, la tua app è in modalità di sviluppo, il che significa che puoi interagire solo con:

  • utenti che dispongono dell’autorizzazione a gestire la tua pagina
  • utenti che sono stati aggiunti come tester.

Puoi aggiungere altri utenti di prova tramite Dashboard dell’app > Ruoli > Ruoli dell’app > Aggiungi persone.

In modalità Sviluppo, in 3CX sarà visibile solo l’ID numerico dell’utente Facebook. Per visualizzare il nome completo dell’utente Facebook è necessario passare alla modalità “Live”.

Per passare alla modalità Live, devi richiedere autorizzazioni aggiuntive ed eseguire una revisione dell’applicazione; i dettagli sono riportati nel passaggio Revisione dell’applicazione.

Passo 5: Revisione dell’app

  • Dalla dashboard di Meta App, andare su Impostazioni app > Base.

  • Inserire i dettagli richiesti:
  • URL dell’informativa sulla privacy
  • URL per la cancellazione dei dati degli utenti (può essere lo stesso URL dell’informativa sulla privacy)
  • Categoria (scegli Messaggistica o Azienda)
  • Caricare un’icona dell’app
  • A seconda della tua regione e del tuo settore di attività, potrebbe essere necessario compilare la sezione relativa al GDPR sotto le impostazioni principali.
  • Selezionare + Aggiungi piattaforma nella parte inferiore della pagina.
  • Inserire l’URL del tuo sito web e cliccare su Avanti.

  • Inserire l'URL del tuo 3CX, ad esempio https://mypbx.3cx-example.com.
  • Cliccare su Salva modifiche.
  • Dal menu laterale, cliccare su Casi d'uso (icona a forma di matita).
  • Cliccare su Personalizza e aggiungere l'autorizzazione di accesso Profilo utente Business Asset.
  • Cliccare su Impostazioni API Messenger.
  • Cliccare su Personalizza caso d'uso.
  • Da Autorizzazioni e funzionalità, aggiungi Accesso al profilo utente Business Asset.

  • Cliccare sul pulsante Richiedi autorizzazione:

  • Selezionare le opzioni pages_show_list e pages_manage_metadata; cliccare sul pulsante Richiedi autorizzazione. Verrai reindirizzato alla pagina Invia per la revisione dell’app.
  • Aprire il tuo 3CX ed effettua l’accesso come (o impersonando) l’utente di prova; andare su Chat nel client web.
  • Aprire la tua pagina Facebook collegata utilizzando un account con diritti di test per l’app.
  • Disporre le due finestre affiancate e avviare una registrazione dello schermo; ciò è necessario per la revisione e la verifica da parte di Facebook.
  • Effettuare una breve conversazione tramite messaggi e salvare il video.
  • Tornare alla pagina Invia per la revisione dell’app di Facebook e cliccare su Avanti.

  • Completare tutti i passaggi, compilando tutti i dettagli, fino a raggiungere la sezione Istruzioni per il revisore. È necessario disporre di un account verificato per procedere.

  • Nella pagina delle istruzioni per il revisore:
  • Confermare l'URL del tuo sito.
  • Compilare i campi delle domande come segue:

(instructions-web-2) Fornisci le istruzioni per accedere all'app in modo che possiamo completare la nostra revisione.

Questa app di Facebook viene utilizzata per integrare un sistema telefonico 3CX (https://3cx.com) con le chat di Facebook Messenger. Ogni cliente 3CX dispone di una propria istanza 3CX e dovrà quindi creare la propria app per integrare una pagina Facebook. L’autorizzazione «pages_messaging» è necessaria per ricevere e inviare messaggi avviati da un visitatore della pagina Facebook.

Passo 1. Accedere al Web Client 3CX con le seguenti credenziali:

  • URL del WebClient PBX: https://example-pbx.3cx.com/

Passo 2. Scrivere e inviare un messaggio di prova sulla pagina Facebook.

Passo 3. Ricevere e rispondere al messaggio nel Web Client 3CX.

  • Se per accedere a tutte le funzionalità di questa app è richiesto un pagamento o un abbonamento:
  • Interno: ________
  • Password: ________
  • (documents-web-1) Allegare la documentazione di supporto:
  • Caricare il video registrato in precedenza.
  • Cliccare su Avanti.
  • Una volta completate tutte le sezioni, è possibile inviare la richiesta per la revisione.

L’app può essere pubblicata tramite il pulsante Pubblica nel menu laterale. Se la si pubblica prima dell’approvazione, è possibile ricevere messaggi in generale, ma senza il nome del mittente o altri dettagli.

Una volta approvata la richiesta, si riceveranno messaggi dagli utenti di Facebook con il nome del mittente. Assicurarsi di eliminare l’utente di prova temporaneo creato per il processo di verifica dell’app e di aggiornare l’instradamento dei messaggi verso la destinazione desiderata.

Per saperne di più

Ultimo aggiornamento

Questo documento è stato aggiornato il 19 agosto 2026.

https://www.3cx.it/doc/manuale/facebook/ 

Discuti questo articolo