From d197b6635d8c97c42e77ef4eea4910b4bf34bf9f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mat=C3=ADas=20L=C3=B3pez?= <mlopez@videsk.io>
Date: Wed, 15 Apr 2026 21:50:28 -0400
Subject: [PATCH 1/8] docs(extensions): add extensions overview page

---
 apps/extensiones/README.md | 47 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 apps/extensiones/README.md

diff --git a/apps/extensiones/README.md b/apps/extensiones/README.md
new file mode 100644
index 0000000..fd01a74
--- /dev/null
+++ b/apps/extensiones/README.md
@@ -0,0 +1,47 @@
+---
+description: >-
+  Las extensiones permiten embeber aplicaciones externas (iframe o web
+  components) dentro de los productos de Videsk, configurables por segmento.
+---
+
+# Extensiones
+
+Las extensiones son aplicaciones embebidas que se renderizan dentro de la Consola de Videsk. Pueden ser de dos tipos:
+
+| Tipo | Descripcion | Aislamiento |
+| --- | --- | --- |
+| **iframe** | Carga una URL externa en un iframe con sandbox | Completo (proceso separado) |
+| **web-component** | Carga un modulo JS que define un Custom Element | Parcial (mismo contexto) |
+
+## Caracteristicas
+
+- **Configurables por segmento**: cada extension puede estar disponible solo para ciertos segmentos, o para todos (si no se especifica ninguno).
+- **Placement flexible**: pueden renderizarse en el panel de llamada (`call-panel`), la barra lateral (`sidebar`) o como pagina independiente (`standalone`).
+- **Permisos controlados**: los iframes reciben atributos `sandbox` y `allow` validados contra una lista blanca del backend.
+- **Contexto de host**: la extension recibe datos del contexto actual (usuario, segmento, llamada, contacto) segun los scopes configurados.
+
+## Tipos de extension
+
+### Iframe
+
+Ideal para aplicaciones que necesitan aislamiento completo. La pagina embebida corre en un proceso separado del navegador, con permisos controlados por `sandbox` y `allow`.
+
+{% content-ref url="iframe.md" %}
+[iframe.md](iframe.md)
+{% endcontent-ref %}
+
+### Web Component
+
+Ideal para integraciones ligeras que necesitan acceso directo al DOM del host. El modulo JS registra un Custom Element que se monta directamente en la consola.
+
+{% content-ref url="web-components.md" %}
+[web-components.md](web-components.md)
+{% endcontent-ref %}
+
+## Protocolo de comunicacion
+
+Ambos tipos de extension se comunican con el host mediante un protocolo basado en `postMessage` (iframes) o `CustomEvent` (web components).
+
+{% content-ref url="postmessage.md" %}
+[postmessage.md](postmessage.md)
+{% endcontent-ref %}

From 0260a17419b4ad80cf2f371f24a8ee7ff441acc1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mat=C3=ADas=20L=C3=B3pez?= <mlopez@videsk.io>
Date: Wed, 15 Apr 2026 21:51:25 -0400
Subject: [PATCH 2/8] docs(extensions): add iframe extensions spec

---
 apps/extensiones/iframe.md | 135 +++++++++++++++++++++++++++++++++++++
 1 file changed, 135 insertions(+)
 create mode 100644 apps/extensiones/iframe.md

