WhatsApp

GetMyBot collega WhatsApp tramite WhatsApp Cloud API (Meta Graph API). Dopo il collegamento il bot riceve i messaggi in ingresso da WhatsApp e vi applica le tue reazioni, mentre gli operatori possono gestire le conversazioni nei dialoghi. Panoramica generale della multicanalità — nella pagina Canali.

Collegamento del canale WhatsApp

Per il collegamento servono cinque credenziali della tua app Meta (WhatsApp Cloud API). Sono tutte obbligatorie:

  • Phone number ID — l'identificatore del numero WhatsApp Business.
  • WABA ID — l'identificatore del WhatsApp Business Account.
  • Access token — il token di accesso dell'app Meta.
  • Verify token — una stringa arbitraria che scegli tu. Viene usata durante la verifica del webhook in Meta (vedi sotto).
  • App secret — il segreto dell'app Meta. Serve per verificare la firma HMAC dei webhook in ingresso (intestazione X-Hub-Signature-256).

Passi nell'interfaccia:

  1. Apri Bot → «Aggiungi canale» → WhatsApp.
  2. Compila i cinque campi sopra e, se vuoi, il nome del canale (facoltativo).
  3. Premi «Verifica» — GetMyBot valida le credenziali tramite Meta.
  4. Premi «Collega».

Configurazione del webhook in Meta

Dopo il collegamento il canale ottiene un Callback URL nella forma {indirizzo}/ch/{channelID} (nell'interfaccia — icona del webhook 🔗). Va indicato, insieme al tuo Verify token, nell'app Meta: WhatsApp → Configuration → Webhook.

Come funziona:

  1. Meta invia al Callback URL una richiesta di verifica e confronta il verify_token trasmesso con il tuo Verify token. In caso di corrispondenza il webhook è considerato confermato.
  2. Successivamente Meta invia a questo indirizzo gli eventi (messaggi in ingresso, stati di consegna, verdetti di moderazione dei template).
  3. Ogni richiesta in ingresso è firmata con l'intestazione X-Hub-Signature-256; GetMyBot verifica la firma con l'App secret — ecco perché questa credenziale è richiesta al collegamento.

Finestra di sessione di 24 ore

WhatsApp limita la comunicazione su iniziativa del bot: i messaggi liberi possono essere inviati all'utente solo entro 24 ore dal suo ultimo messaggio in ingresso. Ogni nuovo messaggio in ingresso dall'utente rinnova la finestra.

Fuori dalla finestra di 24 ore non è possibile inviare un messaggio libero — l'unico modo per riscrivere all'utente (re-engage) è un template di messaggio approvato. Per questo i template sono lo strumento chiave per invii e promemoria su WhatsApp.

Template di messaggi

Un template (message template) è un messaggio concordato in anticipo con Meta, che può essere inviato fuori dalla finestra di sessione. La gestione dei template avviene nell'interfaccia di GetMyBot.

Dove gestire i template

Bot → sul canale WhatsApp l'icona «Template di messaggi» (📄) → dialogo «Template del canale WhatsApp». Nel dialogo ci sono i pulsanti:

  • «Crea template» — costruire un nuovo template.
  • «Sincronizza» — recuperare il catalogo dei template da Meta (aggiornare stati ed elenco).

Categorie dei template

  • MARKETING (Marketing) — promozioni, annunci, invii.
  • UTILITY (Servizio) — notifiche relative alle azioni dell'utente (stati degli ordini, promemoria).
  • AUTHENTICATION (Autenticazione) — codici di conferma.

Campi del template

  • Nome — lettere latine minuscole, cifre e _, fino a 512 caratteri.
  • Lingua — locale di Meta.
  • Categoria — una delle tre sopra.

Per le categorie Marketing e Servizio, in aggiunta:

  • Intestazione — nessuna / testo / immagine / video / documento. Per l'intestazione multimediale si carica un file di esempio.
  • Corpo — obbligatorio, fino a 1024 caratteri. Le variabili si indicano con {{1}}, {{2}}, … rigorosamente in ordine da 1 a N, senza salti.
  • Piè di pagina — fino a 60 caratteri.
  • Pulsanti — fino a 10: risposta rapida, link (fino a 2), telefono (1), copia del codice (1).
  • Per ogni variabile {{n}} va indicato un valore di esempio — è un requisito di Meta per la moderazione.

Per la categoria Autenticazione il corpo è fissato da Meta stessa; si configurano: la validità del codice (1–90 minuti), il consiglio di sicurezza e il testo del pulsante di copia del codice.

Moderazione

Il pulsante «Crea» invia subito il template alla moderazione di Meta — non esiste un passaggio separato «invia in revisione». Il verdetto arriva in modo asincrono (tramite webhook) e l'elenco dei template si aggiorna automaticamente. Stati:

  • PENDING (In revisione)
  • APPROVED (Approvato)
  • REJECTED (Rifiutato) — con indicazione del motivo
  • oltre a PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION.

Si possono modificare i template negli stati APPROVED, REJECTED, PAUSED. Nome e lingua non si possono cambiare; per i template approvati anche la categoria è bloccata.

Uso di un template in una reazione

L'invio di un template è un'azione della reazione:

  1. Nel costruttore della reazione apri «Azioni» → «Aggiungi azione» → «Invia template WhatsApp».
  2. L'azione è disponibile solo se il bot ha collegato un canale WhatsApp con supporto ai template.
  3. Si sceglie solo un template approvato (APPROVED).
  4. Si compilano i parametri: i valori delle variabili {{n}} nel corpo, l'intestazione testuale, l'intestazione multimediale tramite link, i parametri dei pulsanti URL. Nei parametri si possono usare le sostituzioni-variabili.

Il canale di invio effettivo è determinato dal canale dell'evento: se l'evento è arrivato da WhatsApp, il template partirà su WhatsApp.

Dialoghi e allegati

L'operatore può rispondere nel dialogo WhatsApp e inviare allegati — immagine, video o documento — nel rispetto della finestra di 24 ore (fuori dalla finestra la comunicazione libera non è disponibile). I media in ingresso dagli iscritti vengono recuperati tramite proxy e mostrati nel dialogo.

Tariffazione

GetMyBot tiene traccia delle conversazioni WhatsApp (conversations) per categoria — marketing / utility / authentication / service. Nella versione attuale si tratta solo di una registrazione a fini di osservabilità (record-only): il saldo per le conversazioni non viene addebitato.

Passo successivo

  • Canali — multicanalità e matrice delle capacità.
  • Reazioni: le basi — come costruire il comportamento del bot.
  • Invii massivi — invio di massa (su WhatsApp — tramite template approvati).