Cómo usar el componente “SIP header” de wolkvox Studio
Written by Jhon Bairon Figueroa
Updated at September 29th, 2026
Table of Contents
Introducción
El componente SIP header de wolkvox Studio permite incorporar información adicional dentro de la señalización SIP de una llamada. Se encuentra en el grupo de componentes Avanzados y está disponible únicamente para routing points de tipo Voice Flow.
Este componente puede utilizarse para transportar información de aplicación mediante el encabezado SIP User-to-User, conocido también como UUI (User-to-User Information). La UUI permite enviar un pequeño bloque de datos junto con el establecimiento de una sesión SIP, sin que esta información forme parte de la señalización necesaria para controlar la llamada.
Su objetivo es facilitar el intercambio de metadatos entre los sistemas que participan en una comunicación. Por ejemplo, una aplicación puede incluir información relacionada con el cliente, el motivo del contacto o algún identificador de negocio para que otro sistema pueda recibirla y utilizarla durante el procesamiento de la llamada.
Cómo usar el componente SIP header
Para utilizar este componente, ingresa al routing point de tipo Voice Flow que deseas configurar en wolkvox Studio.
- En el panel de componentes, selecciona la categoría “Avanzados”.
- Ubica el componente SIP header.
- Arrastra el componente hacia el lienzo del Voice Flow y ubícalo en el punto del proceso donde necesites incorporar la información al encabezado SIP. Haz doble clic izquierdo sobre el componente para abrir su panel de configuración.
- Configura los campos:
- En “Seleccionar item”, selecciona el encabezado que deseas utilizar. Para el transporte de información UUI, selecciona User-to-User.
- En el campo “Valor”, ingresa la información que será enviada dentro del encabezado.
- Haz clic en “Guardar” para almacenar la configuración.
¿Qué es User-to-User?
User-to-User Information (UUI) es un mecanismo utilizado para transportar información adicional entre aplicaciones durante el establecimiento de una sesión SIP.
Esta información se transmite mediante el encabezado: User-to-User
El contenido del encabezado es independiente de la señalización básica utilizada para establecer o controlar la llamada. Su significado es definido por las aplicaciones que generan y reciben la información.
Por ejemplo, un valor UUI podría tener una estructura como: 56a390f3d2b7310023a2;encoding=hex;purpose=foo;content=bar
En este ejemplo, 56a390f3d2b7310023a2 corresponde al dato transportado, mientras que los parámetros separados mediante punto y coma permiten agregar información sobre cómo debe ser interpretado.
El formato exacto que debe escribirse en Valor dependerá de la integración y de lo que espere recibir el sistema de destino.
¿Para qué puede utilizarse?
El componente SIP header puede ser especialmente útil cuando wolkvox necesita intercambiar información adicional con otras aplicaciones o sistemas de telefonía durante una llamada.
| Caso de uso | Ejemplo |
|---|---|
| Identificación de clientes | Enviar un identificador de cliente para que otra aplicación pueda reconocerlo al recibir la llamada. |
| Contexto de la interacción | Transportar información relacionada con el motivo de contacto o con un proceso previo realizado en un IVR. |
| Integraciones con CRM | Enviar identificadores que permitan relacionar la llamada con un cliente, caso, oportunidad u otro registro. |
| Transferencias de llamadas | Mantener información relevante cuando la llamada continúa hacia otro sistema o aplicación preparada para recibir el encabezado. |
| Lógica de negocio | Transportar códigos o datos que otro sistema pueda utilizar para decidir cómo procesar la llamada. |
Consideraciones importantes
El componente SIP header está diseñado para transportar metadatos de aplicación y no para controlar funciones básicas de la llamada.
La información enviada mediante User-to-User solo tendrá utilidad si el sistema receptor está configurado para reconocer e interpretar el contenido recibido. Por esta razón, el formato del valor debe definirse de acuerdo con la integración existente entre los sistemas.
Además, la cantidad de información que puede transportarse mediante este tipo de encabezados es limitada, por lo que se recomienda utilizar datos breves, identificadores o valores necesarios para complementar el contexto de la llamada, en lugar de grandes volúmenes de información.