diff --git a/apps/extensiones/iframe.md b/apps/extensiones/iframe.md
new file mode 100644
index 0000000..eafc863
--- /dev/null
+++ b/apps/extensiones/iframe.md
@@ -0,0 +1,135 @@
+---
+description: >-
+  Como configurar extensiones de tipo iframe en la Consola de Videsk,
+  incluyendo permisos, sandbox y requisitos de seguridad.
+---
+
+# Iframe
+
+Las extensiones de tipo `iframe` cargan una pagina web externa dentro de un iframe aislado. Es el mecanismo recomendado para la mayoria de integraciones.
+
+## Requisitos
+
+### HTTPS obligatorio
+
+La URL de la extension **debe** servirse sobre `https://`. Contenido HTTP sera bloqueado por el navegador.
+
+### Content-Security-Policy
+
+Tu aplicacion debe permitir ser embebida por los dominios de Videsk:
+
+```
+Content-Security-Policy: frame-ancestors 'self' https://*.videsk.io;
+```
+
+Si tu app usa `X-Frame-Options`, eliminalo a favor de CSP.
+
+### Cookies
+
+Si la app embebida requiere sesion con cookies:
+
+```
+Set-Cookie: session=xxx; SameSite=None; Secure; HttpOnly
+```
+
+Si usa `localStorage` o `sessionStorage`, no es necesario.
+
+## Esquema de configuracion
+
+Al crear una extension via `POST /extensions`:
+
+```json
+{
+  "name": "Mi App",
+  "kind": "iframe",
+  "placement": "call-panel",
+  "segments": ["635c843f35f1254a417612d9"],
+  "iframe": {
+    "url": "https://app.example.com/embed",
+    "allow": ["camera", "microphone", "clipboard-write"],
+    "sandbox": ["allow-scripts", "allow-same-origin", "allow-forms"],
+    "width": "100%",
+    "height": "500px"
+  },
+  "contextScopes": ["user", "segment", "call"]
+}
+```
+
+### Campos de `iframe`
+
+| Campo | Tipo | Requerido | Descripcion |
+| --- | --- | --- | --- |
+| `url` | String | Si | URL HTTPS de la pagina a embeber |
+| `allow` | String[] | No | Permisos del atributo `allow` del iframe |
+| `sandbox` | String[] | No | Valores del atributo `sandbox` del iframe |
+| `width` | String | No | Ancho CSS (default: `100%`) |
+| `height` | String | No | Alto CSS (default: `100%`) |
+
+## Permisos `allow`
+
+Valores aceptados por el backend (otros seran rechazados):
+
+| Valor | Descripcion |
+| --- | --- |
+| `camera` | Acceso a la camara |
+| `microphone` | Acceso al microfono |
+| `display-capture` | Captura de pantalla |
+| `clipboard-write` | Escritura en clipboard |
+| `clipboard-read` | Lectura de clipboard |
+| `autoplay` | Reproduccion automatica de audio/video |
+| `fullscreen` | Modo pantalla completa |
+| `geolocation` | Acceso a ubicacion |
+| `picture-in-picture` | Modo picture-in-picture |
+
+**Valores por defecto** (si no se especifican):
+
+```
+camera; microphone; display-capture; clipboard-write; autoplay
+```
+
+## Permisos `sandbox`
+
+Valores aceptados:
+
+| Valor | Descripcion |
+| --- | --- |
+| `allow-scripts` | Ejecucion de JavaScript |
+| `allow-same-origin` | Acceso a recursos del mismo origen |
+| `allow-forms` | Envio de formularios |
+| `allow-popups` | `window.open()` y links `target="_blank"` |
+| `allow-popups-to-escape-sandbox` | Popups sin restricciones de sandbox |
+| `allow-downloads` | Descargas de archivos |
+| `allow-modals` | `alert()`, `confirm()`, `prompt()` |
+
+**Valores por defecto:**
+
+```
+allow-scripts allow-same-origin allow-forms allow-popups allow-popups-to-escape-sandbox allow-downloads
+```
+
+{% hint style="warning" %}
+Valores como `allow-top-navigation` no son aceptados por seguridad, ya que permitirian a la extension navegar la ventana principal.
+{% endhint %}
+
+## HTML renderizado
+
+El iframe resultante en la consola sera similar a:
+
+```html
+<iframe
+  src="https://app.example.com/embed"
+  allow="camera; microphone; display-capture; clipboard-write; autoplay"
+  sandbox="allow-scripts allow-same-origin allow-forms allow-popups allow-popups-to-escape-sandbox allow-downloads"
+  referrerpolicy="no-referrer"
+  loading="lazy"
+/>
+```
+
+## Segmentos
+
+El campo `segments` controla en que segmentos aparece la extension:
+
+- `[]` (vacio) = disponible en **todos** los segmentos de la cuenta
+- `["id1", "id2"]` = solo disponible en esos segmentos
+
+Esto permite que distintos equipos tengan extensiones diferentes segun su funcion.

