Skip to main content

API di WhatsApp Business

Collega il tuo numero WhatsApp a BeeCastly per chattare con i clienti, lasciare che l'AI risponda per te e inviare broadcast. Puoi collegarti scansionando un codice QR oppure tramite la WhatsApp Cloud API ufficiale di Meta.

Prerequisiti

Un account BeeCastly (va bene anche il piano gratuito)
Un account Meta Business (business.facebook.com)
Per il metodo Cloud API: un account Meta Business (business.facebook.com) e un numero di telefono da registrare presso Meta

Due modi per collegarti

Scansiona un codice QR

Collega il numero che usi già, incluso un numero dell'app WhatsApp Business, proprio come WhatsApp Web. È gratis e non richiede l'approvazione di Meta. Ideale per risposte e risposte automatiche. Non usarlo per broadcast di massa: WhatsApp potrebbe bannare il numero.

WhatsApp Cloud API (Meta)

Il metodo ufficiale di Meta. Richiede un account Meta Business e modelli di messaggio approvati. È il metodo da usare per broadcast e campagne.

Guida alla configurazione

1Collega WhatsApp in BeeCastly

Vai su Integrazioni → Canali → WhatsApp.
Codice QR: scegli WhatsApp QR. Sul telefono, apri WhatsApp → Dispositivi collegati → Collega un dispositivo e scansiona il codice. Il telefono continua a funzionare normalmente.
Cloud API: scegli WhatsApp Cloud API (Meta) e clicca su Connetti con Facebook. Scegli il tuo account Meta Business e il numero di telefono. Se preferisci fare tutto a mano, la Procedura guidata passo passo ti chiede il tuo Meta App ID, il WhatsApp Business Account ID, il Phone Number ID e il token di accesso.

2Crea i modelli di messaggio

Con la Cloud API puoi inviare testo libero solo entro 24 ore dall'ultimo messaggio del cliente. Fuori da questa finestra ti serve un modello approvato da Meta.
Vai su Campagne → Modelli e crea un modello.
Scegli una categoria: Marketing, Utility o Autenticazione.
Aggiungi variabili come {{1}} e {{2}} per nomi e altri dettagli.
Invialo. Meta lo esamina e lo stato si aggiorna in BeeCastly.

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

I messaggi WhatsApp in arrivo finiscono in Messaggi → WhatsApp (e in Tutti i messaggi).
Rispondi dall'inbox, usa le Risposte rapide per le risposte che invii spesso e assegna le chat ai membri del team.
Attiva le risposte AI per lasciare che il tuo chatbot risponda alle domande più comuni dalla tua Knowledge Base e passa a una persona quando serve.

5Altri strumenti WhatsApp

Messaggi → Status Studio: pubblica stati WhatsApp.
Messaggi → Link wa.me: crea un link click-to-chat o un codice QR per il tuo sito e i tuoi poster.
Integrazioni → Canali → WhatsApp: modifica il tuo profilo aziendale e il catalogo prodotti (Cloud API).

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 un consenso chiaro prima di inviare messaggi di marketing, ad esempio con un modulo, una chat sul sito web o di persona.

Usa la risposta automatica AI con criterio

Le risposte AI funzionano meglio quando la tua Knowledge Base contiene prezzi, orari e condizioni. Lascia sempre ai clienti un modo per raggiungere una persona.

Importante: la finestra di 24 ore (Cloud API)

Con la WhatsApp Cloud API puoi inviare testo libero solo entro 24 ore dall'ultimo messaggio del cliente. Fuori da questa finestra devi usare un modello approvato.

API Examples

Send a WhatsApp message from your own software with an API key. See the Messages API for details.

bash
curl -X POST https://beecastly.com/api/v1/messages/send \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"WHATSAPP","to":"+919876543210","content":"Hello from BeeCastly!"}'
javascript·send-message.js
const response = await fetch('https://beecastly.com/api/v1/messages/send', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    channel: 'WHATSAPP',
    to: '+919876543210',
    content: 'Hello from BeeCastly!',
  }),
});

const data = await response.json(); // { success: true, data: { messageId, status: "queued" } }

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

QR method: check that your phone is online and still shows BeeCastly under Linked devices. Cloud API: check that the customer has opted in and that your number's status is healthy in Meta Business Manager.

Rate limits

Meta limits how many people a new Cloud API number can message per day, and the limit grows as you send good-quality messages. Start with small broadcasts and schedule larger ones in Campaigns → Broadcasts.

Frequently Asked Questions

Can I use my WhatsApp Business App number?
Yes. With the QR method you link the number you already use, the same way WhatsApp Web works, and you keep using the app on your phone. For the Cloud API, you connect a number through Meta's sign-up steps.
Do I need Meta approval?
Not for the QR method. The Cloud API needs a Meta Business account, and Meta must approve your message templates before you can use them.
Which method should I use for broadcasts?
The Cloud API. Sending bulk messages over the QR method can get your number banned by WhatsApp, so use QR for replies and auto-replies to people who message you.
WhatsApp Guide - BeeCastly Documentation | BeeCastly