WhatsApp API 2026: Tipi, Accesso, Prezzi e Limiti

Commissione europea
Regolamentato dall'UE Legge sui mercati digitali (DMA)
La nostra soluzione si concentra esclusivamente sull'interoperabilità della messaggistica, senza archiviazione di profili e senza scraping. I clienti sono tenuti a rispettare le condizioni di ciascun fornitore. Per saperne di più
Guida alle API di WhatsApp 2026

API di WhatsApp: Tipi, Accesso, Prezzi e Limiti

Tutto ciò che la piattaforma ufficiale WhatsApp Business richiede e le parti che non copre: come connettere un account WhatsApp per uso personale o un'applicazione aziendale esistente, tramite codice QR o codice di associazione, senza verifica Meta Business.
Prova gratuita di 7 giorni, nessuna carta di credito richiesta
Account collegato
Codice QR, nessuna configurazione Meta
connect-whatsapp.js
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'
});
Connesso, per conto dell'utente autenticato
Definizione

Che cos'è l'API di WhatsApp?

Il API di WhatsApp non è un singolo prodotto. È un termine ombrello per tre diversi modi di inviare e ricevere messaggi WhatsApp da software: la piattaforma ufficiale WhatsApp Business di Meta, un Business Solution Provider che ne rivende l'accesso e un'API di messaggistica unificata che si collega a un account WhatsApp già posseduto da un utente.
Tutte e tre funzionano in definitiva sulla rete di WhatsApp stessa, Meta possiede il protocollo, quindi nessuna opzione opera al di fuori dell'infrastruttura di Meta. Ciò che differisce nettamente tra di loro è il modello di accesso: che tu stia configurando un numero aziendale completamente nuovo secondo le regole di Meta, o collegando un account già esistente.
NomeCos'èChi lo gestisceRequisiti di accesso
Piattaforma WhatsApp Business API CloudL'API ufficiale di Meta per il provisioning di nuovi numeri di telefono aziendali e l'invio di messaggi con modelli su scalaMetaApp 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 fatturazioneInfrastruttura Meta, gestita da BSPStessi 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 associazioneUnipile, per conto dell'utente autenticatoNessuna verifica Meta Business, nessun nuovo numero, nessuna approvazione dei modelli
Il resto di questa guida copre tutte e tre, con un'attenzione specifica sulla terza opzione, poiché è quella che la maggior parte delle guide esistenti sull'API di WhatsApp salta completamente.
Orientamento

Quali sono i diversi tipi di API di WhatsApp?

Ci sono quattro modi pratici per accedere a WhatsApp programmaticamente oggi: il API del cloud (attuale superficie ufficiale di Meta), l'interrotto API On-Premise, il App WhatsApp Business, e un API di sessione di terze parti che collega un account che un utente ha già.
TipoProvisioningIl migliore perFunziona con un account esistente
API del cloudNuovo numero di telefono aziendale + verifica Meta Business per volumi più elevatiAziende che inviano marketing ad alto volume o notifiche su larga scalaNo, richiede un nuovo numero
API On-PremiseDeprecato. Meta lo ha dismesso e ha promosso la migrazione alla Cloud API.Solo integrazioni legacyNo
App WhatsApp BusinessApp gratuita per i consumatori, configurazione manuale su un dispositivoLe piccole imprese che gestiscono le chat a manoSì, 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 numeroPiattaforme SaaS che integrano l'account WhatsApp di ciascun utente direttamente nel prodottoSì, questo è il caso d'uso principale
Le prime due righe rappresentano l'infrastruttura di Meta, costruita attorno al provisioning di un nuovo numero aziendale. La terza è un'app manuale, gestita da umani, senza una vera API. La quarta è dove si trova un'API unificata come Unipile: non compete con la Cloud API, risolve un problema diverso, consentendo ai tuoi utenti di connettere l'account WhatsApp che hanno già in tasca.
Meta ha anche introdotto una coesistenza limitata tra l'App WhatsApp Business e la Cloud API sullo stesso numero, in modo che un'azienda possa mantenere l'app per le conversazioni manuali mentre un sottoinsieme del traffico passa attraverso la Cloud API. Si tratta pur sempre di un numero di proprietà dell'azienda che cambia il modo in cui viene gestito, non della stessa cosa di una terza parte che collega un account che un utente diverso e individuale possiede già. Il tipo che conta per questa guida è il quarto: è l'unica opzione basata sull'account e non sul numero. Per un'analisi più approfondita dell'utilizzo del tipo Cloud API all'interno di un prodotto multi-tenant, consulta la nostra Integrazione WhatsApp Cloud API guida.

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.