From 08fc286d70401ed8daa5973c73a77a5335865b45 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mat=C3=ADas=20L=C3=B3pez?= <mlopez@videsk.io>
Date: Wed, 15 Apr 2026 21:51:49 -0400
Subject: [PATCH 3/8] docs(extensions): add web-components spec

---
 apps/extensiones/web-components.md | 97 ++++++++++++++++++++++++++++++
 1 file changed, 97 insertions(+)
 create mode 100644 apps/extensiones/web-components.md

diff --git a/apps/extensiones/web-components.md b/apps/extensiones/web-components.md
new file mode 100644
index 0000000..b653463
--- /dev/null
+++ b/apps/extensiones/web-components.md
@@ -0,0 +1,97 @@
+---
+description: >-
+  Como crear extensiones de tipo web component para la Consola de Videsk.
+---
+
+# Web Components
+
+Las extensiones de tipo `web-component` cargan un modulo JavaScript que registra un Custom Element. El elemento se monta directamente en el DOM de la consola.
+
+{% hint style="warning" %}
+A diferencia de los iframes, los web components **comparten el contexto de ejecucion** con la consola. Esto implica mayor responsabilidad sobre la seguridad y estabilidad del codigo.
+{% endhint %}
+
+## Requisitos
+
+1. El script debe servirse sobre **HTTPS**.
+2. El script debe ser un **modulo ES** (`type="module"`).
+3. Debe registrar un Custom Element con `customElements.define()`.
+4. El `tagName` debe contener al menos un guion (ej. `my-app`, `acme-widget`).
+
+## Esquema de configuracion
+
+```json
+{
+  "name": "Mi Componente",
+  "kind": "web-component",
+  "placement": "call-panel",
+  "segments": [],
+  "webComponent": {
+    "scriptUrl": "https://cdn.example.com/my-app.js",
+    "tagName": "my-app",
+    "integrity": "sha384-abc123..."
+  },
+  "contextScopes": ["user", "segment"]
+}
+```
+
+### Campos de `webComponent`
+
+| Campo | Tipo | Requerido | Descripcion |
+| --- | --- | --- | --- |
+| `scriptUrl` | String | Si | URL HTTPS del modulo JS |
+| `tagName` | String | Si | Nombre del custom element (debe contener `-`) |
+| `integrity` | String | No | Hash SRI para verificar integridad del script |
+
+## Ciclo de vida
+
+1. La consola crea un `<script type="module" src="...">` para cargar el bundle.
+2. Espera a que `customElements.whenDefined(tagName)` resuelva.
+3. Monta el elemento: `<my-app data-extension-id="..."></my-app>`.
+4. Setea las propiedades de contexto como JS properties en el elemento.
+5. Despacha un `CustomEvent('videsk:init', { detail: context })`.
+
+## Contrato del Custom Element
+
+El componente debe aceptar:
+
+### Propiedades (JS)
+
+El host intentara setear las propiedades de contexto directamente:
+
+```js
+element.user = { id: '...', email: '...' };
+element.segment = { _id: '...', name: '...' };
+element.call = { id: '...' };
+```
+
+Si la property no existe, se pasa como atributo HTML (JSON stringified).
+
+### Evento `videsk:init`
+
+```js
+element.addEventListener('videsk:init', (event) => {
+  const { user, segment, call } = event.detail;
+  // Inicializar con el contexto del host
+});
+```
+
+## Ejemplo minimo
+
+```js
+class MyApp extends HTMLElement {
+  connectedCallback() {
+    this.innerHTML = '<p>Cargando...</p>';
+    this.addEventListener('videsk:init', (e) => {
+      const { user, segment } = e.detail;
+      this.innerHTML = `<p>Hola ${user.email} en ${segment.name}</p>`;
+    });
+  }
+}
+
+customElements.define('my-app', MyApp);
+```
+
+{% hint style="info" %}
+El script se carga una sola vez aunque haya multiples extensiones con la misma `scriptUrl`. El cache es por URL.
+{% endhint %}

