# Integración de la API de WhatsApp

> Integración paso a paso de WhatsApp Business API a través de BroadNet: registro integrado, envío de plantillas, envío y webhooks para mensajes entrantes. Todas las categorías de mensajes.

- URL canónica: https://www.broadnet.me/es/developers/whatsapp
- Idioma: es
- Última actualización: 2026-10-21
- Editor: BroadNet (https://www.broadnet.me)

Integración completa de la API WhatsApp Business a través de BroadNet: registro integrado, envío de plantillas y envío. Los envíos se realizan mediante POST /whatsapp/message/sendbulk con messageType TEXT, IMAGE, VIDEO, AUDIO, DOCUMENT, STICKER, LOCATION, CONTACTS, TEMPLATE, INTERACTIVE, REACTION o FLOW. La respuesta contiene un ID de lote y el estado por destinatario (SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED) se envía a su webhook y se puede leer en /whatsapp/message/bulk-insights.

> **Comience con el registro integrado** El flujo de registro integrado de BroadNet gestiona la creación de la cuenta de WhatsApp Business, la verificación del número de teléfono y la aprobación del nombre de usuario en una única ventana modal alojada. La mayoría de los equipos pasan de cero al primer envío de plantilla en menos de un día.

## Ejemplos

### 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