In hosting autonomo

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.

Il migliore per aziende che integrano WhatsApp nei propri sistemi CRM, contact center o di supporto.
Meta Cloud

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.

Il migliore per team che vogliono un'implementazione più rapida senza gestire server o 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.

Verifica aziendale Approvazioni template Quote dei messaggi Gestione dei webhook Crittografia Regole di opt-in rigorose
Fattibilità

Puoi integrare WhatsApp nel tuo software?

Sì. Qualsiasi prodotto software può integrare la messaggistica di WhatsApp. Esistono tre modi distinti per farlo, e quello giusto dipende dal fatto che tu stia inviando da un nuovo numero aziendale o da un account di cui il tuo utente è già proprietario.
1Costruisci direttamente sulla Cloud API di Meta. Fornisci un numero di telefono aziendale, registri un'app per sviluppatori Meta e ti integri direttamente con gli endpoint di Meta.
2Rivolgiti a un Business Solution Provider. Un BSP fornisce il numero e l'account WhatsApp Business per te e vi sovrappone la propria dashboard o API.
3Collega gli account esistenti tramite un'API unificata. Ciascuno dei vostri utenti collega l'account WhatsApp che già possiede, senza alcun nuovo numero e senza verifica Meta Business, per conto di quell'utente autenticato.
Le sezioni successive spiegano in dettaglio come ottenere l'accesso per ciascun percorso.
Prerequisiti

Di cosa hai bisogno prima di poter utilizzare l'API di WhatsApp Cloud?

La Cloud API di Meta richiede un account sviluppatore Meta, un account WhatsApp Business (WABA), un numero di telefono aziendale dedicato che non sia mai stato attivo su WhatsApp normale e, oltre un determinato volume, un'azienda Meta verificata.
Account sviluppatore Meta con un'app che ha il prodotto WhatsApp aggiunto
Account WhatsApp Business (WABA) creato all'interno di quell'app
Un numero di telefono non attualmente attivo su WhatsApp o WhatsApp Business
Verifica aziendale in Meta Business Manager, richiesto per sbloccare i livelli di messaggistica superiori a 250 destinatari unici ogni 24 ore
Modelli di messaggi approvati per qualsiasi conversazione avviata dall'azienda al di fuori della finestra di servizio di 24 ore
Nulla di tutto ciò si applica se colleghi un account che il tuo utente possiede già invece di effettuare il provisioning di un nuovo numero, poiché non vi è alcuna nuova identità aziendale da verificare per Meta. Maggiori informazioni in merito nella sezione su conti personali ed esistenti qui sotto.
Intero processo di verifica aziendale passo dopo passo, documenti richiesti e tempi di revisione tipici: Guida all'API di WhatsApp senza verifica aziendale (in arrivo sul cluster).
Limiti

Quali sono i limiti dell'API di WhatsApp?

Meta impone tre limiti distinti sulla piattaforma WhatsApp Business: un limite di throughput di 80 messaggi al secondo, un limite di frequenza dell'API orario di da 200 a 5.000 richieste, e un livello di messaggistica che limita il numero di clienti unici a cui è possibile inviare messaggi in un periodo continuativo di 24 ore.
LimiteValoreAppunti
Rendimento80 messaggi / secondoVelocità di invio a livello di piattaforma
Limite di frequenza delle APIda 200 a 5.000 richieste all'oraSi adatta in base allo stato dell'account e alla qualità
Limite di frequenza dell'associazione1 messaggio / 6 secondiPer destinatario, impedisce l'invio di spam allo stesso utente
Livello di messaggistica250 → 2.000 → 10.000 → 100.000 → illimitatiDestinatari unici per intervallo mobile di 24 ore, parte da 250 non verificati
Il passaggio a un livello di messaggistica superiore richiede la verifica dell'attività o una comprovata cronologia di invii di qualità. Una volta idonei, il passaggio al livello successivo può avvenire automaticamente se l'utilizzo rimane elevato e la qualità si mantiene costante.
Nessuno di questi livelli delle API Cloud si applica a una connessione basata su sessione. La velocità di invio in quel caso è limitata invece dal comportamento a livello di account di WhatsApp stesso, e il modo in cui viene utilizzato un account rimane una decisione del cliente.
Valutazione della qualità, strategia di backoff e gestione degli errori 429 in dettaglio: Guida ai limiti di tasso dell'API di WhatsApp (in arrivo sul cluster).
Il elemento di differenziazione

