API di WhatsApp: Tipi, Accesso, Prezzi e Limiti
Collega un account WhatsApp esistente
const account = await client.account.CollegaWhatsapp();
account.qrCodeString -> mostralo all'utente
// oppure passa un pairing_phone_number
const chat = await client.chat.list({
account_type: 'WHATSAPP'
});
Che cos'è l'API di WhatsApp?
| Nome | Cos'è | Chi lo gestisce | Requisiti di accesso |
|---|---|---|---|
| Piattaforma WhatsApp Business API Cloud | L'API ufficiale di Meta per il provisioning di nuovi numeri di telefono aziendali e l'invio di messaggi con modelli su scala | Meta | App sviluppata per Meta, WABA, numero di telefono aziendale, verifica per i livelli superiori |
| Accesso come Business Solution Provider (BSP) | Una terza parte (Twilio, 360dialog e simili) che rivende la stessa Cloud API, racchiusa nella propria dashboard e fatturazione | Infrastruttura Meta, gestita da BSP | Stessi requisiti sottostanti di Meta, forniti tramite il BSP |
| API di sessione unificata (Unipile) | Collega un account WhatsApp, aziendale o personale, nello stesso modo in cui fa WhatsApp Web, tramite codice QR o codice di associazione | Unipile, per conto dell'utente autenticato | Nessuna verifica Meta Business, nessun nuovo numero, nessuna approvazione dei modelli |
Quali sono i diversi tipi di API di WhatsApp?
| Tipo | Provisioning | Il migliore per | Funziona con un account esistente |
|---|---|---|---|
| API del cloud | Nuovo numero di telefono aziendale + verifica Meta Business per volumi più elevati | Aziende che inviano marketing ad alto volume o notifiche su larga scala | No, richiede un nuovo numero |
| API On-Premise | Deprecato. Meta lo ha dismesso e ha promosso la migrazione alla Cloud API. | Solo integrazioni legacy | No |
| App WhatsApp Business | App gratuita per i consumatori, configurazione manuale su un dispositivo | Le piccole imprese che gestiscono le chat a mano | Sì, ma manualmente, un dispositivo alla volta, non in modo programmatico |
| API di sessione unificata (Unipile) | Collega l'account nello stesso modo in cui fa WhatsApp Web, nessun nuovo numero | Piattaforme SaaS che integrano l'account WhatsApp di ciascun utente direttamente nel prodotto | Sì, questo è il caso d'uso principale |
Ecosistema API di WhatsApp
Meta offre due API ufficiali che consentono alle aziende di integrare WhatsApp nel proprio software. Entrambe sono progettate per abilitare messaggistica ad alto volume, con funzionalità quali messaggi predefiniti, condivisione di contenuti multimediali e strumenti di assistenza clienti.
API di WhatsApp Business
L'API Business è stata la prima soluzione rilasciata da Meta per aiutare le aziende a interagire con i propri clienti su WhatsApp. È tipicamente self-hosted o gestita da un provider approvato, dando alle aziende un maggiore controllo sull'infrastruttura. Supporta messaggi in uscita templati, risposte ai clienti e formati rich media, rendendola adatta alle aziende che hanno bisogno di integrare WhatsApp direttamente nel proprio CRM, contact center o sistema di assistenza.
WhatsApp Cloud API
Lanciato successivamente, il Cloud API è completamente ospitato da Meta. Ciò elimina la necessità per le aziende di gestire server o infrastrutture pesanti. L'API Cloud offre funzionalità di base simili, come l'invio e la ricezione di messaggi, la gestione dei modelli e il supporto dei media, ma è più facile da implementare per gli sviluppatori. È un modo più veloce per accedere a WhatsApp in modo programmatico, soprattutto per le aziende che desiderano la scalabilità senza i costi generali dell'hosting on-premise.
La complessità dell'integrazione di WhatsApp
Sebbene le API Business e Cloud di Meta offrano potenti funzionalità, la loro integrazione è tutt'altro che semplice. Gli sviluppatori devono gestire la verifica aziendale, l'approvazione dei modelli e le quote dei messaggi prima ancora di andare online. L'hosting o la connessione all'API Cloud richiede inoltre la gestione dei webhook, della crittografia e la conformità con rigide regole di opt-in. Questi ostacoli spesso ritardano i progetti e limitano l'accesso ai fornitori SaaS più piccoli che desiderano aggiungere rapidamente WhatsApp alle loro piattaforme.