From d11e1c62b4b59edf5210b9f6b0a4939292dc1835 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mat=C3=ADas=20L=C3=B3pez?= <mlopez@videsk.io>
Date: Wed, 15 Apr 2026 21:52:15 -0400
Subject: [PATCH 4/8] docs(extensions): add postMessage protocol spec

---
 apps/extensiones/postmessage.md | 124 ++++++++++++++++++++++++++++++++
 1 file changed, 124 insertions(+)
 create mode 100644 apps/extensiones/postmessage.md

diff --git a/apps/extensiones/postmessage.md b/apps/extensiones/postmessage.md
new file mode 100644
index 0000000..fc0a660
--- /dev/null
+++ b/apps/extensiones/postmessage.md
@@ -0,0 +1,124 @@
+---
+description: >-
+  Protocolo de comunicacion entre el host (Consola Videsk) y las extensiones
+  embebidas via iframe o web component.
+---
+
+# Protocolo postMessage
+
+Las extensiones se comunican con la consola mediante un protocolo tipado. Para iframes se usa `window.postMessage`; para web components se usa `CustomEvent`.
+
+## Handshake
+
+Al cargar una extension, el host envia un mensaje de inicializacion:
+
+### Host -> Extension
+
+```json
+{
+  "type": "videsk:init",
+  "context": {
+    "user": { "id": "abc123", "email": "agent@company.com" },
+    "segment": { "_id": "seg456", "name": "Ventas" },
+    "call": { "id": "call789" }
+  }
+}
+```
+
+Los campos presentes en `context` dependen de los `contextScopes` configurados en la extension.
+
+### Extension -> Host
+
+La extension puede confirmar que esta lista:
+
+```json
+{
+  "type": "videsk:ready"
+}
+```
+
+Si la extension envia `videsk:ready` antes de recibir el init, el host reenviara el `videsk:init`.
+
+## Mensajes de la extension al host
+
+### `videsk:resize`
+
+Solicita un cambio de altura del contenedor:
+
+```json
+{
+  "type": "videsk:resize",
+  "height": 450
+}
+```
+
+`height` debe ser un numero (pixeles).
+
+### `videsk:emit`
+
+Envia un evento personalizado al host, que se reenvia al backend via socket:
+
+```json
+{
+  "type": "videsk:emit",
+  "event": "form:submitted",
+  "payload": { "formId": "abc", "status": "success" }
+}
+```
+
+En el backend, esto llega como `extension:message` por socket:
+
+```json
+{
+  "extensionId": "ext_id",
+  "event": "form:submitted",
+  "payload": { "formId": "abc", "status": "success" }
+}
+```
+
+## Seguridad
+
+### Iframes
+
+- El host **valida `event.origin`** contra la URL registrada de la extension. Mensajes de otros origenes son ignorados.
+- Solo se procesan mensajes cuyo `type` empiece con `videsk:`.
+- El iframe corre con `sandbox` y `allow` controlados por el backend.
+- Se usa `referrerpolicy="no-referrer"` para no filtrar datos del host.
+
+### Web Components
+
+- Los eventos usan `bubbles: false` para no propagarse al DOM del host.
+- El script se carga con `crossOrigin="anonymous"`.
+- Opcionalmente se puede verificar integridad con SRI (`integrity`).
+
+## Ejemplo: iframe escuchando el init
+
+```html
+<script>
+window.addEventListener('message', (event) => {
+  if (event.data && event.data.type === 'videsk:init') {
+    const { user, segment, call } = event.data.context;
+    document.getElementById('agent').textContent = user.email;
+    // Confirmar que estamos listos
+    event.source.postMessage({ type: 'videsk:ready' }, event.origin);
+  }
+});
+</script>
+```
+
+## Ejemplo: iframe solicitando resize
+
+```html
+<script>
+function notifyResize() {
+  const height = document.body.scrollHeight;
+  window.parent.postMessage({
+    type: 'videsk:resize',
+    height: height,
+  }, 'https://console.videsk.io');
+}
+
+window.addEventListener('load', notifyResize);
+new ResizeObserver(notifyResize).observe(document.body);
+</script>
+```