È possibile utilizzare l'API di WhatsApp con un account esistente dell'App WhatsApp Business?

Sì. Che sia per uso personale o per un account Business App, Unipile collega l'account WhatsApp esistente dell'utente autenticato allo stesso modo in cui fa WhatsApp Web: tramite codice QR o codice di associazione. Poiché tale account esiste già, nessuno dei prerequisiti della Cloud API delle sezioni precedenti è applicabile.
Ogni percorso descritto finora in questa guida, l'accesso tramite Cloud API e BSP, presuppone il provisioning di un numero di telefono aziendale nuovo di zecca. Questo è il modello giusto per un'azienda che trasmette campagne di marketing o notifiche automatizzate da un numero condiviso. È il modello sbagliato per una piattaforma SaaS, un CRM o uno strumento di posta in arrivo il cui vero obiettivo è consentire a ciascuno dei propri utenti di portare l'account WhatsApp che già possiede, per uso aziendale o personale, nello stesso modo in cui quel prodotto potrebbe consentire a un utente di portare la propria casella di posta Gmail o il proprio account LinkedIn.
In pratica, "WhatsApp API per uso personale" è ciò che la maggior parte delle persone che lo cercano intende realmente: non un modo per violare le regole di WhatsApp, ma un modo per collegare un account già esistente, il numero di un fondatore, il numero di un addetto all'assistenza, il WhatsApp personale di un freelance, a un software senza che Meta lo tratti come una nuova implementazione aziendale. Uno strumento di reclutamento che consente a ciascun recruiter di inviare messaggi ai candidati dal proprio numero, una casella di posta di supporto che unifica gli account WhatsApp personali di un team, o un'agenzia che gestisce le conversazioni con i clienti da numeri di cui i clienti si fidano già, rientrano tutti in questa categoria anziché nel modello di broadcast della Cloud API.
Quel secondo modello è ciò per cui è stata concepita una connessione basata su sessione. Unipile collega l'account riproducendo lo stesso flusso di autenticazione già utilizzato da WhatsApp Web: un codice QR scansionato dal telefono o un codice di abbinamento digitato nell'app WhatsApp quando la scansione non è pratica. Nessuna app per sviluppatori Meta, nessun account WhatsApp Business, nessuna migrazione di numeri di telefono, nessun modello di messaggio inviato per l'approvazione.
Come Unipile collega un account esistente
Unipile collega account WhatsApp esistente dell'utente autenticato, tramite codice QR o codice di associazione, e agisce per conto di quell'utente. Non è richiesta alcuna verifica Meta Business, né WABA o approvazione di modelli, poiché non state effettuando il provisioning di un nuovo numero aziendale, ma state collegando un account che l'utente già possiede.
Unipile è un intermediario tecnico indipendente, non è un partner di Meta o WhatsApp, ed è non affiliato a, sponsorizzato da o affiliato con WhatsApp o Meta. La frequenza e il numero di messaggi inviati tramite un account collegato rimangono un decisione lato cliente, e continua a trovare applicazione il comportamento a livello di account di WhatsApp.
Questo è anche il modello che si scala attraverso i canali. Lo stesso approccio basato sugli account collegati che collega WhatsApp funziona per LinkedIn, Instagram e Telegram, e per le caselle di posta Gmail, Outlook e IMAP, quindi un prodotto che integra WhatsApp in questo modo può aggiungere un altro canale senza una seconda integrazione.
Collega un account esistente
Implementazione

Come si collega un account WhatsApp a Unipile?

