Glossario della WhatsApp API e dell’ecommerce

La piattaforma di Meta per le aziende che scrivono ai clienti su larga scala tramite software. Comprende la Cloud API per inviare e ricevere messaggi, la Business Management API per gestire account e modelli, la Marketing Messages API e i webhook.

Per saperne di più: La WhatsApp API ufficiale in Whapi

Il nome comune dell’API di messaggistica della WhatsApp Business Platform. La vecchia On-Premises API di Meta ha smesso di inviare messaggi dopo il 23 ottobre 2025, quindi oggi indica la WhatsApp Cloud API. Un’app Shopify come Whapi vi collega il numero del negozio per inviare messaggi automatici.

Per saperne di più: WhatsApp API ufficiale

La versione della WhatsApp Business API ospitata da Meta. Il software la usa per inviare messaggi di testo, contenuti multimediali e messaggi interattivi, e per ricevere come webhook i messaggi dei clienti e gli stati di consegna.

L’app scaricabile gratuitamente di Meta con cui le piccole imprese chattano con i clienti uno a uno dal telefono. Non invia messaggi in automatico quando succede qualcosa nel negozio, come un nuovo ordine. Per questo l’azienda collega il proprio numero alla WhatsApp Business API, e Coexistence le permette di continuare a usare l’app.

Usare lo stesso numero aziendale sulla WhatsApp Business App e sulla WhatsApp Cloud API allo stesso tempo. Continui a chattare dall’app sul telefono mentre un provider API invia messaggi automatici dallo stesso numero, e WhatsApp mantiene sincronizzata la cronologia dei messaggi. Al momento del collegamento si possono sincronizzare fino a 6 mesi di chat individuali; le chat di gruppo non vengono sincronizzate.

Per saperne di più: WhatsApp Coexistence spiegato

L’account aziendale Meta che possiede gli account WhatsApp, gli account di messaggistica e le altre risorse Meta di un’azienda. I limiti di messaggistica di WhatsApp sono impostati a livello di business portfolio e condivisi da tutti i numeri di telefono al suo interno.

Il contenitore di Meta per i numeri WhatsApp, i modelli e la fatturazione di un’azienda. Meta lo sta suddividendo in un account WhatsApp (WAAC) per il numero di telefono e un account di messaggistica per modelli, fatturazione e webhook. Il nuovo modello è diventato disponibile per tutti il 23 settembre 2026 e raggiunge tutte le aziende entro metà ottobre 2026. Gli ID WABA esistenti continuano a valere come ID degli account di messaggistica.

Nel nuovo modello di account di Meta, l’account che contiene un numero di telefono aziendale e rappresenta l’azienda su WhatsApp. L’azienda ne è sempre proprietaria e può condividerlo con più di un partner.

Nel nuovo modello di account di Meta, l’account che contiene i modelli di messaggio, i dati di fatturazione e le iscrizioni ai webhook di un’azienda. Ogni partner con cui l’azienda lavora ha il proprio account di messaggistica, quindi la fatturazione resta separata.

Il nome dell’azienda mostrato nel profilo WhatsApp di un numero della WhatsApp Business Platform. Lo indichi quando registri il numero e Meta lo confronta con le proprie linee guida sui nomi visualizzati in una verifica automatica.

Il controllo con cui Meta accerta che un business portfolio appartenga a un’azienda reale e registrata. È uno dei modi per alzare il limite di messaggistica di WhatsApp da 250 a 2.000. I portfolio non verificati sono inoltre limitati a 250 modelli di messaggio per account di messaggistica.

Per saperne di più: Come funziona la verifica aziendale Meta

Un nome comune per le aziende che offrono servizi della WhatsApp Business Platform ad altre aziende. La documentazione di Meta le chiama partner: i Solution Partner, che possono estendere linee di credito e fatturare ai clienti l’uso di WhatsApp, più i Tech Provider e i Tech Partner, i cui clienti pagano direttamente Meta.

Un’azienda che offre servizi della WhatsApp Business Platform tramite la propria app senza una linea di credito Meta. I suoi clienti aggiungono il proprio metodo di pagamento dopo l’onboarding, Meta fattura loro i messaggi WhatsApp e il Tech Provider fattura solo il proprio servizio.

La finestra di registrazione di Meta che un’app apre perché un’azienda possa accedere, accettare i termini di Meta, scegliere o creare le proprie risorse WhatsApp e dare accesso all’app. Può anche collegare un numero già presente sulla WhatsApp Business App, ed è così che inizia Coexistence.

Per saperne di più: Guida alla configurazione di Whapi

Un messaggio automatico che un sistema invia a un altro quando succede qualcosa. Meta consegna ogni messaggio WhatsApp in arrivo e ogni stato di consegna all’app dell’azienda tramite webhook, e Shopify può avvisare le app allo stesso modo di eventi come i nuovi ordini.

Un formato di messaggio con testo fisso e variabili approvato da Meta. Un’azienda può avviare una conversazione, o scrivere a un cliente fuori dalla finestra di assistenza clienti di 24 ore, solo con un modello.

