Definizione
La WhatsApp Business API è l’interfaccia programmatica di Meta che permette alle aziende medie e grandi di inviare e ricevere messaggi WhatsApp dal proprio software, su larga scala, tramite un numero di telefono aziendale verificato. Oggi viene erogata come Cloud API di Meta.
La WhatsApp Business API è la parte rivolta agli sviluppatori della piattaforma WhatsApp Business. Invece di scrivere in un’app sul telefono, un’azienda invia messaggi con richieste HTTP che trasportano payload JSON, e riceve le risposte dei clienti e gli stati di consegna tramite webhook. Meta ospita l’infrastruttura come Cloud API, basata sulla Graph API.
Due regole condizionano quasi ogni implementazione. Primo, un’azienda può inviare messaggi liberi solo dentro una finestra di assistenza clienti di 24 ore che il cliente apre scrivendo all’azienda. Secondo, fuori da quella finestra può inviare solo modelli di messaggio (template) pre-approvati, classificati come marketing, utilità o autenticazione e addebitati per messaggio consegnato.
Le aziende raggiungono di solito l’API tramite un partner come un Business Solution Provider, che gestisce l’attivazione (spesso con Embedded Signup), la fatturazione, il supporto alla conformità e strumenti come una casella condivisa o un gestore di campagne. L’azienda resta comunque titolare del proprio account WhatsApp Business e del numero di telefono.
Nel GCC e in tutta l’area MENA, WhatsApp è un canale principale con i clienti per banche, rivenditori, compagnie aeree e servizi pubblici, quindi l’API è comunemente usata per aggiornamenti di ordini e consegne, promemoria di appuntamenti, codici OTP e assistenza clienti in arabo e inglese.
Un errore comune è trattare l’API come un invio di SMS massivi. I messaggi richiedono l’opt-in, i template devono corrispondere alla loro categoria e uno scarso coinvolgimento abbassa le valutazioni di qualità, il che può sospendere i template e rallentare la crescita dei limiti di messaggistica.
Esempio
POST https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages con {"messaging_product":"whatsapp","to":"971501234567","type":"template","template":{"name":"order_shipped","language":{"code":"en"}}}