WhatsApp API: Types, Access, Prezzi and Limits
// Link an existing WhatsApp account
const account = await client.account.connectWhatsapp();
// account.qrCodeString -> show to the user
// or pass a pairing_phone_number instead
const chat = await client.chat.list({
account_type: 'WHATSAPP'
});
Che cos'è l'API di WhatsApp?
| Nome | Cos'è | Who operates it | Access requirements |
|---|---|---|---|
| WhatsApp Business Platform (Cloud API) | Meta's own official API for provisioning new business phone numbers and sending template messages at scale | Meta | Meta developer app, WABA, business phone number, verification for higher tiers |
| Business Solution Provider (BSP) access | A third party (Twilio, 360dialog and similar) reselling the same Cloud API, wrapped in its own dashboard and billing | Meta infrastructure, BSP-managed | Same underlying Meta requirements, provisioned through the BSP |
| Unified session API (Unipile) | Connects a WhatsApp account, business or personal, the way WhatsApp Web does, by QR code or pairing code | Unipile, on behalf of the authenticated user | No Meta Business verification, no new number, no template approval |
What are the different types of WhatsApp API?
| Tipo | Provisioning | Il migliore per | Works with an existing account |
|---|---|---|---|
| API del cloud | New business phone number + Meta Business verification for higher volume | Companies sending high-volume marketing or notifications at scale | No, requires a new number |
| On-Premise API | Deprecated. Meta retired it and pushed migration to the Cloud API | Legacy integrations only | No |
| App WhatsApp Business | Free consumer-facing app, manual setup on one device | Small businesses managing chats by hand | Yes, but manually, one device, not programmatic |
| Unified session API (Unipile) | Links the account the way WhatsApp Web does, no new number | SaaS platforms embedding each user's own WhatsApp account in-product | Yes, this is the primary use case |
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.