Conectar WhatsApp

Cada cliente tuyo envía desde su propio número de WhatsApp Business, no desde uno compartido. Vincular ese número es el único paso de todo el flujo que necesita a un humano: alguien con acceso al Meta Business del cliente tiene que autorizarlo.

Qué necesita el cliente

• Acceso a su cuenta de Meta Business (el dueño, o quien la administre).
• Un número de teléfono para WhatsApp Business — nuevo, o migrable a la Cloud API.

Lanzar el flujo

Llama connectWhatsApp() desde tu página de ajustes u onboarding. Abre el Embedded Signup oficial de Meta dentro del iframe de Auphere — el login de Meta ocurre bajo nuestro origen y nuestra configuración de app de Meta, nunca en tu bundle.

await auphere.connectWhatsApp({
  onConnected: ({ displayPhoneNumber }) => {
    // e.g. "+58 424-1234567" — refresh your UI here
  },
  onExit: () => {
    // modal closed (connected or not)
  },
});

Qué pasa tras la autorización

1. Auphere registra el número y se suscribe a su webhook — los mensajes empiezan a fluir por el agente del cliente.
2. Las credenciales se guardan cifradas de nuestro lado. A tu frontend no vuelve nada más que el número visible.
3. Si tu blueprint tiene auto-activación (el default), el cliente pasa a activo y su agente empieza a responder de inmediato.
4. El botón de campañas queda disponible para ese cliente.

Seguir el estado de conexión

El SDK guarda el último estado conocido y expone una pequeña API de suscripción. Del lado del servidor, la respuesta de POST /v1/widget-sessions también incluye whatsapp.status, así puedes decidir server-side si renderizar la UI de campañas.

auphere.getStatus();          // "connected" | "not_connected" | "unknown"
await auphere.refreshStatus(); // re-mints a session and refreshes

const unsubscribe = auphere.onStatusChange((status) => {
  // fires on every flip, e.g. right after a successful signup
});