Crear una sesión de signup embebible
POST /api/embed/sessionsDevuelve una URL de un solo uso para embeber en un iframe. El token en claro se muestra una única vez. Al conectar el canal, Neike avisa por webhook (channel.connected) y el resultado queda disponible en GET de la sesión.
Request body
Section titled “Request body”| Field | Type | Description | |
|---|---|---|---|
allowed_origins | string[] | required | Orígenes autorizados a embeber el iframe. Alimentan el frame-ancestors del CSP y el targetOrigin del postMessage de resultado. Example: ["https://app.tu-dominio.com"]. |
platforms | whatsapp · instagram · facebook[] | optional | Canales ofrecidos dentro del iframe. Default: ["whatsapp"]. |
external_ref | string | optional | Id del negocio en el sistema del cliente. Vuelve tal cual en el webhook y en el resultado, para correlacionar el canal con su tenant. Example: "tenant_8842". |
ttl_minutes | number | optional | Minutos de validez de la sesión. Default: 30. |
prefill | object | optional | Datos del negocio que ya conoce el cliente; precargan el formulario de Meta (business.name, business.email, business.website, phone.displayName, phone.category). Example: {"business":{"name":"Café Central","email":"[email protected]"}}. |
Responses
Section titled “Responses”| Status | Description | Schema |
|---|---|---|
201 | — | — |
Example
Section titled “Example”curl -X POST https://api.neike.dev/api/embed/sessions \ -H "x-neike-api-key: whk_live_…" \ -H "Content-Type: application/json" \ -d '{ "allowed_origins": [ "https://app.tu-dominio.com" ] }'