La connessione di un account WhatsApp con Unipile richiede una chiamata API e un'azione da parte dell'utente: chiamare l'endpoint degli account con il provider WhatsApp, quindi fare in modo che l'utente scansioni il codice QR restituito o inserisca il codice di associazione restituito sul proprio telefono.
1Connetti tramite codice QR
Il flusso predefinito. Mostra il codice QR restituito, l'utente lo scansiona da WhatsApp > Dispositivi collegati.
connect-qr.js
// SDK per Node.js
const { qrCodeString, code } = await client.account.CollegaWhatsapp();
// mostra qrCodeString all'utente come immagine
2Connetti tramite codice di abbinamento
Per i flussi in cui la scansione non è pratica. Inserire un numero di telefono in cifre E.164.
connect-pairing.sh
POST /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..."
}
3Invia un messaggio
Una volta effettuato il collegamento, invia messaggi di testo, contenuti multimediali, note vocali o documenti in qualsiasi chat.
send-message.sh
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..."
}
4Ascolta i nuovi messaggi con un webhook
Registra un webhook una sola volta e ogni nuovo messaggio viene inviato al tuo endpoint in tempo reale, senza polling.
carico-utile-webhook.json
{
  "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"
}
Le stesse quattro chiamate, connect, send, list, listen, funzionano in modo identico per LinkedIn, Instagram, Telegram, Gmail, Outlook e IMAP. Integri il pattern una sola volta. Per il flusso completo di collegamento dell'account, inclusi i link wa.me e la gestione della riconnessione, vedi il nostro Flusso di collegamento dell'account WhatsApp guida.
Iniziare a costruire
Capacità

Cosa puoi costruire con l'API di WhatsApp?

Con un account WhatsApp collegato puoi inviare e ricevere messaggi di testo, contenuti multimediali, note vocali e documenti, elencare e sincronizzare ogni chat nel tuo database, reagire e inoltrare messaggi e ricevere consegne in tempo reale tramite webhook, gli stessi endpoint che Unipile utilizza per LinkedIn, Instagram, Telegram, Gmail, Outlook e IMAP.
CapacitàCosa faAppunti
Inviare messaggiTesto, contenuti multimediali, note vocali, documentiNote vocali: .mp3/.m4a. typing_duration simula la digitazione
Elenca e sincronizza le chatInserisci ogni conversazione nel tuo databasePaginazione basata su cursore, filtra per account
Reagisci ai messaggiAggiungi una reazione con emoji a un messaggioWhatsApp e LinkedIn
Inoltra messaggiInoltra un messaggio in un'altra chatSolo WhatsApp
Modifica / elimina messaggiModifica o elimina un messaggio che hai inviatoElimina: WhatsApp + LinkedIn. Modifica: WhatsApp + LinkedIn Classic
Webhook in tempo realeEventi di push: ricevuto, reazione, letto, modificato, eliminato, consegnatoNessun sondaggio richiesto
Procedura dettagliata completa di richiesta e risposta per l'invio di messaggi WhatsApp: API di WhatsApp per inviare messaggi.

Elencare tutte le chat di WhatsApp nel software

Ogni chat, personale o app aziendale, si sincronizza tramite lo stesso endpoint. Filtra per account e impagina con un cursore per estrarre la tua casella di posta completa.
list-chats.sh
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..."
}
Crea la tua integrazione WhatsApp

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.

La vostra applicazione
MO
Michel Opra
LinkedIn Instagram WhatsApp Gmail Calendario di Google
Messaggio Email Calendario
Attività Nuovo
Gmail
Ecco il contratto firmato
Oggi 3:08 PM
Ti ho inviato il contratto
Oggi 1:02 PM
Calendario di Google
Evento programmato lunedì 5/2
Ieri 11:54
WhatsApp classico WhatsApp
Classico
WhatsApp Business WhatsApp
Affari
.
API di WhatsApp

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.

