# Integrazione con l'API di WhatsApp

> Integrazione passo dopo passo di WhatsApp Business API tramite BroadNet — registrazione integrata, invio del modello, spedizione e webhook per l'inbound. Ogni categoria di messaggio.

- URL canonico: https://www.broadnet.me/it/developers/whatsapp
- Lingua: it
- Ultimo aggiornamento: 2026-10-21
- Editore: BroadNet (https://www.broadnet.me)

Integrazione completa API WhatsApp Business tramite BroadNet: registrazione integrata, invio di modelli e invio dei messaggi. Gli invii avvengono tramite POST /whatsapp/message/sendbulk con messageType TEXT, IMAGE, VIDEO, AUDIO, DOCUMENT, STICKER, LOCATION, CONTACTS, TEMPLATE, INTERACTIVE, REACTION o FLOW. La risposta contiene un ID batch e lo stato per ciascun destinatario (SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED) viene inviato al tuo webhook ed è consultabile all'indirizzo /whatsapp/message/bulk-insights.

> **Inizia con la registrazione integrata** Il flusso di registrazione integrato di BroadNet gestisce la creazione dell'account WhatsApp Business, la verifica del numero di telefono e l'approvazione del nome visualizzato in un'unica finestra modale ospitata. La maggior parte dei team passa da zero all'invio del primo modello in meno di un giorno.

## Esempi

### template send

```bash
curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-updates \
  -F destinationNo=447700900123 \
  -F messageType=TEMPLATE \
  -F templateName=order_update \
  -F templateLanguage=en_US \
  -F bodyTemplateVariables=INV-400
```

### whatsapp.ts

```typescript
import { Configuration, WhatsAppWhatsAppMessagingAPIApi } from "@broadnet/cpaas-sdk";

const wa = new WhatsAppWhatsAppMessagingAPIApi(
  new Configuration({
    basePath: "https://api.broadnet.me",
    accessToken: process.env.BROADNET_TOKEN!,
  }),
);

const res = await wa.whatsappMessageSendbulkPost({
  campaignName: "order-updates",
  messageType: "TEXT",
  destinationNo: "447700900123",
  content: "Your order has shipped.",
});

console.log(res.data); // batchId + per-file acceptance counts
```

SDK ufficiale TypeScript · npm install @broadnet/cpaas-sdk axios
