WhatsApp Business API con Twilio: come iniziare passo passo • Meteora Web Agency

Hai un negozio di abbigliamento con 2.000 clienti WhatsApp raccolti in tre anni. Ogni settimana mandi una foto dello sconto del weekend, ma il tuo telefono viene bloccato per spam dopo venti messaggi. Oppure hai una catena di ristoranti e devi comunicare gli orari delle feste a cento fornitori, ma finisci a copia-incolla da un gruppo che nessuno legge più. È lo stesso problema: WhatsApp personale non è fatto per le aziende che mandano messaggi in blocco. La soluzione si chiama WhatsApp Business API, e noi di Meteora Web la usiamo da anni per clienti reali, con costi trasparenti e niente account vietnamiti.

In questa guida ti spieghiamo come iniziare con Twilio, il provider di API che abbiamo scelto per la sua flessibilità e documentazione solida. Nessuna teoria astratta: passaggi concreti, codice che funziona, esempi di costi veri. Se arrivi qua pensando “ma tanto uso un bot pirata”, fermati: i numeri parlano chiaro, e la piattaforma ufficiale ti dà deliverability e scalabilità. Veniamo dalla contabilità, lo sappiamo bene: un messaggio non arrivato è un cliente perso.

Perché Twilio per WhatsApp Business API rispetto ad altri provider?

Twilio non è l’unico gateway per WhatsApp Business API — ci sono MessageBird, Vonage (ex Nexmo), WATI, WATI e altri. Ma noi lo usiamo da anni e ti spieghiamo perché conviene. Primo: prezzi trasparenti, nessun canone mensile obbligatorio, paghi solo ciò che usi. Secondo: flessibilità — puoi integrarlo in qualsiasi linguaggio (Python, PHP, Node.js, Laravel) e gestire template, webhook, media. Terzo: nulla da inventare — Twilio ha la connettività diretta con Meta (WhatsApp), non è un rivenditore di terze parti. Quarto: supporto tecnico reale, non un ticket da 72 ore.

C’è un altro fattore che in pochi considerano: Twilio ti permette di possedere il tuo stack. Niente piattaforme chiuse che ti tengono i dati in ostaggio. Noi abbiamo costruito una piattaforma proprietaria proprio su Twilio per gestire campagne multi-cliente. Se un domani cambi provider, i tuoi template e numeri telefonici restano tuoi. Con altri servizi “chiavi in mano”, spesso perdi tutto.

Confronto veloce: Twilio vs servizi all-in-one

I servizi tipo WATI o WATI offrono interfacce drag-and-drop, ma costano 30–100 €/mese per account più un extra per messaggio. Con Twilio paghi in base al volume: 0,005–0,008 $ per messaggio a seconda del paese. Per 2.000 messaggi/mese, sono circa 10–16 $, contro 30+ € di un abbonamento. E se devi personalizzare, Twilio ti dà API pure. Noi abbiamo clienti che gestiscono 50.000 messaggi/mese: la differenza è sostanziale.

Attenzione: Twilio non ha interfaccia grafica per inviare messaggi uno a uno. Dovrai scrivere il codice o usare un gestionale che lo integra. Se non hai un developer, considera un partner come noi. Ma se hai almeno un minimo di dimestichezza con API REST, vai avanti.

Come ottenere i prerequisiti: account WhatsApp Business e numero telefonico

Prima di iniziare, devi avere:

Un account WhatsApp Business (scaricare l’app e registrare il tuo numero aziendale, non serve l’API ancora).
Un account Twilio (gratuito, senza carta di credito per iniziare, ma per l’API serve un metodo di pagamento).
Un numero di telefono che non sia già registrato su WhatsApp personale. Puoi acquistarlo direttamente da Twilio (costo ~1 $/mese) o usarne uno tuo verificato.
Il Facebook Business Manager (WABA) approvato da Meta. Twilio ti guida nella procedura.

Passaggi pratici per configurare il sandbox

