Lee los encabezados SIP codificados como variables

Muchos sistemas telefónicos envían el contexto de la llamada, como el ID de un cliente o una cola, en encabezados SIP, y a menudo lo codifican para que no viaje como texto plano. Ahora tu agente de voz puede leer esos valores en palabras normales, usarlos en su prompt y pasarlos legibles cuando transfiere la llamada.

En llamadas entrantes por tu SIP trunk

• Cada encabezado personalizado de la llamada se convierte en una variable del Agente de Voz, {{sip_header_<nombre>}}, con el valor tal como llegó. El nombre es el del encabezado en minúsculas: X-Customer-Data queda como {{sip_header_x-customer-data}}.
• Si el encabezado es User-to-User, o su valor declara codificación hex o base64, también recibes {{sip_header_<nombre>_decoded}} con el texto legible.
• Un encabezado que no declara su codificación no tiene variable _decoded, aunque su valor parezca codificado.

Por ejemplo, una llamada que llega con X-Customer-Data: 4a55414e7c564950;encoding=hex le da a tu agente {{sip_header_x-customer-data_decoded}} con el valor JUAN|VIP.

Cuando el agente transfiere la llamada

1. Abre tu agente de voz, ve a Configuración y abre Acciones del agente.
2. Abre la acción Transferir llamada y busca Encabezados SIP Personalizados.
3. Agrega un encabezado y, en su valor, pon |decode después de una variable que sabes que viene codificada, por ejemplo {{sip_header_user-to-user|decode}}.
4. Guarda. El destino recibe ese valor como texto legible.

Ten en cuenta

• Usa |decode solo en valores que sabes que vienen codificados: un valor normal con un número par de caracteres hexadecimales, como 1234, también se decodifica como hex.
• Los encabezados entrantes se leen en llamadas que llegan por un SIP trunk, así que tu operador o tu PBX tiene que agregarlos.
• Que un encabezado llegue al destino de la transferencia depende de que tu operador o tu PBX lo deje pasar. Confírmalo con quien administra tu telefonía.