Enviar campañas

Un broadcast envía una plantilla aprobada de WhatsApp a N destinatarios, cada uno con sus propios valores de variables. La división del trabajo es estricta: tu app provee la audiencia (tu CRM es la fuente de verdad), y el modal de Auphere deja al cliente elegir plantilla, previsualizarla con valores reales y enviar. El widget nunca inventa destinatarios.

React

AuphereBroadcastButton se renderiza solo cuando el WhatsApp de ese cliente está conectado, y abre el modal al hacer click:

import { AuphereBroadcastButton } from "@auphere/embed/react";

<AuphereBroadcastButton
  auphere={auphere}
  recipients={[
    { phone: "+56912345678", variables: { cliente: "Ana", saldo_pendiente: "$12.000" } },
    { phone: "+56987654321", variables: { cliente: "Luis", saldo_pendiente: "$8.000" } },
  ]}
  className="your-button-class"
  onDone={({ broadcastId, accepted }) => console.log(broadcastId, accepted)}
>
  Campañas WhatsApp
</AuphereBroadcastButton>

JavaScript vanilla

Sin React, controla tu propio botón con la API de estado y llama openBroadcast directamente:

await auphere.openBroadcast({
  recipients: [
    { phone: "+56912345678", variables: { cliente: "Ana", saldo_pendiente: "$12.000" } },
  ],
  onDone: ({ broadcastId, accepted }) => { /* accepted = recipients queued */ },
  onExit: () => { /* modal closed */ },
});

Destinatarios y variables

phonestringRequerido

Formato E.164, p. ej. +56912345678. Se toleran espacios y guiones.

variablesRecord<string, string>

Valores para los parámetros nombrados de la plantilla — las claves deben coincidir con los nombres de parámetro de la plantilla aprobada (p. ej. { cliente: "Ana" } para un placeholder {{cliente}}). El mapeo de tu esquema a esos nombres lo haces en tu backend.

Plantillas

Cada cliente envía desde su propia cuenta de WhatsApp Business, así que las plantillas las aprueba Meta por cliente. El modal solo ofrece plantillas ya aprobadas. Hoy el set inicial de plantillas se crea con asistencia del equipo de Auphere justo después de que el cliente conecta; la provisión automática de plantillas por partner está en el roadmap.

Reglas de entrega

• Los opt-outs se respetan. Los destinatarios que se dieron de baja se excluyen antes del envío — no necesitas filtrarlos tú (aunque puedes).
• Las plantillas funcionan fuera de la ventana de 24 horas. Para eso existen; los mensajes libres no forman parte de los broadcasts.
• Tope de audiencia. Cada envío tiene un tope (250 destinatarios por defecto, configurable por partner). Audiencias mayores reciben 413 — trocea el envío o pídenos subir tu tope.
• Atribución. onDone devuelve el broadcastId y cuántos destinatarios fueron aceptados; el uso por cliente queda registrado para reporting y facturación.