Piattaforma WhatsApp Business

Primi passi

Questo documento descrive i passaggi e i requisiti necessari per integrare il flusso di iscrizione integrata nel tuo sito web o nel portale client.

Prima di iniziare

Per iniziare l'integrazione del flusso di iscrizione integrata, devi prima avere configurato un Business Manager e un'app di Meta.

Business Manager

È necessario un account Business Manager per gestire la linea di credito e l'account WhatsApp Business (WABA) del cliente. Per informazioni sulla creazione di un account business, consulta Creazione di un account Business Manager. Dopo aver configurato un Business Manager, esegui la verifica dell'azienda.

App di Meta

Dal tuo account sviluppatore di Meta, crea un'app di tipo business. Dalla scheda delle app puoi accedere a qualsiasi app di Meta per controllare le impostazioni e richiedere le autorizzazioni.

Le app business vengono automaticamente approvate per l'accesso standard per tutte le autorizzazioni e le funzioni disponibili per il tipo di app business, in modo da poter sviluppare e testare l'app mentre ti trovi in questo livello di accesso.

L'accesso standard limita di fatto le app business al solo accesso ai dati posseduti dagli utenti dell'app che hanno un ruolo nell'app o nel Business Manager. Per essere rilasciata, la tua app di Meta deve essere sottoposta all'analisi dell'app e richiedere l'accesso avanzato all'autorizzazione whatsapp_business_management. Ti consigliamo di iniziare questa procedura il prima possibile. Per iniziare la procedura, non devi attendere il completamento dell'implementazione dell'iscrizione integrata.

Devi anche richiedere l'autorizzazione whatsapp_business_messaging per l'API WhatsApp Cloud perché è richiesta per le chiamate API.

Ti consigliamo vivamente di non richiedere ulteriori autorizzazioni in aggiunta a queste due per non rallentare inutilmente la procedura di iscrizione.

Token d'accesso

Sia i token d'accesso dell'utente di sistema con integrazione business sia i token di accesso dell'utente di sistema possono essere usati per accedere ai dati dei clienti registrati. Il tipo di token da usare dipende se stai configurando l'iscrizione integrata con Facebook Login o se la stai configurando con Facebook Login for Business e se sei un fornitore di soluzioni tecnologiche o un fornitore di soluzioni.

Fornitori di soluzioni tecnologiche

Il token preferito per i fornitori di soluzioni tecnologiche è un token d'accesso dell'utente di sistema con integrazione business, poiché questi token sono specifici per i singoli clienti. Puoi ottenere uno di questi token scambiando il codice che ti viene restituito ogni volta che un cliente completa l'iscrizione integrata configurata con Facebook Login for Business. Se usi l'iscrizione integrata configurata con Facebook Login (che non è consigliata), devi usare un token d'accesso dell'utente di sistema.

Se usi un token d'accesso dell'utente di sistema, all'utente di sistema deve aver concesso alla tua app l'autorizzazione whatsapp_business_management.

Partner di soluzioni

Devi usare un token d'accesso dell'utente di sistema per condividere la tua linea di credito con i clienti registrati. Per tutte le altre richieste, la soluzione preferita è usare un token d'accesso dell'utente di sistema con integrazione aziendale.

Puoi ottenere un token d'accesso dell'utente di sistema con integrazione business scambiando il codice che ti viene restituito ogni volta che un cliente completa l'iscrizione integrata configurata con Facebook Login for Business. Se usi l'iscrizione integrata configurata con Facebook Login (che non è consigliata), devi usare un token d'accesso dell'utente di sistema.

Tieni presente che per i token d'accesso dell'utente di sistema, il tuo utente di sistema deve aver concesso alla tua app l'autorizzazione whatsapp_business_management (che puoi concedere quando generi il token) e all'utente di sistema deve essere assegnato il ruolo di editor dei pagamenti in modo tale che possa condividere la tua linea di credito con i clienti registrati.

Per concedere al tuo utente di sistema il ruolo di editor dei pagamenti:

  1. Accedi a Meta Business Suite.
  2. Individua il tuo account business nel menu a discesa in alto a sinistra e clicca sulla relativa icona a forma di ingranaggio Impostazioni.
  3. Clicca su Impostazioni business.
  4. Accedi a Utenti > Utenti di sistema.
  5. Modifica l'utente e assegna il ruolo Editor dei pagamenti.

Linea di credito

Devi configurare una linea di credito per inviare messaggi con la piattaforma WhatsApp Business. Questa è la linea di credito che condividerai con i tuoi clienti, quindi assicurati di accettare i termini dell'API Credit Allocation in Impostazioni business > Pagamenti in Business Manager.

Per informazioni sulla condivisione della linea di credito tramite Business Manager piuttosto che tramite l'API, consulta Condivisione dell'accesso alla fatturazione mensile.

Client dell'API On-Premises della piattaforma WhatsApp Business

Se utilizzi l'API On-Premises, assicurati che la versione in uso del client dell'API di WhatsApp Business non sia scaduta.

Procedura di integrazione

Come parte della procedura di integrazione, la tua app di Meta deve essere sottoposta all'analisi dell'app e richiedere l'accesso avanzato all'autorizzazione whatsapp_business_management. Ti consigliamo di iniziare questa procedura il prima possibile. Non devi attendere che l'iscrizione integrata sia completamente implementata per iniziare questa procedura.

1: incorporamento del flusso di iscrizione

Configura l'SDK JavaScript di Facebook e Facebook Login per incorporare il flusso di iscrizione nel sito web o portale clienti. Non esitare a incorporare il flusso in più pagine web o portali di cui sei il titolare.

2: integrazione con gli endpoint necessari

Dopo l'incorporamento del flusso di iscrizione, esegui l'integrazione con gli endpoint API necessari per completare la procedura di integrazione. Per passare al passaggio successivo, devi poter:

Dopo aver completato l'iscrizione, utilizza l'endpoint message_templates per ottenere modelli di messaggi e spazi dei nomi preapprovati in modo che le aziende possano iniziare a inviare messaggi.

Devi usare un endpoint sicuro (HTTPS). Per maggiori dettagli, consulta Protezione degli accessi.

3: attivazione dell'iscrizione degli account WhatsApp Business per ricevere webhook

Dopo che le aziende hanno completato l'iscrizione, puoi attivare l'iscrizione per tutti gli account WhatsApp Business per i quali desideri ricevere webhook. Puoi configurare i webhook in modo da ricevere una notifica quando:

  • il nome di un numero di telefono viene aggiornato;
  • lo stato di qualità di un numero di telefono viene aggiornato e
  • un account è stato controllato, aggiornato o sospeso.

Facoltativo

Se vuoi, puoi effettuare anche le seguenti operazioni:

Altri contenuti da consultare