Documentazione

Guida a Wamia

Tutto quello che serve per usare Wamia ogni giorno: dal primo accesso alle chat, dai modelli di messaggio ai promemoria degli appuntamenti, fino alle API per chi sviluppa.

Cos'è Wamia

Wamia è il pannello con cui un'azienda gestisce i propri numeri WhatsApp insieme al team: legge e risponde ai clienti, invia modelli di messaggio approvati da Meta, tiene la rubrica, fissa appuntamenti e manda i promemoria, e collega i propri sistemi tramite API.

Per aziende

Ogni azienda vede solo i propri numeri, contatti e messaggi.

Due tipi di numero

Numeri business della Cloud API di Meta e numeri personali collegati con il telefono.

Integrabile

API REST e webhook firmati per piattaforme e gestionali esterni.

Primi passi

  1. Entra in Wamia

    L'utente lo crea l'amministratore della tua azienda, oppure ricevi un invito via email e completi la registrazione (anche con Google o Facebook, solo a partire dall'invito). Poi entri da /login. Se hai dimenticato la password usa Password dimenticata.

  2. Completa il profilo

    Da Impostazioni → Profilo puoi collegare Google o Facebook per entrare con un clic, e collegare i servizi Google (contatti, calendario, attività) che userai in Wamia.

  3. Scegli il numero attivo

    In alto, nella barra, scegli su quale numero lavorare. Chat, modelli e log mostrano i dati di quel numero; se apri Wamia in più schede, il cambio vale per tutte.

Numeri WhatsApp

Numero business (Cloud API)

  • Si collega con «Continua con Facebook»: scegli il tuo account WhatsApp Business e il numero, Wamia registra il numero e si iscrive ai messaggi in arrivo.
  • Fuori dalla finestra di 24 ore puoi scrivere solo con un modello approvato.
  • Ideale per il customer service, i promemoria e i messaggi che partono dai tuoi sistemi con le API. I modelli si inviano a un destinatario alla volta: Wamia non fa campagne massive.

Numero personale

  • Si collega inquadrando un codice QR con WhatsApp sul telefono, come per WhatsApp Web.
  • Ricevi anche messaggi scritti dal telefono, modifiche, eliminazioni, reazioni e vocali.
  • WhatsApp consente al massimo 4 dispositivi collegati per numero.

Lo stesso numero può essere collegato da aziende diverse, non due volte nella stessa azienda. Il superamministratore può affidare un numero a un'altra azienda, che lo usa come se fosse suo.

Chat

La pagina Chat riunisce le conversazioni del numero attivo, con i non letti in evidenza.

  • Scrivere: testo con la formattazione di WhatsApp (*grassetto*, _corsivo_, ~barrato~), emoji, allegati (immagini, video, documenti) e risposte a un messaggio.
  • Finestra di 24 ore: su un numero business, se il cliente non ti scrive da più di 24 ore, il campo di testo lascia il posto a «Invia un template»: è l'unica cosa che Meta consente.
  • Storico: i messaggi più vecchi si caricano scorrendo verso l'alto.
  • Numero non in rubrica: puoi scrivere a un numero nuovo e salvarlo come contatto dalla chat.
  • Stati: una spunta inviato, due consegnato, due blu letto; un errore di invio mostra il motivo.

Modelli di messaggio

I modelli (template) sono messaggi approvati da Meta che puoi mandare anche a finestra chiusa. La pagina Template ha due schede.

Gestisci

  • Crea da un modello pronto o da zero, con categoria e lingua.
  • Intestazione con testo, immagine, video o PDF; corpo con variabili {{1}}; pulsanti.
  • Modifica secondo le regole di Meta, copia in un'altra lingua (con traduzione suggerita da rivedere), elimina una lingua sola.
  • Lo stato di approvazione si aggiorna da Meta.

Invia

  • Mostra solo i modelli approvati, con nome e lingua.
  • Le variabili sono obbligatorie: Wamia non invia un modello incompleto.
  • Se Meta rifiuta l'invio, l'errore è spiegato in italiano con cosa fare.

Un modello appena creato resta in revisione finché Meta non lo approva: di solito pochi minuti, a volte qualche ora.

Rubrica

  • Contatti dell'azienda con nome e numero; da un contatto apri subito la chat.
  • Sincronizza da Google: importa i contatti con un numero di telefono dai tuoi Contatti Google, con un'anteprima prima di salvare. I contatti già presenti con lo stesso numero non vengono toccati.
  • Nuovo contatto: puoi salvarlo anche nei tuoi Contatti Google.

Agenda, attività e promemoria

Con Google collegato dal profilo, la pagina Agenda mostra il tuo Google Calendar e le tue attività.

  • Appuntamenti: crea e modifica eventi, con link Google Meet e descrizione formattata.
  • Allegati: aggiungi a un evento file scelti dal tuo Google Drive.
  • Contatti dell'evento: lega fino a 10 contatti della rubrica a un appuntamento.
  • Promemoria: con «Manda promemoria» il contatto riceve un messaggio WhatsApp (con un modello, se la finestra è chiusa) oppure un'email inviata dal tuo Gmail agli invitati. Puoi vedere l'anteprima prima di inviare. Il promemoria automatico parte al più una volta per appuntamento.
  • Attività: le Google Tasks, da creare e completare senza uscire da Wamia.

Log dei messaggi

La pagina Log elenca i messaggi inviati e ricevuti dal numero attivo, con stato, data e l'eventuale errore restituito da Meta. È il primo posto da guardare quando un cliente dice di non aver ricevuto un messaggio.

Ruoli e aziende

RuoloCosa può fare
UtenteLavora sui numeri che gli sono assegnati: chat, modelli, rubrica, agenda.
AmministratoreGestisce la propria azienda: utenti, inviti, numeri e a chi sono assegnati. Non vede le altre aziende.
SuperamministratoreGestisce l'intera installazione: tutte le aziende, le piattaforme esterne e i loro token, l'affidamento dei numeri.

Ognuno può concedere o togliere ruoli solo fino al proprio livello.

API e webhook

Per chi integra Wamia in un gestionale o in una piattaforma.

  • Autenticazione: un token per piattaforma, emesso dal superamministratore, oppure il token di un utente.
  • Invio: messaggi di testo, media e modelli dai numeri dell'azienda.
  • Webhook: Wamia inoltra i messaggi in arrivo con una busta stabile (eventId, occurredAt, account) firmata HMAC-SHA256, da verificare prima di fidarsi del contenuto.
Apri l'API ReferenceEndpoint, esempi e prova dal browser

Privacy e sicurezza

Domande frequenti

Perché non posso scrivere liberamente a un cliente?

Sui numeri business Meta consente messaggi liberi solo entro 24 ore dall'ultimo messaggio del cliente. Dopo, serve un modello approvato: dalla chat usa «Invia un template».

Posso creare i modelli da Wamia?

Sì, dalla scheda Gestisci della pagina Template. Il modello va in revisione da Meta e, una volta approvato, compare nella scheda Invia e nella chat.

Il numero personale si è scollegato: cosa faccio?

Succede quando WhatsApp sul telefono scollega il dispositivo, ad esempio dopo molti giorni senza connessione. Dalle impostazioni del numero mostra di nuovo il codice QR e inquadralo con il telefono.

Come scollego Google o Facebook?

Da Impostazioni → Profilo. Scollegando Google Wamia revoca l'accesso e cancella il collegamento; puoi anche revocarlo da myaccount.google.com/permissions.

Come richiedo una prova o assistenza?

Scrivi a info@codebase.it o chiama il +39 0934 1935790.