1. Accedi a Twilio Console → Messaging → Try it out → Send a WhatsApp message. 2. Twilio ti fornirà un sandbox (un numero WhatsApp di test). Invita un telefono a iscriversi mandando un codice. 3. Una volta che il telefono di test è iscritto, puoi inviare e ricevere messaggi via Twilio. È tutto gratuito in sandbox, ma i messaggi inviati a utenti non iscritti non vengono recapitati. Per produzione serve approvazione del template.

Noi abbiamo risolto un problema comune: il sandbox muore dopo 72 ore di inattività. Per evitarlo, programma un webhook che tenga vivo l’account. Ma per iniziare, non serve.

Quali template sono obbligatori e come approvarli su Meta?

WhatsApp Business API impone che tutti i messaggi iniziali verso un utente non abbiano una conversazione aperta devono usare un template pre-approvato. Dopo che l’utente risponde, puoi mandare messaggi liberi entro 24 ore (finestra di customer care). Per marketing (invio massivo) devi sempre usare template approvati, anche se l’utente ha già interagito.

Come creare e inviare un template con Twilio

Accedi a Twilio Console → Messaging → WhatsApp → Message Templates. Clicca Create Template. Scegli la categoria (marketing, utility, authentication, service). Compila: nome, lingua, corpo del messaggio (puoi usare variabili come {{1}}, {{2}}). Esempio per un promemoria appuntamento: “Ciao {{1}}, ti ricordiamo l’appuntamento del {{2}}. Clicca qui per confermare: {{3}}”.

Una volta creato, invialo per l’approvazione a Meta. I tempi vanno da poche ore a 48 ore. Noi abbiamo visto un cliente ritardare tre settimane per un template mal scritto. Regola base: niente promesse, niente parole in MAIUSCOLO, niente link non pertinenti. Usa un tono informativo. Se vuoi accelerare, crea un template “service” per notifiche di pagamento o “authentication” per OTP.


# Inviare un template con Twilio API (curl)
curl -X POST 'https://api.twilio.com/2010-04-01/Accounts/{{ACCOUNT_SID}}/Messages.json' \
  -u '{{ACCOUNT_SID}}:{{AUTH_TOKEN}}' \
  -d 'From=whatsapp:+14155238886' \
  -d 'To=whatsapp:+393121234567' \
  -d 'ContentSid=HXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
  -d 'ContentVariables={"1":"Mario Rossi","2":"15/06/2026","3":"https://example.com/conferma"}'

Nota: ContentSid è l’ID del template approvato, lo trovi in Twilio Console. ContentVariables è un JSON con i placeholder.

Come gestire i costi e il budget senza sorprese

Twilio ti fa pagare solo i messaggi inviati. I costi variano per destinazione e volume. Per l’Italia (prezzi indicativi): messaggio outbound ~0,005 $, inbound (ricevuto) ~0,001 $, image/media extra. Con 10.000 messaggi al mese, siamo su 50–70 $. Niente canoni fissi. Noi abbiamo clienti che spendono 150 $/mese e ne fatturano 3.000 € grazie a campagne mirate.

Ma attenzione ai costi nascosti: se compri un numero telefonico da Twilio, paghi ~1 $/mese. Se usi un numero tuo, devi verificarlo (chiamata o SMS). Inoltre, ogni template non approvato che provi a inviare viene comunque addebitato. Il consiglio: testa nel sandbox, poi attiva la produzione con pochi messaggi.

Abbiamo visto un cliente accumulare 200 $ in un’ora dopo un errore in un loop. Imposta un limite di spesa nella Twilio Console: Account → Billing → Alerts. Mettilo a 20 $ e riceverai un alert. Se superi, ferma il codice.

Strumento di controllo: webhook di stato

Twilio invia callback sullo status di ogni messaggio (queued, sent, delivered, failed, read). Puoi usarli per tenere traccia del budget in tempo reale. Noi li abbiamo integrati in un sistema di fatturazione automatica per un cliente: ogni messaggio consegnato generava una riga nel suo ERP.


// Esempio di webhook in Node.js per ricevere lo status
const express = require('express');
const app = express();
app.use(express.urlencoded({ extended: true }));