From f9ea6f9052a30ef7054cfb2be0b3c76af772beef Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mat=C3=ADas=20L=C3=B3pez?= <mlopez@videsk.io>
Date: Wed, 15 Apr 2026 21:53:10 -0400
Subject: [PATCH 5/8] docs(extensions): add extensions section to SUMMARY.md

---
 SUMMARY.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/SUMMARY.md b/SUMMARY.md
index 87a43d2..50ce7c0 100644
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -179,6 +179,10 @@
 * [Integraciones](apps/integraciones/README.md)
   * [Iframes](apps/integraciones/iframes.md)
   * [Power Apps](apps/integraciones/power-apps.md)
+* [Extensiones](apps/extensiones/README.md)
+  * [Iframe](apps/extensiones/iframe.md)
+  * [Web Components](apps/extensiones/web-components.md)
+  * [Protocolo postMessage](apps/extensiones/postmessage.md)
 
 ## VPaaS
 

From feb050a31855f0111cecce2efff82116ea4bfa2b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mat=C3=ADas=20L=C3=B3pez?= <mlopez@videsk.io>
Date: Wed, 15 Apr 2026 22:36:02 -0400
Subject: [PATCH 6/8] docs(extensions): update iframe docs for entity-centric
 scoping

---
 apps/extensiones/iframe.md | 30 ++++++++++++++++++++++++------
 1 file changed, 24 insertions(+), 6 deletions(-)

diff --git a/apps/extensiones/iframe.md b/apps/extensiones/iframe.md
index eafc863..6d45557 100644
--- a/apps/extensiones/iframe.md
+++ b/apps/extensiones/iframe.md
@@ -43,7 +43,6 @@ Al crear una extension via `POST /extensions`:
   "name": "Mi App",
   "kind": "iframe",
   "placement": "call-panel",
-  "segments": ["635c843f35f1254a417612d9"],
   "iframe": {
     "url": "https://app.example.com/embed",
     "allow": ["camera", "microphone", "clipboard-write"],
@@ -55,6 +54,18 @@ Al crear una extension via `POST /extensions`:
 }
 ```
 
+Luego, asocia la extension al segmento o servicio (calendario) que corresponda:
+
+```
+PATCH /segments/:id
+{ "extensions": ["<extension_id>"] }
+```
+
+```
+PATCH /services/:id
+{ "extensions": ["<extension_id>"] }
+```
+
 ### Campos de `iframe`
 
 | Campo | Tipo | Requerido | Descripcion |
@@ -125,11 +136,18 @@ El iframe resultante en la consola sera similar a:
 />
 ```
 
-## Segmentos
+## Asociacion por entidad
+
+Las extensiones se asocian a **segmentos** y/o **servicios** (calendarios) desde la propia entidad:
 
-El campo `segments` controla en que segmentos aparece la extension:
+```
+PATCH /segments/:segmentId
+{ "extensions": ["ext_id_1", "ext_id_2"] }
+```
 
