Partecipare alla comunità Slack
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 | Ideale 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.
Puoi integrare WhatsApp nel tuo software?
Come si ottiene l'accesso alle API di WhatsApp?
Di cosa hai bisogno prima di poter utilizzare l'API di WhatsApp Cloud?
Quali sono i limiti dell'API di WhatsApp?
| Limite | Valore | Note |
|---|---|---|
| Rendimento | 80 messaggi / secondo | Velocità di invio a livello di piattaforma |
| Limite di frequenza delle API | da 200 a 5.000 richieste all'ora | Si adatta in base allo stato dell'account e alla qualità |
| Limite di frequenza dell'associazione | 1 messaggio / 6 secondi | Per destinatario, impedisce l'invio di spam allo stesso utente |
| Livello di messaggistica | 250 → 2.000 → 10.000 → 100.000 → illimitati | Destinatari unici per intervallo mobile di 24 ore, parte da 250 non verificati |
È possibile utilizzare l'API di WhatsApp con un account esistente dell'App WhatsApp Business?
Come si collega un account WhatsApp a Unipile?
// SDK per Node.js
const { qrCodeString, code } = await client.account.CollegaWhatsapp();
// mostra qrCodeString all'utente come immaginePOST /api/v1/accounts
X-API-KEY: la_tua_chiave_api
{
"provider": "WHATSAPP",
"associazione_numero_di_telefono": "33612345678"
}
// 201 Creato
{
"oggetto": "AccountCreato",
"account_id": "e-ma1oQ..."
}POST /api/v1/chats/{chat_id}/messages
X-API-KEY: la_tua_chiave_api
{
"testo": "Ciao! Il tuo ordine è stato spedito."
}
// 201 Creato
{
"oggetto": "MessaggioInviato",
"ID messaggio": "msg_9f2c..."
}{
"account_id": "e-ma1oQ...",
"tipo di account": "WHATSAPP",
"evento": "messaggio ricevuto",
"chat_id": "chat_182...",
"ID messaggio": "msg_9f2c...",
"messaggio": "Ciao, questo ordine è ancora disponibile?",
"mittente": { "attendee_provider_id": "33612345678@s.whatsapp.net" },
"ora": "2026-08-04T10:15:02Z"
}Cosa puoi costruire con l'API di WhatsApp?
| Funzionalità | Cosa fa | Note |
|---|---|---|
| Inviare messaggi | Testo, contenuti multimediali, note vocali, documenti | Note vocali: .mp3/.m4a. typing_duration simula la digitazione |
| Elenca e sincronizza le chat | Inserisci ogni conversazione nel tuo database | Paginazione basata su cursore, filtra per account |
| Reagisci ai messaggi | Aggiungi una reazione con emoji a un messaggio | WhatsApp e LinkedIn |
| Inoltra messaggi | Inoltra un messaggio in un'altra chat | Solo WhatsApp |
| Modifica / elimina messaggi | Modifica o elimina un messaggio che hai inviato | Elimina: WhatsApp + LinkedIn. Modifica: WhatsApp + LinkedIn Classic |
| Webhook in tempo reale | Eventi di push: ricevuto, reazione, letto, modificato, eliminato, consegnato | Nessun sondaggio richiesto |
Elencare tutte le chat di WhatsApp nel software
GET /api/v1/chats?account_id=e-ma1oQ...&account_type=WHATSAPP&limit=50
X-API-KEY: la_tua_chiave_api
// 200 OK
{
"oggetto": "Elenco chat",
"articoli": [
{
"id": "chat_182...",
"account_id": "e-ma1oQ...",
"nome": "Jordan Miles",
"conteggio_non_letti": 2,
"archiviato": falso
}
],
"cursore": "eyJsYXN0X2..."
}Come Unipile aiuta gli sviluppatori a collegare istantaneamente WhatsApp al proprio software
Unipile offre un percorso alternativo per i fornitori SaaS che desiderano integrare WhatsApp senza passare attraverso il programma ufficiale di partner di Meta. Noi siamo non un partner MetaOffriamo invece un'API di messaggistica unificata che consente agli sviluppatori di collegare istantaneamente gli account WhatsApp personali o aziendali attraverso un flusso di autenticazione con codice QR. Questo approccio consente di aggiungere WhatsApp agli altri canali in pochi passi.
WhatsAppClassico
WhatsAppAffari
Integrazione messaggistica WhatsApp con Unipile
Con Unipile, gli sviluppatori possono integrare tutte le principali funzioni di messaggistica di WhatsApp direttamente nel loro SaaS in pochi passi. L'API supporta semplici messaggi di testo, media e sincronizzazione in tempo reale, in modo che gli utenti non perdano mai un'interazione.
LinkedIn
Gmail
Gestisci gruppi WhatsApp con API Unipile
L'API WhatsApp di Unipile consente agli sviluppatori di integrare gestione completa del gruppo direttamente nelle loro applicazioni. I tuoi utenti possono creare o unirsi a gruppi WhatsApp, inviare e rispondere a messaggi di gruppo e sincronizzare le conversazioni in tempo reale.
Che si tratti di coordinare una sessione di recruiting, gestire trattative di vendita o promuovere il coinvolgimento della community, ogni interazione di gruppo può essere centralizzata all'interno del tuo CRM o ATS. Con il supporto per testi, immagini, documenti e note vocali, i team rimangono connessi e produttivi senza lasciare la tua piattaforma.
Elenca tutto Chat di WhatsApp nel tuo software
ricciolo --richiesta GET --url https://api1.unipile.com:13111/api/v1/chats --intestazione accettare: applicazione/json
L'API di Unipile rende facile recuperare ogni chat di WhatsApp collegata a un account utente. Che si tratti di messaggi individuali, discussioni di gruppo o thread archiviati, gli sviluppatori possono estrarre elenco completo delle conversazioni con una singola richiesta. Ciò garantisce che la tua piattaforma SaaS possa centralizzare tutte le interazioni di WhatsApp in tempo reale, offrendo agli utenti un'esperienza di posta in arrivo completa e unificata.
Funzionalità API di WhatsApp con Unipile
Integra i messaggi di WhatsApp nel tuo CRM, ATS o strumento di outreach con una singola API. Sincronizza chat, gruppi e contatti in tempo reale, per conto dei tuoi utenti autenticati, senza lasciare la tua piattaforma.
Messaggi
10 endpoint disponibili
Connessione del conto
2 endpoint disponibili
Allegati
2 endpoint disponibili
Ganci web
3 eventi disponibili
L'API di WhatsApp supporta la messaggistica di gruppo?
Quali strumenti di automazione e API di WhatsApp dovresti usare nel 2026?
| Profilo | Di cosa hanno bisogno | Approccio consigliato |
|---|---|---|
| Integrazione SaaS / CRM di account di proprietà degli utenti | Ogni utente finale collega il WhatsApp (e spesso LinkedIn, Instagram, email) che ha già, all'interno del tuo prodotto | API di sessione unificata, nessuna verifica Meta per utente |
| Trasmissione aziendale su vasta scala | Un numero aziendale verificato che invia modelli di marketing o di utilità a un vasto pubblico | direttamente tramite la Cloud API di Meta o attraverso un BSP |
| Prototipazione per sviluppatori | Il percorso più rapido possibile verso un'integrazione funzionante prima di impegnarsi nell'infrastruttura | API di sessione per account di proprietà dell'utente, sandbox Cloud API per un singolo numero aziendale |
Quali sono le migliori pratiche per l'API di WhatsApp di Meta?
Dove andare dopo con l'API di WhatsApp
Perché scegliere Unipile invece di costruire su Meta
Salta i limiti delle API di Meta. Ecco come Unipile si confronta in termini di velocità, sforzo e accesso, così puoi concentrarti sulla creazione invece che sulla lotta con l'installazione.
| Criteri | Meta API | Unipile |
|---|---|---|
| Tempo di integrazione | Settimane o mesi | 2-3 giorni |
| Sforzo di sviluppo | Alto | Basso (REST + SDK) |
| Manutenzione | Manuale | Completamente gestito |
| Accesso alle funzioni | Parziale (dopo l'approvazione) | Completo, istantaneo |
| Supporto | Solo self-service | Team tecnico dedicato |
| Criteri | API Meta | Unipile |
|---|---|---|
| Tempo di integrazione | Settimane/mesi | 2-3 giorni |
| Sforzo di sviluppo | Alto | Basso (REST + SDK) |
| Manutenzione | Manuale | Completamente gestito |
| Accesso alle funzioni | Parziale (dopo l'approvazione) | Pieno, ora |
| Supporto | Solo self-service | Team tecnico dedicato |
Integrazione rapida e semplificata
Con Unipile, l'onboarding di WhatsApp richiede solo pochi minuti. Gli sviluppatori possono autenticare gli account tramite un codice QR sicuro, iniziare subito a inviare e ricevere messaggi e beneficiare di un supporto dedicato durante la configurazione. Questo approccio riduce drasticamente il time-to-market, facilitando il lancio di nuove funzionalità di messaggistica da parte degli editori SaaS.
Funzioni di messaggistica complete
L'API Unipile fornisce pieno accesso alle funzioni essenziali di WhatsApp: invio e ricezione di messaggi, note vocali, immagini, video, documenti e sincronizzazione delle conversazioni in tempo reale. Tutte le comunicazioni sono centralizzate in una casella di posta unificata, per non perdere nulla. Oltre a WhatsApp, la stessa API collega LinkedIn, Instagram, Telegram, Messenger, X/Twitter, Gmail e Outlook.
Un cruscotto per tutte le vostre integrazioni
Gestite tutti i vostri account LinkedIn, WhatsApp, Gmail e altro ancora da un'unica interfaccia intuitiva.
vogliono connettersi
Conti
03/01/2025
02/15/2025
02/10/2025
03/01/2025
02/28/2025
02/20/2025
03/01/2025
02/25/2025
03/01/2025
02/22/2025
02/14/2025
02/12/2025
02/08/2025
02/05/2025
03/01/2025
02/15/2025
03/01/2025
02/22/2025
Integrazione rapida dell'API di WhatsApp con l'autenticazione tramite codice QR
Con Unipile, collegare un account WhatsApp richiede solo pochi minuti. Il flusso è semplice, sicuro ed evita il lungo processo di approvazione commerciale di Meta. Ecco come funziona:
1. Richiedere un codice QR
L'applicazione genera un codice QR univoco tramite l'API Unipile. Gli utenti devono semplicemente scansionarlo con WhatsApp per avviare l'autenticazione.
2. Visualizzare il codice QR
Il codice QR può essere visualizzato direttamente nella vostra applicazione utilizzando librerie standard (PHP o JS). Gli utenti lo scansionano con il loro telefono per collegare il loro account.
3. Confermare l'autenticazione
Una volta scansionato il codice, lo stato del conto cambia in collegato. È possibile ascoltare questo evento eseguendo il polling dello stato dell'account o impostando un webhook per la conferma in tempo reale.
4. Avviare la messaggistica
Non appena l'account è attivo, è possibile inviare e ricevere messaggi di testo, condividere immagini, video, documenti e note vocali. I webhook in tempo reale notificano anche i nuovi messaggi, le reazioni e le ricevute di lettura.
Casi d'uso: Aggiungere WhatsApp a Il tuo prodotto
Integra la messaggistica nativa di WhatsApp negli strumenti che i tuoi utenti già utilizzano, dalle vendite al recruiting fino alle attività di outreach multicanale.
Strumenti CRM / Vendite
Trasformare le conversazioni in opportunità. Portate i messaggi di WhatsApp direttamente nel vostro CRM. Centralizzate le chat dei clienti, rispondete più velocemente, condividete documenti o note vocali e attivate follow-up automatici, tutto da un unico posto senza dover cambiare strumento.
WhatsApp per il CRMATS / Reclutamento
Collegatevi con i candidati dove si trovano. Sincronizzate le conversazioni dei candidati su WhatsApp e gestitele in una casella di posta condivisa. Assegnate le discussioni ai compagni di squadra, collaborate facilmente e mantenete ogni scambio visibile nel vostro ATS per accelerare le decisioni di assunzione.
WhatsApp per ATSPiattaforme di sensibilizzazione
La multicanalità resa semplice. Create campagne che combinano WhatsApp, LinkedIn ed e-mail in un unico flusso di lavoro. Inviate sequenze personalizzate, monitorate le risposte in tempo reale e mantenete la conformità gestendo ogni conversazione all'interno del vostro strumento di outreach.
Strumento WhatsApp for OutreachEsplora di più con
la nostra API di messaggistica
Unipile non si ferma a WhatsApp. La nostra API unificata si collega anche a LinkedIn, Instagram, Messenger, X (Twitter) e Telegram. Centralizzando tutti questi canali in un unico luogo, i vostri utenti possono gestire ogni conversazione senza soluzione di continuità. Dai DM ai commenti e alle chat di gruppo, tutto è accessibile in un'unica casella di posta, aiutando i team a rispondere più velocemente, a monitorare il coinvolgimento e a offrire un'esperienza utente coerente su tutte le piattaforme.
Supporto all'integrazione e risorse per il successo delle API di WhatsApp
Impostazione tecnica semplificata
Integra rapidamente le funzionalità di messaggistica di WhatsApp utilizzando la nostra API completamente documentata ed esempi di SDK. Che si tratti di inviare messaggi, condividere media o sincronizzare conversazioni, i nostri strumenti sono progettati per aiutarti a essere operativo in giorni anziché settimane.
Supporto di esperti per un'implementazione senza problemi
Il nostro team tecnico lavora direttamente con i vostri sviluppatori per garantire un onboarding senza soluzione di continuità. Dall'autenticazione con QR-code alla gestione dei webhook e al debug dei flussi di messaggi in tempo reale, gli esperti Unipile guidano la vostra integrazione in ogni fase del processo.
Miglioramenti continui e compatibilità
Allineiamo continuamente i nostri endpoint API di WhatsApp con gli ultimi aggiornamenti. In questo modo il vostro prodotto beneficia delle nuove funzionalità senza modifiche o interruzioni inaspettate. Rimarrete aggiornati e conformi, con zero spese di manutenzione.
Pensieri finali
WhatsApp è diventato un canale essenziale per l'engagement, il supporto e le vendite dei clienti, con miliardi di utenti attivi in tutto il mondo. Sebbene le API ufficiali Business e Cloud di Meta offrano funzionalità robuste, spesso presentano complessità: onboarding lunghi, verifica aziendale, quote e regole di conformità rigorose. Per molti editori SaaS, ciò crea attriti e ritardi nella consegna di valore ai propri utenti.
Unipile elimina queste barriere con un API di messaggistica unificata ciò rende l'integrazione con WhatsApp veloce, sicura e adatta agli sviluppatori. Tramite una semplice autenticazione tramite codice QR, le aziende di software possono abilitare messaggi di testo, condivisione di media, note vocali e conversazioni di gruppo in pochi minuti, senza diventare partner di Meta o ospitare infrastrutture. Webhook in tempo reale, sincronizzazione dei messaggi e compatibilità multi-canale garantiscono un'esperienza fluida su WhatsApp, LinkedIn, Instagram, Telegram, Gmail e Outlook.
Scegliendo Unipile, le piattaforme SaaS possono offrire una vera comunicazione omnichannelUna sola API, una sola integrazione, un potenziale illimitato. Sia che stiate costruendo un CRM, un ATS o una soluzione di outreach, Unipile accelera il vostro time-to-market, riduce i costi di manutenzione e garantisce la conformità con il Digital Markets Act.
È il momento di trasformare WhatsApp in una potente risorsa per il vostro prodotto. Iniziate a costruire con Unipile oggi stesso e date ai vostri utenti l'esperienza di comunicazione che si aspettano.
API di WhatsApp - Domande frequenti
messaggio_ricevuto evento webhook in tempo reale, con il testo del messaggio, il mittente e gli allegati, in modo da non dover mai eseguire il polling per nuovi messaggi.
