Manuale utente

Manuale utente di Migasender

Tutto quello che serve per collegare i tuoi numeri WhatsApp, rispondere ai clienti, inviare campagne e tenere sotto controllo consumi e consegne.

Versione 1.0 Aggiornato il 28 settembre 2026 I dati mostrati nelle immagini sono di esempio

Nessun risultato. Prova con un termine più corto, oppure svuota la ricerca con Esc.

Capitolo 1

Benvenuto in Migasender

Che cos'è, a cosa serve e il vocabolario che userai in tutto il manuale.

Migasender collega i numeri WhatsApp della tua azienda a un pannello unico. Da lì puoi rispondere alle conversazioni, inviare campagne a liste di contatti, far rispondere un assistente AI quando non sei disponibile e verificare quanti messaggi sono stati consegnati e letti.

Il pannello di Migasender aperto sulla pagina Gestione Linee
Fig. 1.1 — Il pannello subito dopo l'accesso. A sinistra il menu, al centro le linee collegate.

Parole che ricorrono

TermineSignificato
LineaUn numero WhatsApp collegato al pannello. Puoi averne più di uno.
IstanzaLa sessione tecnica che tiene il numero connesso. Ogni linea ne ha fino a due.
MasterLa connessione principale. I messaggi partono da qui.
SlaveLa connessione di riserva. Se il Master cade, l'invio passa qui da solo.
Codice QRIl codice che si inquadra con WhatsApp sul telefono per collegare il numero.
TemplateUn messaggio preapprovato da Meta, necessario per scrivere per primo a un cliente.
Cloud API / WABAIl canale ufficiale di Meta. Migasender lo usa come riserva quando serve.
BroadcastUn invio a molti contatti in una volta sola.
RoundbinUn gruppo di linee fra cui i messaggi vengono distribuiti a turno.
Anti-banLe protezioni che rallentano gli invii per non far bloccare il numero.
Nota

Tutte le immagini di questo manuale usano dati di esempio: numeri, nomi e indirizzi non appartengono a persone reali.

Capitolo 2

Primo accesso

Entrare nel pannello e recuperare la password.

Schermata di accesso a Migasender
Fig. 2.1 — La schermata di accesso.

Come accedere

  1. Apri https://dashboard.migasender.com. L'indirizzo è lo stesso per tutti, qualunque sia la piattaforma del tuo account.
  2. Scrivi il tuo indirizzo email e la password.
  3. Premi Accedi.
  4. Se hai una sola app, si apre subito. Se ne hai più di una, compare una finestra per scegliere su quale lavorare.
Da sapere

Se la tua email ha account su più piattaforme, dopo l'accesso vedi insieme le app di tutte.

I vecchi preferiti con /p/… nell'indirizzo funzionano ancora; non serve cambiarli.

Dopo 10 password errate in 15 minuti l'accesso viene bloccato per 15 minuti. Attendi e riprova (oppure reimposta la password come spiegato sotto).

Quando un'app è aperta, l'indirizzo nel browser diventa https://dashboard.migasender.com/p/ seguito da un codice lungo: quel codice è il token di registrazione della tua piattaforma (vedi sotto). Puoi cambiare app in qualsiasi momento dal pulsante Cambia App in alto a sinistra.

Password dimenticata

Modulo per reimpostare la password
Fig. 2.2 — Il modulo di recupero password.
  1. Apri https://dashboard.migasender.com e premi Password Dimenticata?.
  2. Inserisci l'email con cui ti registri e premi Invia Link Reset.
  3. Apri il messaggio che ricevi e segui il link.
  4. Scrivi due volte la nuova password (almeno 8 caratteri) e premi Salva Nuova Password. Tornerai alla schermata di accesso.
Suggerimento

Il link arriva all'indirizzo che hai scritto, non a quello dell'azienda. È valido per 1 ora e funziona una sola volta; se è scaduto, richiedine uno nuovo. Se la tua email ha account su più piattaforme, la nuova password vale per tutti. Se non lo trovi entro qualche minuto, controlla la posta indesiderata.

Se la schermata dice che il reset della password via email non è disponibile su questa piattaforma, la piattaforma non ha ancora un'email in uscita configurata. Contatta l'assistenza, che reimposterà la password per te.

Il token di registrazione della piattaforma

Il token di registrazione è il codice lungo dopo /p/ nei tuoi indirizzi. Identifica la tua piattaforma ed è obbligatorio in ogni chiamata API, che inizia sempre con https://apidb.migasender.com/p/<token di registrazione>/ (vedi il riferimento API). Lo trovi in tre posti:

