Skip to content

Crear una sesión de signup embebible

POST /api/embed/sessions

Devuelve 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.

FieldTypeDescription
allowed_originsstring[]requiredOrí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"].
platformswhatsapp · instagram · facebook[]optionalCanales ofrecidos dentro del iframe. Default: ["whatsapp"].
external_refstringoptionalId 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_minutesnumberoptionalMinutos de validez de la sesión. Default: 30.
prefillobjectoptionalDatos 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]"}}.
StatusDescriptionSchema
201
Terminal window
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"
]
}'