Per saperne di più: Modelli di messaggio WhatsApp per Shopify

Il tipo che Meta assegna a ogni modello: Marketing, Utility o Authentication. La categoria determina il prezzo di ogni messaggio e la decide Meta. Dal 9 aprile 2025, un modello inviato come Utility viene approvato come Marketing se il contenuto è di marketing.

Per saperne di più: Modelli Utility e Marketing a confronto

Un modello che riguarda l’ordine, l’account o la richiesta del cliente stesso, come una conferma d’ordine, un aggiornamento di spedizione o un promemoria di pagamento, senza contenuti promozionali. Nel listino Meta in vigore dal 1 ottobre 2026, Utility costa meno di Marketing in ogni mercato, ad esempio 0,0550 $ contro 0,1365 $ per messaggio in Germania e 0,0220 $ contro 0,0635 $ nel Regno Unito.

Per saperne di più: Modelli di messaggio WhatsApp

Un modello che promuove prodotti, offerte o l’azienda, oppure inserisce della promozione in un messaggio altrimenti transazionale. Gli annunci di saldi, i coupon e i promemoria di carrello abbandonato sono Marketing secondo le linee guida di Meta. È la categoria più costosa, e WhatsApp limita quanti messaggi di marketing riceve ogni persona.

Per saperne di più: Modelli Marketing

Un modello che invia un codice monouso con cui il cliente può verificare la propria identità o accedere. Nel listino attuale di Meta costa come Utility in ogni mercato.

Una risposta libera, non un modello, inviata mentre la finestra di assistenza clienti è aperta. Dal 1° ottobre 2026 Meta li addebita per messaggio consegnato, ma ogni numero aziendale ne ha 1.000 gratuiti al mese. Nel listino attuale la tariffa Service è uguale a quella Utility.

Un segnaposto in un modello che viene compilato per ogni messaggio, come il nome del cliente o il numero d’ordine. Meta supporta variabili numerate come {{1}} e variabili con nome come {{first_name}}. In Whapi inserisci i dati di Shopify con variabili come {{customer_first_name}} e {{order_number}}.

Le parti di un modello: un’intestazione facoltativa (testo fino a 60 caratteri, oppure contenuti multimediali come immagine, video o documento), un corpo obbligatorio fino a 1.024 caratteri, un piè di pagina facoltativo fino a 60 caratteri e fino a 10 pulsanti.

Un pulsante del modello che il cliente tocca per inviare una risposta predefinita. Le etichette possono arrivare a 25 caratteri e un modello può averne fino a 10. I messaggi di conferma d’ordine di solito ne usano due, come Conferma ordine e Annulla ordine.

Per saperne di più: Conferma d’ordine su WhatsApp

Il controllo che Meta esegue su ogni modello nuovo o modificato, con sistemi automatici e persone, prima che possa essere inviato. Una decisione può richiedere fino a 24 ore e un modello rifiutato può essere modificato e inviato di nuovo.

Per saperne di più: Perché i modelli WhatsApp vengono rifiutati

Il consenso di un cliente a ricevere messaggi WhatsApp da un’azienda. Meta lo richiede prima che un’azienda scriva a qualcuno: la persona deve aver fornito il proprio numero di telefono e accettato di ricevere messaggi da quella specifica azienda. Si può raccogliere su un sito web, via SMS, per telefono o su carta.

Per saperne di più: Raccogliere opt-in WhatsApp su Shopify

Il Regolamento generale sulla protezione dei dati, la legge dell’UE sui dati personali; il Regno Unito ha una propria versione. Per WhatsApp, determina come un negozio raccoglie e registra l’opt-in ai messaggi di marketing, rispetta le revoche del consenso e risponde alle richieste di accesso o cancellazione dei dati personali.

Per saperne di più: Come Whapi gestisce il GDPR per WhatsApp

Le 24 ore successive all’ultimo messaggio o all’ultima chiamata di un cliente a un’azienda. Finché è aperta, l’azienda può inviare messaggi liberi; una volta chiusa, solo modelli. Ogni nuovo messaggio o chiamata del cliente la riporta a 24 ore.

Per saperne di più: Errore 131047: fuori dalla finestra di 24 ore

Il modello di prezzi di WhatsApp di Meta dal 1° luglio 2025. Meta addebita ogni messaggio consegnato che un’azienda invia, in base alla sua categoria e al prefisso del paese del numero del cliente, anziché per conversazione di 24 ore. I messaggi che i clienti inviano a un’azienda sono gratuiti.

Per saperne di più: Prezzi della WhatsApp API per paese

La tabella pubblicata da Meta con le tariffe dei messaggi WhatsApp per paese e regione. Meta può modificarla solo il 1° gennaio, il 1° aprile, il 1° luglio o il 1° ottobre, con almeno un mese di preavviso. Il listino attuale è entrato in vigore il 1° ottobre 2026.

Una finestra fino a 7 giorni che si apre quando un cliente scrive a un’azienda da un annuncio Click to WhatsApp nell’app WhatsApp per Android o iOS e l’azienda risponde entro la finestra di assistenza clienti. Finché è aperta, Meta non addebita i messaggi Marketing, Utility, Authentication o Service verso quel cliente.

