Skip to main content

API di WhatsApp Business

Collegati all'API ufficiale Meta WhatsApp Business per inviare campagne personalizzate, automatizzare le conversazioni e gestire il coinvolgimento dei clienti su larga scala.

Prerequisiti

Un account BeeCastly (va bene anche il piano gratuito)
Un account Meta Business (business.facebook.com)
Un numero di telefono aziendale verificato (non già in uso su WhatsApp)
Verifica dell'attività completata in Meta Business Manager

Guida alla configurazione

1Collega WhatsApp in BeeCastly

Vai su Impostazioni → Integrazioni → WhatsApp nel tuo pannello di controllo BeeCastly.
Fai clic su "Collega WhatsApp Business API". Verrai reindirizzato al flusso di registrazione integrato di Meta.
Segui le istruzioni per selezionare il tuo account Meta Business e il numero di telefono.
Una volta effettuato il collegamento, l'ID dell'account WhatsApp Business, l'ID del numero di telefono e il token di accesso vengono configurati automaticamente.

2Crea i modelli di messaggio

WhatsApp richiede modelli pre-approvati per i messaggi in uscita (non puoi inviare messaggi liberi al di fuori della finestra di 24 ore).
Vai su Campagne → Modelli e fai clic su "Crea modello".
Scegli una categoria: Marketing, Utilità o Autenticazione.
Scrivi il tuo modello con variabili come {{1}}, {{2}} per la personalizzazione.
Invialo alla revisione di Meta. L'approvazione richiede in genere da 1 a 24 ore.

3Invia una campagna di invio massivo

Vai su Campagne → Invii massivi → Crea.
Seleziona WhatsApp come canale.
Scegli il modello approvato e il pubblico (contatti, tag o segmenti).
Associa le variabili del modello ai campi del contatto (nome, telefono, campi personalizzati).
Guarda l'anteprima del messaggio, poi fai clic su Invia ora o Programma.

4Gestisci le conversazioni

Tutti i messaggi WhatsApp in arrivo compaiono in Messaggi → WhatsApp.
Rispondi ai clienti direttamente dalla posta in arrivo: entro la finestra di 24 ore puoi inviare messaggi liberi.
Attiva la Risposta automatica AI per lasciare che il tuo bot AI gestisca automaticamente le richieste più comuni.
Assegna le conversazioni ai membri del team per la gestione manuale.

Buone pratiche

Mantieni un'alta valutazione di qualità

Mantieni ALTA la valutazione di qualità dei tuoi messaggi evitando lo spam. Se gli utenti ti bloccano o segnalano i tuoi messaggi, Meta potrebbe ridurre i tuoi limiti di invio.

Ottieni il consenso esplicito

Ottieni sempre un consenso esplicito prima di inviare messaggi di marketing. Usa moduli, widget sul sito web o raccolta del consenso di persona.

Usa la risposta automatica AI con criterio

La risposta automatica AI funziona al meglio quando hai addestrato il bot con articoli pertinenti della base di conoscenza. Offri sempre ai clienti un modo per parlare con un operatore umano.

Importante: finestra di messaggistica di 24 ore

L'API WhatsApp Business prevede una finestra di messaggistica di 24 ore. Puoi inviare messaggi liberi solo entro 24 ore dall'ultimo messaggio del cliente. Al di fuori di questa finestra devi usare modelli approvati.

API Examples

Use the BeeCastly REST API to send WhatsApp messages programmatically.

bash
curl -X POST https://api.beecastly.com/api/whatsapp/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+1234567890",
    "message": "Hello from BeeCastly!"
  }
javascript·send-message.js
const response = await fetch('https://api.beecastly.com/api/whatsapp/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    phone: '+1234567890',
    message: 'Hello from BeeCastly!',
  }),
});

const data = await response.json();
console.log(data);

Troubleshooting

Template not approved

If your template is rejected by Meta, check that it follows WhatsApp's guidelines: no promotional content in utility templates, proper formatting, and clear call-to-action buttons.

Messages not delivering

Ensure the recipient has opted in to receive messages. Check your WhatsApp Business Account health status in the Meta Business Manager.

Rate limits

WhatsApp Cloud API has rate limits. Start with small batches and scale gradually. Use the BeeCastly campaign scheduler to manage sending rates.

Frequently Asked Questions

How long does Meta verification take?
Meta Business verification typically takes 2-5 business days. Ensure your business documents are clear and match your Business Manager details.
Can I use my personal WhatsApp number?
No, you need a dedicated WhatsApp Business API number. This cannot be a personal WhatsApp or WhatsApp Business App number.
What is the cost per message?
WhatsApp charges per conversation (24-hour window), not per message. The first message in a conversation is charged; all subsequent messages within 24 hours are free.