Messaggi di testo inviare e rispondere ai messaggi in modo istantaneo.
Note vocali : registrare e inviare messaggi audio direttamente nella conversazione.
Condivisione dei media Scambio di foto, documenti e video.
Cronologia dei messaggi e ricevute : sincronizzare la cronologia delle chat, elencare le reazioni e tenere traccia delle ricevute di lettura in tempo reale.
Webhook in tempo reale : notifiche istantanee per modifiche dello stato dell'account, nuovi messaggi, reazioni e conferme di lettura.
Crea ora
John Rodrigez
Gmail
WhatsApp
LinkedIn LinkedIn
Gmail Gmail
JR
Messaggio vocale inviato
0:45
JR
Messaggio
Grazie John, rivedrò i dettagli e ti farò sapere presto.
Perno
Muto
Archivio
Rispondi a John tramite WhatsApp
.
Michel Opra
John Rodrigez
Alicia Smith
Emma Ward
Gruppo Q1
Sessione di reclutamento - Regno Unito - 16 persone
Michel Opra
Michel Opra
Ciao a tutti, benvenuti alla sessione di reclutamento.
Alicia Smith
Alicia Smith
Grazie Michel, trovi i dettagli qui.
John Rodrigez
John Rodrigez
Grazie Alicia, rivedrò i dettagli e ti darò presto una risposta.
Rispondere al gruppo tramite WhatsApp
Gruppi WhatsApp

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.

Crea e unisciti a gruppi
Messaggistica di gruppo
Sincronizzazione in tempo reale
Crea ora
.
La vostra applicazione
Cruscotto
Inbox
Contatti
Calendario
Promemoria
Prodotti
citazioni
Chiamate
Michel Opra
Michel Opra
Grazie!
Sofia Rivera
Sofia Rivera
Ciao Sarah, io sono spagnolo...
Daniel Martinez
Daniel Martinez
Quando l'hai ricevuta?
Gabriel Lopez
Gabriel Lopez
Puoi aiutarmi con questo?
Elena Garcia
Elena Garcia
Cara Sarah,
Natalia Diaz
Natalia Diaz
Quindi, dipende da voi!
Victor Harris
Victor Harris
Mi chiamo Victor e vengo dalla Polonia.
Oscar Ward
Oscar Ward
Grazie per aver chiesto!
API di WhatsApp

Elenca tutto Chat di WhatsApp nel tuo software

Elenco di tutte le chat
GET
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.

.
Unipile - Funzionalità API WhatsApp
API di WhatsApp

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.

Esplora tutti gli endpoint
Messaggi
Connessione del contoConto
Allegati
Ganci web

Messaggi

10 endpoint disponibili

Inviare e rispondere ai messaggi
Inviare messaggi vocali
Inviare messaggi video
Elenco di messaggi, chat e partecipanti
Storia della sincronizzazione
Reazioni
Cancellare il messaggio
Leggere le ricevute
Crea gruppo
Elenco di gruppi e contatti

Connessione del conto

2 endpoint disponibili

Hosted Auth: white label per connettere i tuoi utenti finali
Autenticazione personalizzata: collega gli utenti tramite credenziali, cookie, la tua estensione Chrome

Allegati

2 endpoint disponibili

Invio di file allegati
Ricezione di file allegati

Ganci web

3 eventi disponibili

Stato del conto
Nuovo messaggio
Nuova reazione / lettura / evento
Gruppi

L'API di WhatsApp supporta la messaggistica di gruppo?

Sì. Meta ha aggiunto un'API ufficiale per i Gruppi alla Piattaforma WhatsApp Business, ma comporta restrizioni reali che la maggior parte dei team non si aspetta.
OBA
È richiesto un Account Aziendale Ufficiale
8
Partecipanti massimi per gruppo
10,000
Numero massimo per gruppo
Per messaggio
Fatturato come qualsiasi altra conversazione
Non supportato: chiamate, messaggi che scompaiono, visualizzazione singola, messaggi interattivi, commercio, modelli di autenticazione o modifica ed eliminazione di un messaggio di gruppo. Gli account connessi a Unipile seguono le meccaniche di gruppo native di WhatsApp anziché questi vincoli delle API Cloud.
Il comportamento dei gruppi differisce in modo significativo tra l'API Gruppi di Meta e le connessioni basate su sessione. Analisi dettagliata nel nostro Guida all'API del gruppo WhatsApp.
Prospettive per il 2026

Quali strumenti di automazione e API di WhatsApp dovresti usare nel 2026?

