# Integração da API do WhatsApp

> Integração passo a passo do WhatsApp Business API via BroadNet — inscrição integrada, envio de modelo, envio e webhooks para mensagens recebidas. Todas as categorias de mensagem.

- URL canônico: https://www.broadnet.me/pt/developers/whatsapp
- Idioma: pt
- Última atualização: 2026-10-21
- Editor: BroadNet (https://www.broadnet.me)

Integração completa da API do WhatsApp Business através do BroadNet: registo integrado, envio de modelos e envio de mensagens. Os envios são feitos via POST /whatsapp/message/sendbulk com messageType TEXT, IMAGE, VIDEO, AUDIO, DOCUMENT, STICKER, LOCATION, CONTACTS, TEMPLATE, INTERACTIVE, REACTION ou FLOW. A resposta contém um ID de lote e o status por destinatário (SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED) é enviado para o seu webhook e pode ser visualizado em /whatsapp/message/bulk-insights.

> **Comece com o registo integrado** O fluxo de inscrição integrado do BroadNet gere a criação da conta WhatsApp Business, a verificação do número de telefone e a aprovação do nome de exibição num único modal alojado. A maioria das equipas passa de zero ao primeiro envio de modelo em menos de um dia.

## Exemplos

### 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 oficial TypeScript · npm install @broadnet/cpaas-sdk axios