app.post('/whatsapp-status', (req, res) => {
  const { MessageSid, MessageStatus, To, ErrorCode } = req.body;
  console.log(`Messaggio ${MessageSid} status: ${MessageStatus}`);
  if (ErrorCode) console.error(`Errore: ${ErrorCode}`);
  res.sendStatus(200);
});
app.listen(3000);

Deploy su un server con HTTPS (Twilio richiede endpoint sicuro). Se non hai HTTPS, usa ngrok per test locale.

Quali pratiche seguire per la deliverability e per non finire bloccati?

Meta ha regole severe: niente spam, niente messaggi non richiesti, opt-in obbligatorio. Se violi, il tuo numero viene bannato. Noi abbiamo gestito il recupero per un cliente: tre giorni di lavoro. Meglio prevenire.

Opt-in esplicito: il cliente deve autorizzare la ricezione, meglio via modulo, checkbox o doppio opt-in via SMS/WhatsApp stesso.
Gestisci opt-out: se un utente risponde “stop”, Twilio ti invia un webhook e devi smettere di inviargli messaggi. Implementa la cancellazione automatica su database.
Non inviare troppo spesso: massimo 2-3 messaggi a settimana per cliente, mai più di uno al giorno.
Usa template di qualità: evita “VINCITORE” o “ULTIMA CHANCE”. Meta li blocca prima ancora di inviarli.
Media ottimizzati: come nell’e-commerce, immagini pesanti compromettono la consegna. Comprimi immagini a 80-100 KB.

Come integrare Twilio con un CRM o un gestionale esistente?

La maggior parte delle PMI italiane usa strumenti come Salesforce, HubSpot, Zoho, o anche un gestionale fatto su misura. Twilio offre SDK in PHP, Python, Node.js – puoi creare un piccolo modulo che legge i contatti dal tuo database e invia messaggi via API. Noi, per esempio, abbiamo integrato Twilio con un modulo Laravel di un cliente che gestiva appuntamenti: quando un appuntamento veniva fissato, partiva automaticamente un messaggio di conferma e un reminder.


// Usando il Twilio PHP SDK
use Twilio\Rest\Client;

$sid = $_ENV['TWILIO_ACCOUNT_SID'];
$token = $_ENV['TWILIO_AUTH_TOKEN'];
$twilio = new Client($sid, $token);

$message = $twilio->messages
  ->create("whatsapp:+393331234567", // to
    [
      "from" => "whatsapp:+14155238886",
      "contentSid" => "HXtemplate_id",
      "contentVariables" => json_encode([
        "1" => "Mario",
        "2" => "Domani alle 15:00"
      ])
    ]
  );

echo $message->sid;

Nota: usa variabili d’ambiente per le credenziali, mai hardcode. Noi abbiamo visto codice con token in chiaro su GitHub. Una vulnerabilità che costa migliaia di euro.

Cosa fare adesso

1. Crea un account Twilio e attiva il sandbox WhatsApp. Manda un messaggio di test al tuo telefono. 2. Prepara un template di marketing semplice (es. “Ciao {{1}}, siamo {{2}}. Questa settimana offriamo sconto {{3}} per te.”). Invialo per l’approvazione. 3. Imposta un alert di budget a 20 € nella console Twilio. 4. Scrivi un piccolo script (PHP, Node, Python) che legge 5 numeri da un array e invia il template. Testa sul sandbox. 5. Una volta che il template è approvato, passa alla produzione (Twilio ti guiderà nel collegamento con Facebook Business Manager).

Se non hai tempo o competenze interne, noi di Meteora Web possiamo realizzarti l’integrazione completa: dal setup dell’account Twilio fino all’automazione con il tuo gestionale. Lavoriamo con aziende in tutta Italia, comprese piccole imprese del Sud che meritano tecnologia di serie A. Approfondisci la nostra soluzione per l’invio massivo WhatsApp.

Risorse utili:

Provalo con Zenith

Zenith ZenApp è la piattaforma all-in-one per gestire la tua attività — clienti, agenda, scadenze, fatturazione e promemoria WhatsApp, tutto da browser. Senza installare nulla.

Scopri Zenith ZenApp →