Dipende da ciò che stai costruendo. Una piattaforma SaaS che integra il WhatsApp di ogni singolo utente richiede un'API unificata basata sulle sessioni. Un'azienda che fa broadcasting su larga scala ha bisogno della Cloud API di Meta o di un BSP. Uno sviluppatore che sta prototipando un'idea ha bisogno di qualunque opzione permetta di avviare un'integrazione funzionante oggi stesso.
ProfiloCiò di cui hanno bisognoApproccio del best-fit
Integrazione SaaS / CRM di account di proprietà degli utentiOgni utente finale collega il WhatsApp (e spesso LinkedIn, Instagram, email) che ha già, all'interno del tuo prodottoAPI di sessione unificata, nessuna verifica Meta per utente
Trasmissione aziendale su vasta scalaUn numero aziendale verificato che invia modelli di marketing o di utilità a un vasto pubblicodirettamente tramite la Cloud API di Meta o attraverso un BSP
Prototipazione per sviluppatoriIl percorso più rapido possibile verso un'integrazione funzionante prima di impegnarsi nell'infrastrutturaAPI di sessione per account di proprietà dell'utente, sandbox Cloud API per un singolo numero aziendale
Questi non si escludono a vicenda. Alcuni prodotti utilizzano entrambi: un numero Cloud API per il marketing in uscita e una connessione basata su sessione per l'integrazione dell'account all'interno del prodotto stesso.
Ciò che è cambiato in vista del 2026 riguarda meno le nuove API e più la pressione sulla fatturazione e sull'accesso. La tariffazione per messaggio premia la precisione rispetto al volume, quindi gli strumenti basati sulla trasmissione di massa richiedono un targeting più rigoroso rispetto al vecchio modello basato sulle conversazioni. Allo stesso tempo, la domanda per l'uso personale, ovvero singoli individui e piccoli team che collegano un singolo account invece di configurare un numero aziendale, continua a crescere, motivo per cui le API basate sulle sessioni sono passate dall'essere una soluzione alternativa di nicchia a una categoria mainstream a tutti gli effetti.
Se WhatsApp è uno dei diversi canali che prevedi di supportare, un'API unificata elimina la necessità di integrare separatamente l'SDK di ciascun provider. Vedi API multicanale per agenti AI.
Le migliori pratiche

Quali sono le migliori pratiche per l'API di WhatsApp di Meta?

