Auphere Embed · Primeros pasos
/ v0.1
Introducción
Auphere Embed permite a tu plataforma SaaS ofrecer agentes de WhatsApp y campañas de plantillas a tus propios clientes — sin manejar credenciales de WhatsApp ni reconstruir infraestructura de mensajería.
Auphere Embed es un SDK de JavaScript (@auphere/embed) que instalas en tu aplicación web. Añade dos capacidades para cada uno de tus clientes, directamente dentro de tu producto:
- Conectar WhatsApp — un flujo self-serve donde tu cliente vincula su propio número de WhatsApp Business a su agente de Auphere, con Meta Embedded Signup.
- Campañas (broadcasts) — un modal donde tu cliente envía plantillas aprobadas de WhatsApp con variables dinámicas a una lista de destinatarios que tú provees.
Modelo mental
Cada concepto de tu plataforma corresponde a un concepto en Auphere. Nunca manejas internos de Auphere — siempre hablas en términos de tus propios identificadores.
| En tu plataforma | En Auphere |
|---|---|
| Tu plataforma (el partner) | Una cuenta de partner con una API key secreta (ak_live_…) |
| Un cliente / negocio de tu producto | Un workspace aislado, referenciado solo por tu id (external_client_ref) |
| El WhatsApp del cliente | Un canal de WhatsApp Business Cloud API propio de ese cliente |
| El agente de IA del cliente | Un agente clonado de tu blueprint de partner al provisionar |
| Recordatorios / avisos masivos | Un broadcast de plantilla a N destinatarios |
Cómo funciona
El SDK es un loader fino. No renderiza nada por sí mismo más allá de un overlay de iframe a pantalla completa servido desde embed.auphere.com — el mismo patrón que usan Stripe Connect y Plaid Link. Eso te da tres garantías:
- Cero credenciales en tu bundle. Tu página solo maneja un token de sesión de 15 minutos limitado a un único cliente. Las credenciales de WhatsApp y de Auphere nunca salen de nuestro origen.
- Actualizaciones sin redeploy. La UI del modal vive en nuestro origen: publicamos mejoras y fixes sin que toques tu
package.json. - Aislamiento por construcción. Cada cliente es un workspace aislado. El workspace se elige del lado del servidor al emitir el token — un navegador nunca puede apuntar una sesión a los datos de otro.
La integración tiene exactamente dos piezas de tu lado: un endpoint en tu backend que intercambia tu API key secreta por tokens de sesión efímeros, y el SDK en tu frontend que monta el widget con esos tokens.
Siguientes pasos
- Sigue el Quickstart — de la API key a un botón de campañas funcionando.
- Aprende a provisionar clientes cuando se dan de alta en tu producto.
- Lee el modelo de seguridad antes de salir a producción.