DoveCome trovarlo
L'indirizzo del tuo pannelloGuarda la barra degli indirizzi del browser mentre sei collegato: il token è tutto ciò che segue /p/. In https://dashboard.migasender.com/p/907a0888…c1f61b il token è 907a0888…c1f61b.
Il vecchio backoffice (Siberian)
  1. Accedi al backoffice Siberian (ad esempio https://<tuo-dominio>/backoffice).
  2. Nel menu in alto apri Manage → Modules → Migawhatsapp. L'indirizzo della pagina termina con /migawhatsapp/backoffice_migawhatsapp.
  3. Scorri fino alla sezione Migration e cerca la tua app (usa Search per nome o ID). Lo Status deve essere MIGRATED; per le app ancora OFF la colonna mostra solo un trattino.
  4. La colonna New endpoint ha due caselle: in alto l'indirizzo API https://apidb.migasender.com/p/<token>, in basso l'indirizzo del pannello https://dashboard.migasender.com/p/<token>. Il pulsante verde accanto a ciascuna la copia.
  5. Il token è la parte dopo /p/; è lo stesso in entrambe le caselle.
Il pannello di amministrazione MigasenderSolo per gli amministratori di piattaforma: accedi a https://apidb.migasender.com/panel/, apri Piattaforme e leggi la colonna Token di registrazione accanto alla tua piattaforma.
Nota

Tieni il token riservato: insieme al security token permette di chiamare l'API per la tua piattaforma. Se è stato condiviso per errore, un amministratore di piattaforma può generarne uno nuovo dal pannello di amministrazione; indirizzi e integrazioni vanno poi aggiornati con il nuovo codice.

Il platform token (API Linee, QR, Istanze e Gruppi)

Attenzione

Il platform token va richiesto all'amministratore della piattaforma. Non è mostrato nella dashboard cliente né nel pannello degli endpoint API.

Il platform token è un codice separato di 64 caratteri, diverso dal token di registrazione. Le API Gestione Linee, QR Code, Istanze / Line Log e Gruppi lo richiedono nel corpo della richiesta: come platform_token per api_qr/*, api_linelog/* e Gruppi, e come security_token per api_line/* e api_instances/*. Tutti gli altri parametri funzionano esattamente come nell'API legacy; l'unica novità è il prefisso /p/<token di registrazione>/ nell'indirizzo.

Il platform token non è visibile nel pannello cliente. Chiedilo all'amministratore della tua piattaforma. Gli amministratori lo trovano in due posti, ed è lo stesso token in entrambi:

DoveCome trovarlo
Il vecchio backoffice (Siberian)Manage → Modules → Migawhatsapp, riquadro Platform Token for API.
Il pannello di amministrazione MigasenderAccedi a https://apidb.migasender.com/panel/ → Settings → Platform Token for API.
Nota

Se qui invii il token di registrazione o il token Send Message, la risposta è Platform token mismatched. o Security token mismatched. Il platform token dà accesso a tutte le app e le linee della piattaforma: tienilo riservato. Se viene rigenerato nel pannello di amministrazione, quello vecchio smette subito di funzionare e tutte le integrazioni vanno aggiornate.

Capitolo 3

Come è fatta l'interfaccia

Il menu di sinistra, la barra in alto, il tema e l'uso da telefono.

Menu laterale con le otto sezioni di Migasender
Fig. 3.1 — Le otto sezioni del pannello.
VoceA cosa serve
Gestione LineeCollegare i numeri e controllarne lo stato.
LogElenco dettagliato di ogni messaggio entrato e uscito.
Statistiche TTS e STTNumeri di consegna, lettura e consumo di voce e AI.
ChatRispondere alle conversazioni in corso.
BroadcastRubrica, gruppi, invii a liste e loro cronologia.
TemplateMessaggi preapprovati da Meta e configurazione WABA.
RoundbinDistribuire gli invii su più linee a turno.
ImpostazioniCredenziali, notifiche, webhook e accesso API.

In fondo al menu trovi la versione del pannello e un indicatore Online che conferma il collegamento con il server.

La barra in alto

Barra superiore con selettore azienda, messaggi rimasti e comandi
Fig. 3.2 — La barra superiore.
  • Cambia App — passa da un'azienda all'altra, se ne gestisci più di una.
  • Messaggi Rimasti — quanti messaggi puoi ancora inviare nel mese in corso.
  • Lingua — italiano o inglese; la scelta resta memorizzata.
  • Reset Modulo — riporta la configurazione allo stato iniziale. Da usare solo su indicazione dell'assistenza.
  • Supporto — l'icona con il punto interrogativo apre le domande frequenti su un'altra scheda del browser.
  • Tema — passa fra chiaro e scuro.
  • Account — esci dal pannello.
Attenzione

Reset Modulo azzera la configurazione del modulo. Non è un semplice aggiornamento della pagina: usalo solo se l'assistenza te lo chiede espressamente.

Lingua e tema

Menu a tendina per scegliere la lingua del pannello
Fig. 3.3 — Il selettore della lingua.
Il pannello con il tema scuro attivo
Fig. 3.4 — Lo stesso pannello con il tema scuro.

Da telefono

Migasender su schermo di telefono
Fig. 3.5 — Su schermi stretti le linee si dispongono in colonna.

Il menu laterale si trasforma in un pannello a scomparsa: si apre con l'icona a tre righe in alto a sinistra.

Menu a scomparsa aperto su telefono
Fig. 3.6 — Il menu a scomparsa su telefono.

Capitolo 4

Gestione Linee

La pagina da cui controlli, in un colpo d'occhio, se i tuoi numeri sono attivi.

Pagina Gestione Linee con tre linee configurate
Fig. 4.1 — Gestione Linee. In alto i limiti del piano, sotto una scheda per ogni numero.

I due riquadri in alto

  • Numero massimo di linee — quante linee prevede il tuo piano.
  • Messaggi massimi / mese — il tetto mensile di messaggi.

La scheda di una linea

Scheda di una singola linea con stato Master e Slave
Fig. 4.2 — La scheda di una linea.
  • Nome e ID — come hai chiamato la linea e il suo identificativo. CORRENTE segnala la linea usata di default.
  • Numero — il numero WhatsApp collegato.
  • Modifica Linea — apre la configurazione (capitoli 5 e 6). Se la linea non è ancora pronta, il pulsante è Configura.
  • Master e Slave — lo stato delle due connessioni.
  • Ultimo controllo — quando il pannello ha verificato lo stato l'ultima volta.
  • Trust Score — un indicatore di salute del numero.
  • Scadenza — fino a quando la linea è attiva.
  • Stato configurazione — CONFIGURATO oppure NON CONFIGURATO.

Cosa significano gli stati

StatoSignificatoCosa fare
CONNESSOIl numero è attivo e può inviare e ricevere.Nulla.
IN AVVIOLa sessione si sta avviando.Attendi qualche secondo e aggiorna.
SCANSIONA QRServe inquadrare il codice QR.Vai al capitolo 5.
DISCONNESSOLa sessione è caduta.Ricollega il numero con un nuovo QR.
N/ALa linea non è ancora stata configurata.Premi Configura.

Il menu delle azioni

L'icona con i tre puntini in alto a destra di ogni scheda apre le azioni disponibili su quella linea.

Menu a tre puntini aperto su una scheda linea
Fig. 4.3 — Il menu delle azioni di una linea.
AzioneChe cosa fa
ModificaApre la procedura guidata della linea, come il pulsante Modifica Linea.
Reset?Riavvia la sessione della linea.
Ricarica Stato?Richiede al server lo stato aggiornato di questa sola linea.
ImpostazioniVa direttamente al passo 3 della procedura, quello delle impostazioni.
Log TelemetriaMostra gli eventi tecnici della linea (vedi sotto).
Reindirizza WebhookRipunta il webhook della sessione WhatsApp a questo server.
Importante

Reset? interrompe la sessione: per qualche istante la linea non invia né riceve. Usalo quando una linea resta bloccata, non come primo tentativo.

Nota

Reindirizza Webhook serve quando i messaggi in arrivo smettono di comparire perché la linea sta ancora inviando gli eventi a un vecchio indirizzo. Non tocca la connessione WhatsApp.

Log Telemetria

Pannello dei log di telemetria con le schede Gateway Master e Slave
Fig. 4.4 — I log di telemetria di una linea. In questo esempio la linea non ha avuto eventi negli ultimi due giorni, quindi il pannello mostra lo stato vuoto.

La telemetria elenca gli eventi tecnici scambiati fra la linea e il server negli ultimi 2 giorni, divisi in due schede: Gateway Master e Gateway Slave. L'intestazione ricorda di quale linea si tratta e quando la vista è stata aggiornata, e il campo sotto cerca fra le voci.

Quando ci sono eventi, ognuno compare con il proprio esito — riuscito o errore — data e ora, e il contenuto grezzo ricevuto dal server. Un pannello vuoto non è un guasto: significa solo che in quella finestra da quel gateway non è passato nulla.

Suggerimento

È il posto giusto quando una linea si comporta in modo strano ma i Log dei messaggi non mostrano nulla: qui vedi se il server sta effettivamente ricevendo eventi da quella linea.

La barra degli strumenti

  • Cerca linee… — filtra per nome o numero.
  • Le due icone accanto alla ricerca passano fra vista a schede e vista tabella.
  • Copia, CSV, Excel — esportano l'elenco delle linee.
  • Ricarica Linee — rilegge l'elenco dal server.
  • Aggiorna stato linee — richiede lo stato aggiornato di ogni connessione.
Suggerimento

Se una linea risulta disconnessa ma il telefono è acceso e collegato a internet, prova prima Aggiorna stato linee: spesso lo stato mostrato è solo vecchio.

Capitolo 5

Collegare un numero WhatsApp

La procedura guidata in tre passi.

Passo 1 — i dati della linea

Passo 1 della procedura: nome linea e numero WhatsApp
Fig. 5.1 — Passo 1 di 3.

Il pannello si intitola Crea Nuova Linea, sia che tu stia aggiungendo un numero sia che tu ne stia modificando uno esistente.

  1. Dai un Nome Linea riconoscibile, per esempio «Assistenza» o «Vendite».
  2. Scrivi il Numero WhatsApp completo di prefisso internazionale, per esempio +39320….
  3. Premi Prossimo Passo.
Importante

Il numero deve corrispondere esattamente a quello che userai per inquadrare il QR. Se non coincide, la connessione viene rifiutata.

Passo 2 — collegare il telefono

Passo 2: registrazione istanza con connessione principale e di riserva
Fig. 5.2 — Passo 2 di 3: la connessione principale è già collegata, quella di riserva no.

Il pannello si intitola Instance Registration (Registrazione Istanza) e contiene due blocchi.

  • Connessione Principale — obbligatoria. È da qui che partono i messaggi.
  • Connessione di Riserva — facoltativa. Se la principale cade, l'invio passa automaticamente a questa e i messaggi continuano ad arrivare.

Come si inquadra il codice

  1. Premi Carica Codice QR.
  2. Sul telefono apri WhatsApp e vai su Impostazioni → Dispositivi collegati → Collega un dispositivo.
  3. Inquadra il codice mostrato sullo schermo.
  4. Quando lo stato diventa CONNESSO, premi Invia Messaggio di Test per la conferma finale.
Nota

Il codice QR scade dopo pochi secondi: è una misura di sicurezza di WhatsApp. Se sfuma, premi di nuovo per generarne uno nuovo. Le richieste di QR sono limitate nel tempo, quindi evita di premere ripetutamente.

Passo 3 — le impostazioni

Passo 3: pannelli di configurazione della linea
Fig. 5.3 — Passo 3 di 3: quattro pannelli richiudibili.

L'ultimo passo si intitola Impostazioni Istanza e raccoglie quattro pannelli — Generale, Fallback Meta Cloud API, Integrazione Migachat e Notifiche Stato Linea — descritti nei due capitoli che seguono. Al termine premi Salva.

Suggerimento

Puoi salvare subito con i valori predefiniti e tornare a rifinire le impostazioni più tardi da Modifica Linea. La linea funziona già.

Capitolo 6

Impostazioni della linea

I pannelli Generale, Migachat e Notifiche.

Generale

Pannello Generale con ritardo messaggi e webhook di consegna
Fig. 6.1 — Il pannello Generale.
ImpostazioneChe cosa fa
Intercettazione push individualeConsente al pannello di intercettare le notifiche dei singoli messaggi.
Push individuale senza tokenAccetta le notifiche anche quando non arriva un token di sicurezza.
Ritardo Messaggi WhatsAppQuanti secondi attendere fra un messaggio e il successivo. Più alto, più sicuro.
Messaggi massimi per oraIl tetto orario di invii dalla linea.
URL Webhook di ConsegnaUn indirizzo che Migasender chiama ogni volta che un messaggio cambia stato: consegnato, letto o fallito.
Importante

Ritardo e limite orario sono le due protezioni principali contro il blocco del numero. Abbassarli aumenta la velocità ma anche il rischio: modificali solo con cautela.

Integrazione Migachat

Pannello di integrazione con l'assistente Migachat
Fig. 6.2 — Collegamento all'assistente AI.

Attivando l'integrazione, i messaggi in arrivo su questa linea vengono inoltrati all'assistente AI, che prepara e invia la risposta. In Seleziona Istanza scegli quale assistente usare.

Nota

L'assistente risponde solo ai messaggi in arrivo. Le campagne che parti tu non vengono toccate.

Notifiche Stato Linea

Pannello notifiche con consenso GDPR ed elenco email
Fig. 6.3 — Avvisi via email e consenso GDPR.
  • Email di notifica — se attivo, ricevi un avviso quando la linea si disconnette.
  • Consenso GDPR — autorizza la memorizzazione e l'analisi delle conversazioni di questa linea. Se lo disattivi, l'analisi AI dei messaggi in arrivo viene disabilitata.
  • Email di Notifica — l'elenco degli indirizzi che riceveranno gli avvisi. Aggiungine quanti ne servono con Aggiungi Email.
Suggerimento

Indica almeno due indirizzi, di due persone diverse. Se la linea cade di venerdì sera, è la differenza fra accorgersene subito e accorgersene lunedì.

Capitolo 7

Fallback Meta Cloud API

La rete di sicurezza che fa arrivare i messaggi anche quando la linea normale non basta.

Pannello Fallback Meta Cloud API con soglia e template
Fig. 7.1 — Il pannello Fallback Meta Cloud API.

WhatsApp limita quanti messaggi un numero normale può inviare prima di risultare sospetto. Quando superi la soglia che imposti qui, Migasender non smette di inviare: passa al canale ufficiale di Meta, la Cloud API, che usa i template approvati.

ImpostazioneChe cosa fa
Fallback AttivoAccende o spegne l'intero meccanismo.
Soglia GiornalieraDopo quanti messaggi al giorno questa linea passa alla Cloud API. Minimo 1, predefinito 40.
Modalità SogliaSTANDARD: i contatti che ti hanno scritto negli ultimi 7 giorni non passano mai alla Cloud API e non vengono contati. STRICT: ogni messaggio conta, senza eccezioni. Vedi "Come funziona il contatore giornaliero" più sotto.
Attiva Fallback per l'AIVale solo per le risposte dell'assistente (AI): se è attivo e la soglia è raggiunta, l'assistente non viene chiamato e parte il template della linea. Per gli invii via API basta Fallback Attivo.
Template di FallbackIl template approvato da usare quando si passa alla Cloud API.
Variabili TemplateI valori da inserire nei segnaposto {{1}}, {{2}}… del template.
URL Webhook di ErroreIndirizzo chiamato quando anche l'invio via Cloud API fallisce, per esempio per far partire un SMS. Riceve event (waba_send_failed), app_id, line_id, phone, template_name, error, fallback_reason, reference (il valore passato nella chiamata API) e timestamp. Viene chiamato anche quando il numero non ha un account WhatsApp: non viene inviato nulla, fallback_reason vale number_not_on_whatsapp e template_name è vuoto. L'invio compare anche nella pagina Log come fallito.
Importante

Il fallback funziona solo se hai già almeno un template approvato da Meta e la configurazione WABA compilata. Vedi il capitolo 13.

Come funziona il contatore giornaliero

  • La soglia si conta per linea, non per contatto. Aggiungono uno solo i messaggi che passano dal controllo della soglia: il fallback deve essere attivo per quel messaggio (Fallback Attivo sulla linea, oppure un template di fallback nella chiamata API) e, in modalità STANDARD, un contatto che ha scritto negli ultimi 7 giorni viene saltato e non conta.
  • Il contatore torna a zero ogni giorno alle 00:00 UTC (in Italia l'01:00 d'inverno, le 02:00 d'estate).
  • Finché il contatore è sotto la soglia, i messaggi partono dalla linea come sempre. Dalla soglia in poi partono dalla Cloud API come template.
  • Il lato master e il lato slave di una linea hanno ciascuno il proprio contatore.
ModalitàChi viene contatoQuando usarla
STANDARDSolo i contatti che non ti hanno scritto negli ultimi 7 giorni (oggi escluso). Un contatto attivo riceve sempre il messaggio normale e non fa salire il contatore.La scelta abituale: chi sta già parlando con te continua a ricevere messaggi normali.
STRICTOgni messaggio, a chiunque.Quando la linea non deve mai superare la soglia, per esempio un numero nuovo o delicato.

Un template diverso per ogni messaggio

Il template impostato in questo pannello è lo stesso per tutti i messaggi. Un sistema che invia tramite API (avviso ordine pronto, compleanno, promemoria…) può invece inviare, con ogni messaggio, il template adatto. Se quel messaggio finisce nel fallback, Migasender usa il template della chiamata al posto di quello della linea. I parametri sono descritti nella documentazione API, alla voce fallback_template_name.

Un messaggio che porta il proprio template:

  • passa alla Cloud API alla soglia anche se sulla linea Fallback Attivo è spento;
  • passa alla Cloud API anche quando la linea non può inviare: la linea non esiste, non è connessa, oppure l'invio viene rifiutato (per esempio numero disconnesso o bannato). Senza template nella chiamata, questi casi restituiscono un errore come prima.
Importante

Se la linea non risponde in tempo, il messaggio non viene reinviato via Cloud API, perché potrebbe essere già stato consegnato e il cliente lo riceverebbe due volte.

Per sapere se è partito, invia con il messaggio un tuo reference e, prima di riprovare, chiedi a api_send/status con quel valore: la risposta è sent, not_sent o unknown. Quanto attendere prima di not_sent si imposta per ogni invio con not_sent_after (predefinito 3 minuti). Dettagli nel riferimento API.

Nota

I messaggi inviati via Cloud API compaiono nella Cronologia con l'indicazione cloud_api nella colonna Inviato tramite, così sai sempre da quale canale è partito ciascun invio. I loro stati di consegna arrivano al webhook di consegna della linea, come per ogni altro messaggio.

Capitolo 8

Chat

Rispondere alle conversazioni dei clienti dal pannello.

Pagina Chat con elenco contatti a sinistra
Fig. 8.1 — La pagina Chat.

A sinistra l'elenco delle conversazioni, a destra quella aperta. In alto scegli la Linea Attiva, cioè il numero da cui rispondi.

Gli strumenti della colonna di sinistra

  • Singola / Multi — mostra le conversazioni di una sola linea o di tutte insieme.
  • Filtra contatti e ricerca — per ritrovare una conversazione.
  • Tutti gli operatori — filtra per chi ha in carico la conversazione.
  • STANDARD / PRIORITÀ AI — cambia l'ordine dell'elenco.
  • Gestisci Tag — crea etichette colorate («VIP», «Da richiamare») e assegnale ai contatti.

Scrivere e allegare

Puoi inviare testo, immagini, documenti e messaggi vocali. WhatsApp riconosce la formattazione: *grassetto*, _corsivo_, ~barrato~.

Nota

Se un cliente non ti scrive da più di 24 ore, WhatsApp non permette più un messaggio libero: serve un template approvato. Vedi il capitolo 13.

Suggerimento

I segni di spunta accanto a un messaggio dicono a che punto è: inviato, consegnato, letto. Se resta senza spunte a lungo, controlla lo stato della linea nel capitolo 4.

Messaggi inviati tramite API

Anche i messaggi che il tuo sistema invia tramite API (api_send/message) compaiono nella conversazione: quelli inviati da una linea e i template Cloud API. Così, quando il cliente risponde, vedi a quale messaggio sta rispondendo. Le spunte si aggiornano come per ogni altro messaggio.

Nota

I messaggi di linea inviati tramite API prima del 7 ottobre 2026 sono solo nei Log (capitolo 15). Per un'immagine o un file inviati tramite API, la Chat mostra la didascalia, oppure [image] / [file] se non c'è.

Quando una linea è disconnessa

Una linea disconnessa resta nell'elenco Active Line, segnata in rosso come Disconnessa. Puoi comunque aprirla e leggere le sue conversazioni, comprese le risposte arrivate sulla Cloud API durante l'interruzione.

La scrittura su quella linea è disattivata finché non viene ricollegata (capitolo 5). In modalità Multi, scegli una linea connessa da cui rispondere. All'apertura, la Chat parte dalla prima linea connessa.

Capitolo 9

Broadcast — invio

Mandare lo stesso messaggio a un gruppo di contatti.

Scheda Invia Broadcast con pubblico, contenuto e consegna
Fig. 9.1 — La scheda Invia Broadcast.

Come si prepara un invio

  1. Pubblico Target — scegli il Gruppo di destinatari e la Linea WhatsApp da cui partire.
  2. Contenuto Messaggio — scrivi il testo. Il selettore in alto a destra sceglie il canale: MIGASENDER (la linea normale) oppure Meta Cloud API (template approvati).
  3. Allegato Multimediale — facoltativo: immagine, PDF, Excel, audio o video, fino a 26 MB, da URL o caricato.
  4. Impostazioni di Consegna — il ritardo fra un messaggio e l'altro. Lascia i valori predefiniti se non hai un motivo preciso per cambiarli.
  5. Avvia l'invio e seguine l'avanzamento nella Cronologia (capitolo 12).
Attenzione

La Protezione Anti-ban mostrata in cima alla pagina non è decorativa. WhatsApp blocca i numeri che inviano in blocco troppo in fretta, e un numero bloccato non si recupera dal pannello. Non azzerare il ritardo di invio.

Suggerimento

Prima di una campagna vera, crea un gruppo con due o tre tuoi numeri e fai una prova. Vedrai il messaggio esattamente come lo riceverà il cliente.

Capitolo 10

Broadcast — Rubrica

L'elenco dei contatti a cui puoi scrivere.

Scheda Rubrica con elenco contatti
Fig. 10.1 — La Rubrica.

Aggiungere un contatto

Finestra per aggiungere un contatto
Fig. 10.2 — La finestra di inserimento.
  1. Premi Aggiungi Contatto.
  2. Compila almeno il telefono, con il prefisso internazionale. Nome, email e note sono facoltativi.
  3. Salva.

Importare ed esportare

Con Importa CSV carichi molti contatti in una volta. Il file deve avere le colonne phone, name, email, notes. Prima di scrivere qualsiasi cosa, il pannello mostra un'anteprima con quante righe sono valide e quali sono duplicate.

Esporta CSV scarica la rubrica, utile come copia di sicurezza.

Nota

I numeri duplicati non vengono inseriti due volte: il pannello li segnala nell'anteprima e li salta.

Capitolo 11

Broadcast — Gruppi

Insiemi di contatti da usare come destinatari di una campagna.

Scheda Gruppi
Fig. 11.1 — I gruppi della rubrica.
Finestra di creazione di un nuovo gruppo
Fig. 11.2 — Creazione di un gruppo.
  1. Premi Nuovo Gruppo e dagli un nome, con una descrizione se ti è utile.
  2. Apri il gruppo e aggiungi i contatti dalla rubrica; puoi selezionarli in blocco.
  3. Il gruppo comparirà fra i destinatari nella scheda Invia Broadcast.
Nota

Eliminare un gruppo non elimina i contatti: restano in rubrica e negli altri gruppi.

Capitolo 12

Broadcast — Cronologia

Che fine ha fatto ogni campagna, contatto per contatto.

Cronologia delle campagne inviate
Fig. 12.1 — L'elenco delle campagne.
ColonnaSignificato
JobIl codice della campagna.
GruppoI destinatari.
Messaggio / TemplateIl testo inviato o il nome del template.
Inviato tramiteMigasender = linea normale; Cloud API = canale ufficiale Meta.
StatoIn attesa, in corso, completato, fallito o annullato.
AvanzamentoA che punto è l'invio.
Inviati / Falliti / SaltatiIl conteggio dei tre esiti possibili.

Il dettaglio contatto per contatto

Fai clic su una riga per aprirla: sotto compare l'esito di ogni singolo destinatario. Il dettaglio elenca Telefono, Nome, Stato, Errore e Inviato il. È il posto giusto per capire perché un cliente non ha ricevuto il messaggio.

Suggerimento

Una campagna interrotta può essere ripresa: usa Riprova. I contatti già raggiunti non vengono contattati di nuovo.

Capitolo 13

Template e Config WABA

I messaggi preapprovati da Meta e il collegamento all'account WhatsApp Business.

Elenco dei template con stato e categoria
Fig. 13.1 — L'elenco dei template.

Perché servono

WhatsApp non permette di scrivere per primi a un cliente con un testo libero. Serve un template, cioè un messaggio che Meta ha già letto e approvato. Vale anche quando sono passate più di 24 ore dall'ultimo messaggio del cliente.

Gli stati

StatoSignificato
APPROVEDApprovato: puoi usarlo.
PENDINGIn attesa della revisione di Meta.
REJECTEDRifiutato: correggi il testo e reinvialo.

Creare e sincronizzare

  • Crea Template — componi un nuovo messaggio, scegli lingua e categoria (UTILITY o MARKETING) e inviala a Meta per l'approvazione.
  • Sincronizza da Meta — rilegge da Meta l'elenco e gli stati aggiornati.
  • L'icona a forma di occhio apre l'anteprima del messaggio.

Le variabili

I segnaposto {{1}}, {{2}} vengono sostituiti al momento dell'invio. Un template come Ciao {{1}}, il tuo ordine {{2}} è stato spedito. diventa un messaggio diverso per ogni destinatario.

Config WABA

Scheda Config WABA con le credenziali Meta
Fig. 13.2 — La scheda Config WABA. Le credenziali sono nascoste in questa immagine.

La seconda scheda contiene le credenziali dell'account WhatsApp Business di Meta: WABA ID, identificativo del numero e token di accesso. Senza questi dati non funzionano né i template né il fallback del capitolo 7.

Importante

L'approvazione di un template da parte di Meta può richiedere da pochi minuti a qualche ora. Preparali prima della campagna, non il giorno stesso.

Capitolo 14

Roundbin

Distribuire gli invii su più linee, a turno.

Elenco dei gruppi Roundbin
Fig. 14.1 — I gruppi Roundbin.

Un gruppo Roundbin raccoglie più linee. Quando un messaggio viene inviato al gruppo, il pannello sceglie la linea successiva a rotazione: il carico si distribuisce invece di pesare tutto su un numero solo.

Creare un gruppo

  1. Premi Nuovo Gruppo e dagli un nome.
  2. Aggiungi le linee che devono farne parte.
  3. Se vuoi, indica un template di fallback, usato quando la rotazione deve passare al canale Meta.

Ogni riga dell'elenco mostra quante linee contiene il gruppo e l'eventuale template di riserva.

Suggerimento

Roundbin è particolarmente utile per gli invii che arrivano dalle API: distribuendo il traffico su più numeri, ciascuno resta sotto i propri limiti orari.

Capitolo 15

Log

Il registro di ogni messaggio entrato e uscito.

Pagina Log con riepiloghi mensili e tabella di dettaglio
Fig. 15.1 — La pagina Log.

I riepiloghi del mese

  • Messaggi Totali — quanti ne hai usati sul totale del piano.
  • Inviati con Successo — quelli andati a buon fine.
  • Falliti — quelli non recapitati.
  • Inviati via API — quanti sono partiti da sistemi esterni collegati.

Il Log di debug

La tabella elenca ogni messaggio con ID Log, ID Linea, nome e cognome del contatto, cellulare, un'anteprima del messaggio, la data e ora di invio e lo stato di consegna, espresso in percentuale o come Errore.

La barra sopra la tabella consente di cercare per numero, filtrare per intervallo di date, passare fra vista tabella e vista schede, ricaricare ed esportare.

Suggerimento

Quando un cliente dice «non ho ricevuto niente», cerca qui il suo numero: vedrai se il messaggio è partito, quando, e con quale esito.

Capitolo 16

Statistiche

Quanto arriva, quanto viene letto e quanto consumano voce e AI.

Pagina Statistiche con i riquadri dei messaggi e i tassi di consegna
Fig. 16.1 — La scheda Messaggi.

Messaggi

RiquadroSignificato
InviatiMessaggi partiti dal pannello.
ConsegnatiArrivati sul telefono del destinatario.
LettiAperti dal destinatario.
RicevutiMessaggi che i clienti hanno mandato a te.
Inviati come templatePassati automaticamente a un template Meta approvato.
Non riuscitiNon recapitati.

Sotto i riquadri, il Tasso di consegna e il Tasso di lettura riassumono l'andamento in percentuale.

Utilizzo Voce e AI

Scheda Utilizzo Voce e AI con il consumo di trascrizione e sintesi vocale
Fig. 16.2 — La scheda Utilizzo Voce e AI.

La seconda scheda riguarda le funzioni vocali ed è divisa in due metà con la stessa struttura.

  • Text To Speech (TTS) — le risposte che l'assistente ha trasformato in messaggio vocale.
  • Speech To Text (STT) — il contrario: i vocali dei clienti trasformati in testo.

Ogni metà mostra gli stessi cinque valori — Total Conversions, Total Characters, Avg. Chars / Day, Total Cost e Avg. Cost / Day — poi un grafico che confronta il periodo attuale con quello precedente e infine il registro di ogni singola operazione: numero, tipo di gateway, servizio, messaggio, costo, numero di caratteri, dimensione ed eventuale errore. Il registro si può cercare, ricaricare ed esportare.

I filtri

In alto scegli il periodo — per esempio Ultimi 30 giorni — oppure un intervallo personalizzato, e il servizio da includere. Premi Filtra statistiche per applicare. La fascia sopra i controlli indica sempre l'intervallo attualmente in uso.

Nota

Consegna e lettura dipendono da WhatsApp: se il destinatario ha disattivato le conferme di lettura, il messaggio risulterà consegnato ma non letto anche se lo ha visto.

Capitolo 17

Impostazioni

Sette pannelli per credenziali, avvisi, webhook e accesso API.

Pagina Impostazioni con i sette pannelli richiudibili
Fig. 17.1 — I sette pannelli delle Impostazioni.

Configurazione OpenAI

Pannello di configurazione OpenAI
Fig. 17.2 — Credenziali e impostazioni vocali.

Qui inserisci la chiave del servizio AI, scegli il modello e imposti la voce usata per la sintesi vocale. Puoi scegliere fra OpenAI ed ElevenLabs come motore vocale.

Impostazioni di configurazione generale

Pannello delle impostazioni generali
Fig. 17.3 — Avvisi, segnalazioni e comportamento dei link.

Impostazioni prefissi nazionali

Pannello dei prefissi nazionali ammessi
Fig. 17.4 — Limitare le conversazioni ai mercati in cui operi.

Consente di accettare messaggi solo da determinati prefissi internazionali: un filtro efficace contro il traffico indesiderato.

Impostazioni webhook

Pannello di configurazione del webhook
Fig. 17.5 — Un unico URL valido per Master e Slave.

Il webhook è l'indirizzo che Migasender chiama quando succede qualcosa — un messaggio in arrivo, un cambio di stato. È il modo di collegare il pannello ad altri sistemi.

Impostazioni Metadati Webhook

Pannello dei metadati webhook
Fig. 17.6 — Dettagli utente inclusi nelle chiamate.

Impostazioni API

Pannello delle impostazioni API con i due interruttori
Fig. 17.7 — Quali API esporre e i relativi token.
  • API cronologia chat — consente a servizi esterni di leggere le conversazioni archiviate.
  • API invio messaggi — consente l'invio programmato da sistemi esterni.

Accanto a ogni interruttore, le due icone permettono di rigenerare e copiare il token.

Attenzione

Un token di accesso vale quanto una password. Non inserirlo in email, chat o documenti condivisi. Se sospetti che sia stato visto da qualcun altro, rigeneralo subito: quello vecchio smette immediatamente di funzionare.

Token Iframe Accesso Automatico

Pannello del token per l'accesso automatico via iframe
Fig. 17.8 — Accesso automatico da una pagina esterna.

Serve quando il pannello viene incorporato in un altro sito: il token passato nell'indirizzo autentica l'utente senza chiedergli di accedere di nuovo.

Abbonamenti e fatture

Per controllare abbonamenti e fatture degli acquisti effettuati su MigaMATCH, apri la tua area acquisti. Inserisci l’indirizzo email usato per acquistare: riceverai un PIN via email per accedere.

Apri abbonamenti e fatture