Le migliori pratiche ufficiali di Meta per la WhatsApp Business Platform si concentrano su sei aspetti: ottenere un vero consenso (opt-in), proteggere la valutazione della qualità, utilizzare la categoria di template corretta, rispettare la finestra di servizio di 24 ore, gestire gli errori in modo efficace e rimanere entro i limiti di invio (rate limits).
01
Ottieni reali consensi opt-in
Invia messaggi solo agli utenti che hanno espressamente accettato di essere contattati su WhatsApp dalla tua azienda. Meta richiede un opt-in chiaro e verificabile prima di inviare un messaggio con modello.
02
Proteggi la tua valutazione di qualità
Meta traccia i tassi di blocco e segnalazione per numero di telefono. Un basso punteggio di qualità limita la tua categoria di messaggistica e può sospendere del tutto l'invio.
03
Usa la categoria di modello corretta
Scegli marketing, utility o authentication con precisione al momento dell'invio. Le categorie non corrispondenti causano il rifiuto dei modelli o l'addebito con la tariffa errata.
04
Rispetta la finestra di servizio di 24 ore
Riserva risposte libere e non predefinite a una finestra che l'utente ha aperto inviando il primo messaggio. Usa modelli approvati al di fuori di tale finestra.
05
Gestisci gli errori con backoff
Crea una logica di ritentativo per i limiti di frequenza e gli errori transitori invece di sovraccaricare l'API in caso di errore.
06
Rimani entro i limiti di frequenza
L'uso eccessivo e continuato dei limiti di throughput, orari o di coppia degrada la valutazione della qualità ancor prima di raggiungere un blocco definitivo.
Meta for Developers, documentazione della piattaforma WhatsApp Business.
Unipile - Perché scegliere Unipile
Meta vs Unipile

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
Tempo di integrazione
Meta APISettimane o mesi
Unipile2-3 giorni
Sforzo di sviluppo
Meta APIAlto
UnipileBasso (REST + SDK)
Manutenzione
Meta APIManuale
UnipileCompletamente gestito
Accesso alle funzioni
Meta APIParziale (dopo l'approvazione)
UnipileCompleto, istantaneo
Supporto
Meta APISolo self-service
UnipileTeam tecnico dedicato
Criteri Meta API 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.

Cruscotto unificato

Un cruscotto per tutte le vostre integrazioni

Gestite tutti i vostri account LinkedIn, WhatsApp, Gmail e altro ancora da un'unica interfaccia intuitiva.

/
Acme
/
Applicazione
Documentazione
Riferimento API
Changelog
Collegare un nuovo account
Selezionare il tipo di account
vogliono connettersi
LinkedIn
LinkedIn
WhatsApp
WhatsApp
Instagram
Instagram
Telegramma
Telegramma
Google
Google
IMAP
IMAP
Microsoft
Microsoft
Calendario di Google
Calendario di Google
Calendario di Outlook
Calendario di Outlook

Conti

20 Operativo
0 È richiesta l'autenticazione
0 Interruzione del servizio
0 In pausa
Nome ID Stato Collegato
Operativo Collegato su
03/01/2025
Operativo Collegato su
02/15/2025
Operativo Collegato su
02/10/2025
Operativo Collegato su
03/01/2025
Operativo Collegato su
02/28/2025
Operativo Collegato su
02/20/2025
Operativo Collegato su
03/01/2025
Operativo Collegato su
02/25/2025
Operativo Collegato su
03/01/2025
Operativo Collegato su
02/22/2025
Operativo Collegato su
02/14/2025
Operativo Collegato su
02/12/2025
Operativo Collegato su
02/08/2025
Operativo Collegato su
02/05/2025
Operativo Collegato su
03/01/2025
Operativo Collegato su
02/15/2025
Operativo Collegato su
03/01/2025
Operativo Collegato su
02/22/2025
Prova gratis
Demo del cruscotto
.
Autenticazione con codice QR dell'API di WhatsApp per la connessione dei dispositivi

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.

Unipile - Casi d'uso di WhatsApp

Esplora 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.

Unipile - Supporto e Risorse per l'Integrazione
API di WhatsApp

Supporto all'integrazione e risorse per il successo delle API di WhatsApp

Co-fondatori, CTO e CEO di Unipile
Chiamata di integrazione
Assicuratevi un incontro su richiesta con i nostri fondatori (CTO e CEO) per allinearvi sulla strategia tecnica e di prodotto.
Collegatevi con l'assistenza in diretta
Il nostro supporto live è a vostra disposizione prima, durante e dopo l'integrazione, assicurandovi una guida in ogni fase senza costi aggiuntivi.

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.

Unipile - Riflessioni Finali

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

Risposte chiare su uso personale, costi, limiti e accesso, tratte dalla documentazione ufficiale di Meta.
Sì. È quello API di WhatsApp per uso personale significa in pratica: collegare un account che possiedi già. Unipile collega account WhatsApp esistente dell'utente autenticato, App Personale o Aziendale, tramite codice QR o codice di associazione, e agisce per conto di quell'utente, nello stesso modo in cui fa WhatsApp Web. Non c'è verifica Meta Business, né WABA e nessuna approvazione di modelli, perché non state effettuando il provisioning di un nuovo numero aziendale. La Cloud API di Meta, per contro, è concepita per le aziende che effettuano il provisioning di un nuovo numero, non per gli account personali. Il modo in cui un account collegato viene utilizzato successivamente, la cadenza e il volume, rimangono un decisione lato cliente. Unipile è un intermediario tecnico indipendente e non affiliato a, sponsorizzato da o affiliato con WhatsApp o Meta.
L'accesso all'API in sé non viene fatturato per messaggio da parte di Unipile oltre al tuo abbonamento, ma Meta ha fatturato la piattaforma WhatsApp Business per messaggio consegnato a partire dal 1° luglio 2025. I modelli di marketing e di autenticazione vengono sempre fatturati. I modelli di utilità e le risposte in formato libero sono gratuiti solo se inviati all'interno di una finestra di assistenza clienti aperta di 24 ore. Vedi Prezzi API di WhatsApp Business per il listino prezzi completo.
Dipende dal percorso. L'API Cloud di Meta autentica ogni richiesta con un token di accesso permanente associato alla tua app Meta e al WABA. Una connessione basata su sessione non utilizza alcun token Meta: l'account viene autenticato una sola volta tramite codice QR o codice di abbinamento, e le richieste a Unipile stesso vengono autenticate con la tua chiave API di Unipile.
No. "WhatsApp Business API" è il vecchio nome generale per l'intera piattaforma. La Cloud API è l'attuale interfaccia ufficiale ospitata da Meta per essa, dopo che Meta ha deprecato l'API On-Premise. Nell'uso quotidiano, i due termini sono ora usati quasi in modo intercambiabile per indicare la stessa piattaforma ospitata da Meta.
Dipende interamente dal percorso. Una connessione basata su sessione con un'API unificata può essere attiva in pochi minuti: creare un account, scansionare un codice QR, iniziare a inviare. La Cloud API di Meta richiede più tempo: creare un WABA, aggiungere un numero di telefono aziendale e, per i livelli di messaggistica più elevati, completare la verifica aziendale di Meta, che di per sé può richiedere da pochi giorni a poche settimane.
Solo per la Cloud API di Meta, e solo oltre un determinato volume. Un WABA non verificato può comunque inviare fino a 250 destinatari unici ogni 24 ore. La verifica è richiesta per sbloccare livelli di messaggistica superiori. La connessione di un account esistente tramite un'API basata su sessione salta completamente questo requisito, poiché non viene configurato alcun nuovo numero aziendale.
Sì. Sia la Cloud API che una connessione basata su sessione consegnano i messaggi in arrivo tramite webhook. Con Unipile, un account WhatsApp collegato attiva un 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.
Meta ha aggiunto un'API ufficiale per i Gruppi alla Cloud API, limitata a 8 partecipanti per gruppo e vincolata a un Account Commerciale Ufficiale. Le connessioni basate su sessione seguono invece il comportamento nativo dei gruppi di WhatsApp. Analisi completa nel nostro Guida all'API del gruppo WhatsApp.
I prezzi di Meta variano in base alla categoria del template e al paese del destinatario, non c'è una tariffa fissa unica. In linea generale, i template di autenticazione e marketing sono i più costosi, mentre quelli di servizio costano meno e sono spesso gratuiti all'interno di una finestra di servizio aperta. Consultate la nostra Prezzi API di WhatsApp Business guida per i numeri a livello di paese.
Meta pone un limite all'API Cloud a circa 80 messaggi al secondo, da 200 a 5.000 richieste API all'ora a seconda dello stato dell'account e di un messaggio ogni 6 secondi allo stesso destinatario. Un livello di messaggistica limita anche il numero di clienti unici che puoi raggiungere in 24 ore, partendo da 250 e aumentando con la verifica e la qualità.
Sì, in due modi diversi. Puoi integrare direttamente la Cloud API di Meta come Tech Provider registrato, senza passare attraverso un Business Solution Provider. Oppure puoi saltare del tutto lo stack della Cloud API e connettere un account WhatsApp esistente tramite un'API unificata basata sulle sessioni, che non è mai stata territorio dei BSP in principio.
Sì, ma non allo stesso modo. Meta ha introdotto una coesistenza limitata tra l'App WhatsApp Business e la Cloud API sullo stesso numero, con alcune restrizioni. Una connessione basata sulle sessioni segue una strada più semplice: collega direttamente l'account dell'App Business tramite codice QR o codice di associazione, nello stesso modo in cui fa WhatsApp Web, senza una configurazione parallela della Cloud API.
Avete ancora domande? Il nostro team è qui per aiutarvi.
Parlare con un esperto

Ti potrebbe interessare anche

L'API di ricerca di linkedin amplifica il valore degli utenti per i redattori

L'API di ricerca di linkedin amplifica il valore degli utenti per i redattori

LinkedIn, la più grande piattaforma di networking professionale al mondo, offre diversi strumenti e servizi per aiutare gli utenti a connettersi, coinvolgere e far crescere le proprie reti. Tra questi c'è la funzione LinkedIn API Search, che consente di integrare perfettamente le funzionalità di ricerca di LinkedIn nelle applicazioni. Che cos'è...

leggi tutto
Come inviare un messaggio LinkedIn API da un'applicazione

Come inviare un messaggio LinkedIn API da un'applicazione

Integrare le funzionalità di messaggistica di LinkedIn nella vostra applicazione può migliorare significativamente il coinvolgimento degli utenti e semplificare la comunicazione. Questa guida vi guiderà nell'utilizzo dell'API di LinkedIn per inviare messaggi direttamente dalla vostra app, illustrandovi i passaggi necessari, gli strumenti e...

leggi tutto
it_ITIT
.