-- `[]` (vacio) = disponible en **todos** los segmentos de la cuenta
-- `["id1", "id2"]` = solo disponible en esos segmentos
+```
+PATCH /services/:serviceId
+{ "extensions": ["ext_id_1"] }
+```
 
-Esto permite que distintos equipos tengan extensiones diferentes segun su funcion.
+Una misma extension puede estar asociada a multiples segmentos y servicios. Cada entidad controla que extensiones tiene habilitadas, lo que permite configuraciones flexibles por equipo o tipo de calendario.

From eff1db2c47f9404adf01d4865b68d17086da27c5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mat=C3=ADas=20L=C3=B3pez?= <mlopez@videsk.io>
Date: Wed, 15 Apr 2026 22:36:22 -0400
Subject: [PATCH 7/8] docs(extensions): update overview for entity-centric
 association

---
 apps/extensiones/README.md | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/apps/extensiones/README.md b/apps/extensiones/README.md
index fd01a74..cc886ad 100644
--- a/apps/extensiones/README.md
+++ b/apps/extensiones/README.md
@@ -1,7 +1,8 @@
 ---
 description: >-
   Las extensiones permiten embeber aplicaciones externas (iframe o web
-  components) dentro de los productos de Videsk, configurables por segmento.
+  components) dentro de los productos de Videsk, configurables por segmento
+  y servicio (calendario).
 ---
 
 # Extensiones
@@ -15,11 +16,16 @@ Las extensiones son aplicaciones embebidas que se renderizan dentro de la Consol
 
 ## Caracteristicas
 
-- **Configurables por segmento**: cada extension puede estar disponible solo para ciertos segmentos, o para todos (si no se especifica ninguno).
+- **Asociables por entidad**: cada extension se asocia desde el segmento o servicio (calendario) que la necesita, mediante su campo `extensions[]`. Esto permite configuraciones flexibles por equipo o tipo de calendario.
 - **Placement flexible**: pueden renderizarse en el panel de llamada (`call-panel`), la barra lateral (`sidebar`) o como pagina independiente (`standalone`).
 - **Permisos controlados**: los iframes reciben atributos `sandbox` y `allow` validados contra una lista blanca del backend.
 - **Contexto de host**: la extension recibe datos del contexto actual (usuario, segmento, llamada, contacto) segun los scopes configurados.
 
+## Flujo de configuracion
+
+1. Crear la extension via `POST /extensions` (define que es: nombre, tipo, URL, permisos).
+2. Asociar la extension al segmento o servicio via `PATCH /segments/:id` o `PATCH /services/:id` agregando el ID al campo `extensions[]`.
+
 ## Tipos de extension
 
 ### Iframe

From e0781cb46f45c091d1342bd7eaa3b6200fe37ab4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mat=C3=ADas=20L=C3=B3pez?= <mlopez@videsk.io>
Date: Thu, 16 Apr 2026 15:37:37 -0400
Subject: [PATCH 8/8] docs(extensions): document URL templating with handlebars

---
 apps/extensiones/iframe.md | 62 +++++++++++++++++++++++++++++++++++---
 1 file changed, 58 insertions(+), 4 deletions(-)

diff --git a/apps/extensiones/iframe.md b/apps/extensiones/iframe.md
index 6d45557..b292b66 100644
--- a/apps/extensiones/iframe.md
+++ b/apps/extensiones/iframe.md
@@ -1,7 +1,8 @@
 ---
 description: >-
   Como configurar extensiones de tipo iframe en la Consola de Videsk,
-  incluyendo permisos, sandbox y requisitos de seguridad.
+  incluyendo permisos, sandbox, templating dinamico de URL y requisitos de
+  seguridad.
 ---
 
 # Iframe
