Modelli WhatsApp (WABA)
Crei in WASync i modelli di messaggio WhatsApp Business API, segua la loro approvazione da parte di Meta e li invii dalla chat del CRM, dalle regole di automazione di Bitrix24 e da Chat Flows.
Un modello (template) è un messaggio che Meta ha approvato in anticipo. È l'unico tipo di messaggio che un numero WhatsApp Business API (WABA) può inviare a un cliente che non Le ha scritto nelle ultime 24 ore. Questa pagina spiega come scriverne uno in WASync, che cosa succede presso Meta e da quali punti può inviarlo.
Che cos'è un modello e quando serve
WhatsApp concede a un'azienda una finestra di assistenza clienti di 24 ore. Si apre quando il cliente Le scrive e resta aperta per 24 ore dopo il suo ultimo messaggio.
- Dentro la finestra può inviare qualsiasi testo libero, file o messaggio vocale.
- Fuori dalla finestra (il cliente non ha mai scritto, oppure ha scritto più di 24 ore fa) parte solo un modello approvato. Quando il cliente risponde, la finestra si riapre per 24 ore.
In WASync Chat, una finestra chiusa mostra il banner Conversazione in pausa: invii un modello per riprendere il contatto con un pulsante Scegli un modello, mentre un chip nell'intestazione della chat indica quanto tempo resta della finestra.
Ogni modello appartiene a una di tre categorie, che Meta usa per la revisione e per la fatturazione:
| Categoria | Quando usarla |
|---|---|
| Utility | Un aggiornamento su qualcosa che il cliente ha già avviato: conferma di un appuntamento, stato di un ordine, fattura, consegna, promemoria di pagamento. |
| Marketing | Offerte, promozioni, novità, ripresa dei contatti con un cliente passato. |
| Authentication | Codici monouso, con testo stabilito da Meta. WASync non può ancora crearli. |
I messaggi modello sono fatturati da Meta per ogni messaggio modello, in base alla categoria (marketing, utility, authentication). I modelli Utility inviati all'interno di una finestra di assistenza clienti di 24 ore aperta sono gratuiti. L'addebito avviene sul metodo di pagamento del Suo account Meta, non tramite WASync. Creare o inviare un modello per approvazione non ha alcun costo.
Requisiti
- Un numero WABA collegato a WASync, con il piano WABA. Veda Tipi di connessione per le differenze rispetto a un numero associato tramite QR.
- Per gestire i modelli: un amministratore, oppure un membro del personale con accesso in scrittura a Numeri WhatsApp e modelli (matrice degli accessi del personale). Per leggere l'elenco basta l'accesso in lettura.
- Per inviarli: l'accesso al numero in Connections → Staff, come per qualsiasi messaggio.
I numeri associati tramite QR non possono inviare modelli
I modelli esistono solo sulla WhatsApp Business API ufficiale. Su un numero associato tramite QR il pulsante dei modelli non è disponibile, e un robot o un'automazione che tenta di inviarne uno fallisce con: This WhatsApp connection cannot send templates. Templates need a WhatsApp Business (Cloud API) number.
Creare un modello
Apra l'app WASync in Bitrix24, vada su Connections, apra il menu … del numero WABA e scelga Message templates. L'elenco mostra ogni modello con lingua, categoria, stato e, per quelli rifiutati, il motivo indicato da Meta. Faccia clic su + New template.
A che cosa serve il messaggio?
Scelga Inform a customer (Utility), Promote an offer (Marketing) oppure Send a code (contrassegnato Coming soon). La scelta imposta la categoria al posto Suo. Sia onesto in questo passaggio: un testo promozionale inviato come Utility viene rifiutato da Meta o spostato in Marketing.
Può anche partire da un esempio (Appointment reminder, Order is ready, Offer with an image, Let's pick up the conversation) e modificare tutto nel passaggio successivo. Scelga la Message language. Un modello ha una sola lingua; per un'altra lingua crei un altro modello.
Scrivere il messaggio
Scriva il testo così come lo riceverà il cliente; l'anteprima a destra è ciò che vedrà (fino a 1.024 caratteri).
- Personalizzare. Faccia clic su + Personalize per aggiungere una variabile: una
comune (Customer name, Date, Time, Order number, Expiry date, Product or
service, Amount), un campo di Bitrix24 oppure un'etichetta propria. Dietro le
quinte ognuna diventa
{{1}},{{2}}e così via. Non digiti le parentesi graffe a mano. - Esempi per l'approvazione. Meta richiede un valore di esempio realistico per ogni variabile (per esempio «Ana», «31 ottobre»). Usi valori verosimili, mai dati reali di clienti. Non vengono inviati a nessuno.
- Intestazione (facoltativa). Un titolo (fino a 60 caratteri, senza variabili), oppure un'Image (JPEG o PNG, fino a 5 MB), un Video (MP4, fino a 16 MB) o un PDF (fino a 16 MB). Il file che carica è l'esempio che Meta esamina. WASync lo conserva come file predefinito del modello, così agli operatori non viene richiesto di nuovo.
- Altre opzioni. Un piè di pagina (fino a 60 caratteri), fino a 3 pulsanti di risposta rapida, un pulsante con link (un URL fisso, senza variabili), un pulsante di chiamata e Include a WhatsApp call-permission request. Le etichette dei pulsanti sono limitate a 25 caratteri.
WhatsApp rifiuta un messaggio che inizia o termina con una variabile: aggiunga quindi una parola prima della prima e dopo l'ultima. WASync verifica questa e le altre regole prima di consentirLe di proseguire.
Inviare per l'approvazione
Assegni al modello un Template name che il Suo team riconosca (lo vede solo il Suo
team). WASync genera il nome tecnico richiesto da Meta: lettere minuscole, cifre e _,
univoco per questo numero e questa lingua. L'elenco di controllo mostra che cosa è stato
verificato. Faccia clic su Send to WhatsApp for approval. Ai clienti non viene inviato
nulla.
Non esiste la bozza: l'elenco rispecchia ciò che ha Meta, quindi un modello esiste in WASync solo dopo essere stato inviato.
Dopo l'invio
Il modello compare nell'elenco come Pending. Meta lo esamina: di solito in pochi minuti, a volte in qualche ora e, di rado, fino a un giorno. WASync riceve automaticamente il verdetto di Meta e aggiorna lo stato. Resync from Meta recupera lo stato aggiornato se desidera verificarlo subito.
| Stato | Significato |
|---|---|
| Pending | Meta lo sta esaminando. Non può ancora essere inviato. |
| Approved | Pronto. È l'unico stato che consente l'invio. |
| Rejected | Meta lo ha rifiutato. Il motivo è indicato sulla scheda. Corregga il testo e crei un nuovo modello. |
| Paused | Meta lo ha messo in pausa. Gli invii falliscono finché non torna attivo. |
| Disabled, In appeal, Pending deletion, Deleted, Limit exceeded | Stati propri di Meta, mostrati così come vengono ricevuti. |
✕ su una scheda elimina il modello, e lo elimina anche presso Meta.
Il file predefinito di un modello con contenuti multimediali
Un modello con intestazione di tipo immagine, video o PDF richiede quel file a ogni invio. Meta conserva la propria copia solo per la revisione, quindi WASync conserva l'esempio caricato come file predefinito del modello. Per un modello approvato prima di questa funzione, o creato in Meta, usi Set default image (oppure video, document) sulla sua scheda; sono disponibili anche Change e Remove. Senza un file predefinito, chi invia sceglie il file ogni volta.
Modelli creati in Meta
I modelli creati in WhatsApp Manager non sono presenti in WASync finché non fa clic su Resync from Meta nell'elenco dei modelli. La risincronizzazione li importa con i loro pulsanti e la loro intestazione, aggiorna ogni stato e contrassegna un modello come Deleted quando non esiste più presso Meta. Può eseguirla in qualsiasi momento senza rischi.
Inviare un modello
Tutti e tre i metodi seguenti inviano solo modelli Approved, solo da un numero WABA, e rifiutano un contatto che ha chiesto di non ricevere più messaggi. Se un cliente risponde con una richiesta di interruzione, WASync lo contrassegna come disiscritto; un amministratore può rimuovere la disiscrizione quando la persona chiede di essere ricontattata.
Dalla chat
Nella scheda WASync di un lead, di una trattativa o di un elemento di Smart Process, e in WASync Chat, faccia clic sull'icona dei modelli accanto alla casella del messaggio (Send a Meta-approved template). Quando la finestra di 24 ore è chiusa, il pulsante Pick a template nel banner apre lo stesso elenco.
- Cerchi per nome, lingua o testo e scelga un modello.
- Compili ogni variabile. La prima è precompilata con il nome del contatto, se noto; la modifichi se necessario. L'anteprima mostra il messaggio finito.
- Se il modello ha un'intestazione multimediale, scelga il file: quello predefinito del modello (preselezionato, se presente) oppure ne carichi un altro. Send resta disattivato finché non viene scelto un file.
- Se lo desidera, spunti Also ask permission for a WhatsApp call after sending (nascosto quando il modello richiede già l'autorizzazione alla chiamata).
- Faccia clic su Send. Il messaggio compare nella conversazione e nella cronologia del record, con il testo finale.
Dalle regole di automazione di Bitrix24
Apra la fase del lead, della trattativa o dello Smart Process → Automation rules → Add automation e scelga Send WhatsApp Template (WABA) nel gruppo WASync. La regola viene eseguita per ogni record che raggiunge quella fase, un record alla volta.
- WABA Connection: il numero che invia.
- Template: sono elencati solo i modelli approvati di quel numero.
- Variables: una riga per ogni
{{n}}. Faccia clic su ⋯ per aprire Insert Field e scegliere i campi del CRM, oppure digiti del testo. Una riga può combinare più campi e testo fisso. I campi vengono letti dal record su cui viene eseguita la regola. - Header image / video / document: per un modello multimediale, scelga File or link (carichi un file, oppure incolli un link o un campo che ne contiene uno) oppure Template's example (il file predefinito conservato da WASync).
Il destinatario è il telefono del cliente del record. Una trattativa che non ha ancora un contatto viene ricontrollata in background prima che WASync rinunci.
Quando qualcosa blocca un invio, il motivo viene scritto nella cronologia del record invece di fallire in silenzio: una variabile risultata vuota, un modello non più approvato, un file di intestazione mancante, un contatto disiscritto o un problema di licenza. Le variabili vuote bloccano l'invio perché Meta rifiuta i parametri vuoti.
Dopo aver installato o aggiornato WASync, ricarichi una volta la pagina delle automazioni: Bitrix24 conserva in cache le definizioni dei robot fino al ricaricamento della pagina.
Da Chat Flows
Nell'editor dei flussi, un passaggio Message ha una sezione chiamata WhatsApp
Business template (window closed). Scelga il numero e un modello approvato, compili ogni
variabile (un campo del CRM come {{NAME}} oppure testo fisso) e, per un modello
multimediale, il file dell'intestazione.
Il modello viene usato solo quando il numero è un numero WABA e la finestra di 24 ore è chiusa, per esempio per il primo messaggio a un cliente che non ha mai scritto. Se la finestra è aperta, il passaggio invia il normale testo. Se la finestra è chiusa e il passaggio non ha un modello, fallisce con On a WhatsApp Business number the first message must use an approved template. I file allegati al passaggio non vengono inviati con un modello. Una variabile vuota viene sostituita da un trattino invece di bloccare il passaggio. Se Meta risponde con un errore temporaneo, il passaggio riprova una volta prima di fallire.
Che cosa non è incluso: le campagne di massa
WASync non ha un modulo per campagne di massa o broadcast: non è possibile caricare un elenco e inviare un modello a tutti. Ciò che fa è inviare un modello per ogni record del CRM quando viene eseguita una regola di automazione. Per scrivere a un segmento, inserisca quei lead o quelle trattative in una fase (o li sposti lì) e lasci che la regola Send WhatsApp Template (WABA) venga eseguita su quella fase.
Rispettare i limiti di Meta
- Ogni numero ha un limite di messaggistica che dipende dal suo livello di qualità (la pagina Connections mostra il livello assegnato da Meta, per esempio 1.000 clienti ogni 24 ore). Gli invii oltre il limite falliscono.
- Scriva solo a persone che si aspettano di sentirLa. Ogni blocco o segnalazione abbassa la valutazione della qualità; una valutazione più bassa riduce il limite, e un modello con feedback negativi può essere messo in pausa.
- Dica chi è nella prima riga e spieghi come interrompere la ricezione. Rispetti ogni richiesta di interruzione: WASync blocca i modelli verso i contatti disiscritti.
- Quando Meta limita o restringe il numero, la pagina Connections e la finestra dei modelli mostrano un banner (Meta has blocked sending on this number oppure Meta has limited sending on this number) con le indicazioni su come procedere e un link a Meta Account Quality.
Risoluzione dei problemi
| Che cosa vede | Che cosa fare |
|---|---|
| Stato Rejected, con un motivo sulla scheda | Legga il motivo indicato da Meta. Le cause più comuni sono un testo promozionale in un modello Utility, una variabile all'inizio o alla fine del testo, oppure esempi mancanti. Crei un modello corretto con un nuovo nome. |
| Stato Paused | Meta ha messo in pausa il modello, di solito per i feedback negativi dei clienti. Migliori il testo oppure crei un nuovo modello. Non continui a inviare un modello in pausa. |
| Banner Meta has blocked / limited sending on this number | Apra Meta Account Quality con il pulsante del banner e segua i passaggi indicati: metodo di pagamento, verifica dell'azienda o ricorso. Gli invii e i nuovi modelli restano bloccati finché Meta non toglie la restrizione. |
| Access token expired or invalid nella finestra dei modelli | Nella pagina Connections, esegua Connect with Facebook su quel numero per aggiornare il token. |
| Il modello non compare nell'elenco durante l'invio | Compaiono solo i modelli Approved. Controlli lo stato, poi faccia clic su Resync from Meta. |
| Errore di variabile durante la creazione (isn't a valid variable, needs a CRM field and an example value) | Aggiunga le variabili con + Personalize, senza digitare le parentesi graffe, e assegni a ciascuna un esempio. La numerazione deve procedere 1, 2, 3 senza salti. |
| Il robot non ha inviato, la cronologia riporta empty variable(s) | Un campo associato a una variabile era vuoto su quel record. Compili il campo nel record, oppure cambi la variabile con un altro campo o con testo fisso. |
| This template has a … header, oppure l'invio è disattivato | Un modello multimediale richiede il suo file. Scelga un file al momento dell'invio, nella regola o nel passaggio, oppure imposti il file predefinito del modello. |
| This WhatsApp connection cannot send templates | Il numero è associato tramite QR. Usi un numero WABA. |
| Templates to this contact are blocked: this contact asked to stop receiving messages | Il contatto si è disiscritto. Può comunque rispondere ai messaggi che Le invia. Un amministratore può rimuovere la disiscrizione solo se la persona ha chiesto di essere ricontattata. |
Vedi anche
- Tipi di connessione: numeri associati tramite QR e numeri WABA.
- Portare un numero da un altro provider: spostare in WASync un numero WABA esistente.
- Smart Processes (SPA) in WASync: il robot dei modelli funziona anche con le regole di automazione degli Smart Process.
Smart Processes (SPA) in WASync
Utilizzi WhatsApp sugli elementi di Bitrix24 Smart Processes — la scheda WASync nella card dell'elemento, le conversazioni collegate agli elementi, i robot e i Chat Flows sulle regole di automazione SPA, e di cosa ha bisogno un elemento perché tutto funzioni.
OAuth2 per app di terze parti
Solo per le app che altri clienti WASync installano. Authorization Code con PKCE, refresh token a rotazione e un limite strutturale.