Un annuncio Facebook o Instagram il cui pulsante apre una chat WhatsApp con l’azienda. Rispondere in tempo a una chat che parte da uno di questi annunci apre una finestra Free Entry Point.

Tariffe Utility e Authentication più basse che si applicano man mano che cresce il volume mensile di un’azienda in un mercato. Meta conta i messaggi addebitati su tutto il business portfolio e azzera il conteggio ogni mese. Nel listino in USD del 1° ottobre 2026, lo scaglione più basso è il 25% sotto la tariffa di listino. I messaggi Marketing e Service non hanno scaglioni.

Una tariffa più alta per i modelli Authentication in alcuni mercati, tra cui Ucraina, Indonesia, Sudafrica, Arabia Saudita ed Emirati Arabi Uniti. Si applica solo alle aziende che Meta ha ritenuto idonee, quando inviano a clienti in un paese diverso da quello dell’azienda.

Il massimo di clienti unici a cui un’azienda può scrivere fuori dalla finestra di assistenza clienti in un periodo mobile di 24 ore. È impostato per business portfolio e condiviso da tutti i suoi numeri. I nuovi portfolio partono da 250. Sale a 2.000 quando verifichi la tua azienda o consegni 2.000 messaggi con modello di alta qualità a clienti unici entro 30 giorni, poi automaticamente a 10.000, 100.000 e illimitato.

Per saperne di più: Limiti di messaggistica e qualità

La valutazione di Meta su un modello in base a utilizzo, feedback dei clienti e coinvolgimento: High (verde), Medium (giallo), Low (rosso), oppure Quality pending per i modelli nuovi. Separatamente, Meta valuta la qualità complessiva dei messaggi di un’azienda da come i clienti li hanno accolti negli ultimi 7 giorni, con segnali come blocchi, segnalazioni, silenziamenti e archiviazioni.

Meta sospende automaticamente un modello che raggiunge la qualità Low: per 3 ore la prima volta, per 6 ore la seconda, e alla terza viene disattivato. Un modello sospeso non può essere inviato.

Il tetto di WhatsApp ai messaggi di marketing che una persona riceve da tutte le aziende quando è meno probabile che interagisca. I messaggi trattenuti da questo limite falliscono con l’errore 131049 e Meta non addebita i messaggi non consegnati.

Per saperne di più: Risolvere l’errore 131049

Un checkout Shopify che un cliente ha iniziato ma non ha pagato. Shopify lo considera abbandonato quando resta incompleto per più di 10 minuti dopo che il cliente ha inserito la sua email. I negozi inviano promemoria con un link per tornare al checkout.

Per saperne di più: Recupero dei carrelli abbandonati su WhatsApp

Un messaggio che chiede al cliente di confermare un ordine prima della spedizione, tramite chiamata, SMS o WhatsApp. Con Whapi, il cliente tocca Conferma o Annulla in un messaggio WhatsApp e la risposta viene aggiunta all’ordine Shopify come tag.

Per saperne di più: Conferma d’ordine su WhatsApp

In Shopify, far arrivare un ordine al cliente: prelevarlo, imballarlo e spedirlo, poi segnarlo come evaso. Aggiungere all’evasione il numero di tracciamento del corriere salva i dati di tracciamento usati dagli aggiornamenti di spedizione su WhatsApp.

Per saperne di più: Aggiornamenti di spedizione su WhatsApp

Il codice che un corriere assegna a un pacco per poterlo seguire. Quando lo aggiungi a un ordine Shopify, Whapi può inviarlo al cliente su WhatsApp con il link di tracciamento.

Per saperne di più: Modelli per gli aggiornamenti di spedizione

Etichette che aggiungi agli ordini Shopify per raggrupparli, cercarli e filtrarli, ad esempio Confermato o Annullato. Puoi filtrare la pagina Ordini per tag, ed è così che i team trovano gli ordini confermati pronti da spedire.

Il livello di riconoscimento più alto che un’app può raggiungere su Shopify App Store. Le app devono rispettare gli standard di Shopify per sicurezza, affidabilità, prestazioni, facilità d’uso, utilità comprovata e informazioni sull’app, e ottengono un badge e una promozione extra nell’App Store. Whapi ha lo stato Built for Shopify.

Per saperne di più: Whapi e Built for Shopify

Pagare in contanti al corriere quando arriva il pacco. In Shopify, il contrassegno è un metodo di pagamento manuale: questi ordini restano non pagati finché non li segni come pagati, e Shopify non applica commissioni di transazione di terze parti sui pagamenti manuali. Alcuni negozi incassano in anticipo le spese di consegna e il resto alla porta, il che si chiama contrassegno parziale.

Un pacco che il corriere rimanda al venditore perché non è stato possibile consegnarlo o il cliente l’ha rifiutato. Di solito il negozio paga la spedizione in entrambe le direzioni, a volte anche una commissione di reso, e perde la vendita.