@@ -44,7 +45,7 @@ Al crear una extension via `POST /extensions`:
   "kind": "iframe",
   "placement": "call-panel",
   "iframe": {
-    "url": "https://app.example.com/embed",
+    "url": "https://app.example.com/embed?call={{encode call.id}}&agent={{encode user.email}}",
     "allow": ["camera", "microphone", "clipboard-write"],
     "sandbox": ["allow-scripts", "allow-same-origin", "allow-forms"],
     "width": "100%",
@@ -70,12 +71,65 @@ PATCH /services/:id
 
 | Campo | Tipo | Requerido | Descripcion |
 | --- | --- | --- | --- |
-| `url` | String | Si | URL HTTPS de la pagina a embeber |
+| `url` | String | Si | URL HTTPS, admite templating handlebars |
 | `allow` | String[] | No | Permisos del atributo `allow` del iframe |
 | `sandbox` | String[] | No | Valores del atributo `sandbox` del iframe |
 | `width` | String | No | Ancho CSS (default: `100%`) |
 | `height` | String | No | Alto CSS (default: `100%`) |
 
+## Templating dinamico de URL
+
+El campo `iframe.url` admite expresiones [handlebars](https://handlebarsjs.com/) que se resuelven en la Consola justo antes de montar el iframe, usando el contexto de la llamada activa.
+
+### Variables disponibles
+
+| Variable | Descripcion |
+| --- | --- |
+| `user.id` | ID del agente que contesta |
+| `user.email` | Email del agente |
+| `user.firstname`, `user.lastname` | Nombre del agente |
+| `segment._id`, `segment.name` | Segmento de la llamada |
+| `call.id` | ID de la llamada |
+| `account` | ID de la cuenta |
+| `extraData.*` | Datos extra del cliente (IP, browser, location, etc.) |
+| `form` | Valores del formulario base (completado por el cliente) |
+| `agentForm` | Valores del formulario del agente |
+| `tags` | Tags asociados a la llamada |
+
+### Helpers
+
+Se registran automaticamente todos los helpers del paquete `@videsk/handlebars-helpers` (los mismos que usan los webhooks: `#if`, `#each`, `#date`, `#phone`, `#jwt`, etc.).
+
+Adicionalmente, para templating de URL:
+
+| Helper | Descripcion |
+| --- | --- |
+| `{{encode valor}}` | URL-encode del valor (alias: `{{urlEncode valor}}`) |
+
+{% hint style="warning" %}
+La URL se compila con `noEscape: true` (sin HTML-escaping) porque no es HTML. Usa siempre `{{encode ...}}` en valores que puedan contener caracteres reservados en URLs (`&`, `=`, `?`, `/`, espacios, etc.).
+{% endhint %}
+
+### Ejemplos
+
+```
+https://app.ejemplo.com/embed?
+  call={{encode call.id}}
+  &agent={{encode user.email}}
+  &segmento={{encode segment.name}}
+  &ip={{encode extraData.ip}}
+```
+
+```
+https://crm.ejemplo.com/contactos/{{encode call.id}}?rut={{encode form.rut}}
+```
+
+### Cuando se resuelve
+
+La URL se resuelve **una sola vez** al momento de montar el iframe (inicio de la llamada o al habilitarse la extension). No se recompila cuando cambian valores reactivos (por ejemplo, mientras el agente llena el `agentForm`).
+
+Si necesitas enviar datos a la app embebida en tiempo real durante la llamada, usa el protocolo `postMessage`.
+
 ## Permisos `allow`
 
 Valores aceptados por el backend (otros seran rechazados):
@@ -128,7 +182,7 @@ El iframe resultante en la consola sera similar a:
 
 ```html
 <iframe
-  src="https://app.example.com/embed"
+  src="https://app.example.com/embed?call=68123abc&agent=matias%40videsk.io"
   allow="camera; microphone; display-capture; clipboard-write; autoplay"
   sandbox="allow-scripts allow-same-origin allow-forms allow-popups allow-popups-to-escape-sandbox allow-downloads"
   referrerpolicy="no-referrer"