Come Ottenere l’API di WhatsApp Business (WhatsApp Business Platform)

L’API di WhatsApp Business (ufficialmente chiamata WhatsApp Business Platform) è un’interfaccia di programmazione offerta da Meta per medie e grandi imprese. A differenza dell’App WhatsApp Business standard, l’API non ha un’interfaccia utente propria (come un’app), ma deve essere integrata in un software di terze parti (come piattaforme di customer service, helpdesk o CRM).

1. Requisiti Fondamentali

Prima di poter richiedere l’accesso all’API, la tua azienda deve soddisfare alcuni requisiti:

• Meta Business Account: Devi possedere un Meta Business Account (ex Facebook Business Manager) verificato e attivo.

• WhatsApp Business Profile: Un profilo WhatsApp Business conforme alle politiche di messaggistica e commerce di WhatsApp e Meta.

• Numero di Telefono Dedicato: Avrai bisogno di un numero di telefono che sarà dedicato esclusivamente all’uso dell’API. Questo numero non deve essere attualmente registrato o in uso su alcuna app WhatsApp (né standard né Business).

2. Le Due Vie Principali per Ottenere l’API

L’API di WhatsApp Business viene fornita tramite due canali principali:

Metodo A: Utilizzo di un Business Solution Provider (BSP)

Questa è la via più comune, veloce e raccomandata per la maggior parte delle aziende. I BSP (Business Solution Providers) sono partner ufficiali di Meta, certificati per fornire l’infrastruttura, il hosting e la piattaforma software necessaria per utilizzare l’API.

1. Scegliere un BSP: Seleziona un BSP ufficiale (es. Twilio, MessageBird, o piattaforme focalizzate sul customer engagement come respond.io, Zendesk, ecc.). La scelta dipende dalle funzionalità aggiuntive che desideri (CRM, chatbot AI, gestione multicanale).

2. Registrazione e Creazione Account: Registrati sulla piattaforma del BSP scelto.

3. Configurazione Guidata: Il BSP ti guiderà attraverso la configurazione, che in genere include:

   • Verifica del Meta Business Account.

   • Registrazione del Numero di Telefono: Il BSP gestirà la richiesta a Meta per l’approvazione del tuo numero per l’API.

   • Integrazione: Il numero verrà configurato sulla piattaforma del BSP, che funge da interfaccia utente (casella di posta condivisa) per il tuo team.

Vantaggio: Gestione semplificata di hosting, sicurezza, conformità alle normative e aggiornamenti dell’API.

Metodo B: Configurazione Diretta tramite Meta Cloud API

Meta offre anche l’opzione di utilizzare la Cloud API, che hosta l’API direttamente sui server di Meta.

1. Accesso al Meta for Developers: Vai al portale Meta for Developers e accedi con le tue credenziali.

2. Creazione dell’App: Crea una nuova “App” con tipo Business e seleziona WhatsApp come prodotto.

3. Configurazione e Test: Meta ti fornirà un numero di telefono di prova e un token temporaneo per iniziare immediatamente a sviluppare e testare l’integrazione.

4. Numero Definitivo: Per passare all’uso di un numero definitivo (il tuo numero aziendale), dovrai:

   • Fornire il tuo Meta Business ID e completare la Verifica del Business su Meta.

   • Aggiungere il tuo numero di telefono (che non deve essere attivo su nessuna app WhatsApp).

   • Completare la procedura di verifica del numero tramite codice SMS/vocale.

5. Sviluppo: Questa opzione richiede che la tua azienda disponga di sviluppatori che possano integrare direttamente l’API nel tuo software (CRM, backend personalizzato, ecc.).

Vantaggio: Controllo completo sull’infrastruttura e nessun costo di intermediazione del BSP (solo i costi di messaggistica di Meta).

3. Modelli di Messaggio (Templates) e Costi

L’utilizzo dell’API ha regole specifiche, in particolare riguardo ai messaggi:

• Messaggi Iniziali del Cliente: Le conversazioni avviate dal cliente sono gratuite per le prime 24 ore.

• Messaggi Attivi dell’Azienda: Se l’azienda desidera avviare una conversazione (al di fuori della finestra di 24 ore) o inviare notifiche (es. alert ordini), deve utilizzare i Modelli di Messaggio (Message Templates).

• Approvazione dei Modelli: Ogni Modello di Messaggio deve essere approvato preventivamente da Meta (tramite il BSP o la Cloud API) prima di poter essere utilizzato.

Costi: I costi dell’API non sono un abbonamento, ma sono basati sul modello delle conversazioni. Meta addebita un costo per ogni “finestra di conversazione” di 24 ore (sia avviata dal cliente che dall’azienda). Le tariffe variano in base al Paese.