Parámetros SIP
Cómo habla tu central con teléfonos y proveedores, para toda la instalación
SIP es el protocolo con el que la central habla con los teléfonos de tus agentes y con tu proveedor de telefonía. Esta pantalla fija cómo lo habla: qué códecs de audio acepta, cómo viajan los tonos del teclado, cómo se comporta detrás de un router, cuánto dura el registro de un teléfono, cuándo cuelga una llamada que se quedó sin audio.
La encuentras en Configuración > Avanzado > SIP, con el título Configuración SIP. Es una sola configuración para toda la central: lo que cambies aquí lo sienten todas las Extensiones SIP y todas las Troncales telefónicas a la vez.
Importante
Con los valores de fábrica la central funciona. Cambia un parámetro solo cuando sepas qué problema resuelve, idealmente con el equipo de soporte de Audara, y uno a la vez: si algo se rompe, sabes cuál fue.
Cómo funciona la pantalla
Los parámetros se reparten en tres pestañas: Básico, Avanzado y Personalizado. La pestaña Avanzado solo la ven los administradores.
Dentro de cada pestaña los campos no están agrupados por tema: van seguidos, dos por fila, más o menos en orden alfabético. Las etiquetas son el nombre técnico del parámetro, en minúsculas, y así aparecen también en las tablas de abajo.
Unas reglas que valen para toda la pantalla:
- Los desplegables muestran sus opciones en minúsculas. Casi todos empiezan con --, que quiere decir "sin definir": el parámetro no se escribe y el motor de telefonía usa su propio valor por defecto.
- Los campos de rango de IP tienen dos cajas separadas por una barra: la IP a la izquierda y la máscara a la derecha. Solo aceptan números y puntos.
- Los campos de tiempo y de cantidad solo aceptan dígitos.
- bindaddr* y rtp_engine* son obligatorios. Si alguno queda vacío, no se puede guardar.
Guardar se habilita cuando cambias algo, y guarda las tres pestañas de una vez. Al guardar, la central genera de nuevo su configuración SIP. Si el motor de telefonía no acepta la configuración nueva, el cambio se deshace y te sale un error: no queda a medias.
Parámetros SIP, troncales y extensiones
Lo que pones aquí es el valor general. Una troncal puede tener sus propios valores para algunos de estos mismos parámetros, en su pestaña General, y lo que define la troncal manda sobre lo general. Lo que la troncal deja en -- lo toma de aquí.
Por eso, si un solo proveedor pide algo distinto, el cambio va en su troncal y no aquí. Cómo se hace está en Troncales telefónicas. Las Rutas telefónicas no tienen parámetros SIP propios: escogen por cuál troncal sale o entra la llamada, y la llamada se comporta según esa troncal.
Los que más se tocan
De los más de 150 parámetros, estos son los que resuelven los problemas que más se ven en una operación.
- Códecs: disallow y allow
- Se usan juntos. disallow en all cierra todos los códecs, y allow abre solo los que quieres, en orden de preferencia. De fábrica vienen ulaw, alaw y gsm. Si una llamada conecta pero no se escucha nada, lo primero es revisar que el proveedor y la central tengan un códec en común.
- Tonos del teclado: dtmfmode
- Si un cliente marca una opción en el IVR y la central no la reconoce, el problema suele estar aquí. De fábrica viene en rfc2833, el estándar.
- La red: nat, externaddr y localnet
- Cuando la central está detrás de un router, tiene que saber cuál es su IP pública (externaddr) y cuál es tu red interna (localnet). Si están mal, el síntoma clásico es el audio en un solo sentido: tú oyes al cliente y el cliente no te oye.
- Llamadas que se cortan solas: rtptimeout
- Cuántos segundos aguanta la central una llamada activa sin recibir audio antes de colgarla. De fábrica son 30.
- Seguridad: allowguest, alwaysauthreject y autocreatepeer
- Vienen cerrados de fábrica y así deben quedar. Abrirlos deja que equipos que no son tuyos se conecten o averigüen qué usuarios existen.
Nota
Si tus llamadas se cortan justo a los 30 segundos de quedarse en silencio, por ejemplo mientras el cliente busca un dato en mudo, revisa rtptimeout antes de culpar al proveedor. Algunos teléfonos dejan de mandar audio cuando se silencian.
Pestaña Básico
Los parámetros en el orden en que aparecen en pantalla, de izquierda a derecha y de arriba abajo. Donde hay un valor de fábrica, lo indicamos: es el que trae una instalación nueva, y el tuyo puede haber cambiado.
| Parámetro | Qué controla | Opciones y valor de fábrica |
|---|---|---|
| accept_outofcall_message | Si la central acepta mensajes de texto SIP que llegan fuera de una llamada. | no, yes |
| allow | Los códecs que la central acepta negociar, en orden de preferencia. Se agregan y se quitan como etiquetas. | Lista de códecs. De fábrica: ulaw, alaw, gsm |
| allowguest | Si acepta llamadas de equipos que no se autentican. En yes, cualquiera que encuentre tu IP puede meter llamadas. | yes, no. De fábrica: no |
| allowoverlap | La marcación por partes, cuando el número llega en varios mensajes en vez de completo. | yes, no, dtmf |
| allowtransfer | Si los teléfonos pueden transferir llamadas por SIP. | yes, no |
| alwaysauthreject | Al rechazar un intento de conexión, responde siempre lo mismo, exista o no el usuario, para no darle pistas a quien prueba usuarios al azar. | yes, no. De fábrica: yes |
| authfailureevents | Genera un evento interno cada vez que falla una autenticación. | yes, no |
| auth_message_requests | Exige autenticación para recibir mensajes de texto SIP. | yes, no |
| auth_options_requests | Exige autenticación para las consultas de disponibilidad que mandan los equipos. | yes, no |
| autocreatepeer | Crea un dispositivo solo cuando uno desconocido intenta registrarse. persist además lo conserva al recargar. | no, yes, persist |
| bindaddr* | La IP del servidor en la que la central escucha SIP. 0.0.0.0 es todas sus interfaces. Obligatorio. | Texto. De fábrica: 0.0.0.0 |
| buggymwi | Compatibilidad con teléfonos que manejan mal el aviso de mensajes en el buzón de voz. | yes, no |
| callevents | Genera eventos internos de lo que pasa en la llamada, como ponerla en espera. | yes, no. De fábrica: yes |
| compactheaders | Usa la forma abreviada de los encabezados SIP, para mensajes más cortos. | yes, no |
| contactacl | El nombre de una lista de acceso que filtra desde qué IP se pueden registrar los equipos. | Texto |
| contactdeny | Rango de IP desde el que no se permite registrar equipos. | IP / máscara |
| contactpermit | Rango de IP que sí se permite, como excepción a contactdeny. | IP / máscara |
| cos_audio, cos_sip, cos_text, cos_video | La prioridad de clase de servicio que lleva cada tipo de tráfico: audio, señalización, texto y video. Solo sirve si tu red la tiene en cuenta. | Texto |
| defaultexpiry | Cuántos segundos dura el registro de un teléfono que no pide una duración. | Número. De fábrica: 120 |
| deny | Rango de IP al que se le niega el acceso SIP. | IP / máscara |
| disallow | Los códecs que la central no acepta. Lo normal es all, y abrir en allow solo los que quieres. | Lista de códecs. De fábrica: all |
| disallowed_methods | Los tipos de mensaje SIP que la central anuncia que no acepta. | Texto |
| domainsasrealm | Usa el dominio SIP como dominio de autenticación, en vez del fijo de realm. | Texto |
| dtmfmode | Cómo viajan los tonos del teclado. rfc2833 los manda aparte del audio y es el estándar. inband los manda como sonido dentro del audio, y solo funciona con códecs sin compresión como ulaw y alaw. info y shortinfo los mandan como mensajes SIP. auto usa rfc2833 si el otro lado lo ofrece, y si no inband. | rfc2833, auto, inband, info, shortinfo. De fábrica: rfc2833 |
| dynamic_exclude_static | Impide que un equipo se registre desde una IP que ya tiene asignada un dispositivo de IP fija. | yes, no |
| g726nonstandard | Compatibilidad con equipos que usan el códec G.726 de la forma no estándar. | yes, no. De fábrica: no |
| keepalive | Cada cuántos segundos la central manda un paquete a los dispositivos para mantener abierta la conexión. | Número |
| language | El idioma por defecto de los mensajes de voz. Se escoge de los idiomas de audio de la central. | Lista de idiomas. De fábrica: es |
| legacy_useroption_parsing | Lee las opciones que vienen pegadas al número marcado a la manera antigua, por compatibilidad. | no, yes |
| matchexternaddrlocally | Anuncia la IP pública de externaddr solo cuando el destino está fuera de tu red local. | yes, no |
| match_auth_username | Identifica al que se autentica por el usuario de la autenticación, no por el remitente del mensaje. | yes, no |
| maxcallbitrate | El ancho de banda máximo de una videollamada, en kilobits por segundo. | Número. De fábrica: 384 |
| maxexpiry | El máximo de segundos que un teléfono puede pedir para su registro. | Número. De fábrica: 3600 |
| maxforwards | Cuántos servidores puede atravesar un mensaje SIP antes de descartarse. | Número |
| minexpiry | El mínimo de segundos de registro. Si un teléfono pide menos, se le rechaza. | Número. De fábrica: 60 |
| mohinterpret | La música que suena de tu lado cuando el otro extremo pone la llamada en espera. | La música en espera cargada en Audios de telefonía |
| mohsuggest | La música que le sugieres al otro extremo cuando tú lo pones en espera. | La música en espera cargada en la central |
| mwiexpiry | Cuánto duran las suscripciones a avisos de buzón de voz de otro servidor. | Número |
| mwi_from | El remitente que aparece en los avisos de buzón de voz. | Texto |
| notifymimetype | El tipo de contenido de los avisos de buzón de voz. | Texto |
| outboundproxy | Un servidor intermedio por el que salen todos los mensajes SIP. | Texto |
| outofcall_message_context | A qué parte del plan de marcación van los mensajes de texto que llegan fuera de una llamada. | Texto |
| parkinglot | El parqueadero de llamadas por defecto. | Texto |
| pedantic | Revisa los mensajes SIP según el estándar al pie de la letra. Ayuda con algunos proveedores y falla con equipos que no lo siguen. | yes, no |
| permit | Rango de IP que sí tiene acceso, como excepción a deny. | IP / máscara |
| preferred_codec_only | Al contestar, ofrece solo el códec preferido en vez de la lista completa. | yes, no |
| prematuremedia | Descarta el audio que llega antes de que la llamada esté timbrando. Con algunas líneas evita que quien llama oiga silencio en vez del timbre. | yes, no |
| progressinband | Si la central genera el tono de timbre dentro del audio en vez de solo avisar que está timbrando. never no lo genera nunca. | yes, no, never |
| promiscredir | Sigue las redirecciones de llamada aunque apunten a otro servidor. | yes, no |
| qualifyfreq | Cada cuántos segundos la central pregunta a los dispositivos si están vivos. Es la consulta que alimenta la columna Conexión de las troncales. | Número |
| qualifygap | Los milisegundos entre un grupo de consultas y el siguiente. | Número |
| qualifypeers | Cuántos dispositivos se consultan en cada grupo. | Número |
| realm | El dominio de autenticación que la central presenta al pedir contraseña. | Texto |
| recordofffeature, recordonfeature | La función de grabación que se detiene o se inicia cuando un teléfono lo pide por SIP. | Texto |
| refer_addheaders | Agrega encabezados de referencia a la llamada que resulta de una transferencia. | yes, no |
| regcontext | Dónde crea la central una entrada por cada dispositivo registrado. | Texto |
| regextenonqualify | Hace que esa entrada dependa de que el dispositivo conteste las consultas de disponibilidad. | no, yes |
| relaxdtmf | Más tolerancia al detectar tonos, para equipos que los mandan defectuosos. | yes, no |
| rpid_update | Avisa al otro extremo durante la llamada cuando cambia quién está al otro lado, por ejemplo después de una transferencia. | yes, no |
| rtp_engine* | El motor que maneja el audio. Obligatorio. | Texto. De fábrica: asterisk |
| sendrpid | Si envía la identificación de quien llama en un encabezado aparte, además del remitente. | Texto |
| send_diversion | En las llamadas desviadas, envía el encabezado que dice desde qué número se desvió. | yes, no |
| shrinkcallerid | Quita paréntesis, guiones, puntos y espacios del número de quien llama. | yes, no |
| srvlookup | Busca el servidor SIP de un dominio en el DNS al hacer una llamada. | yes, no. De fábrica: no |
| submaxexpiry | La duración máxima de una suscripción, como la de un teléfono que muestra si otra extensión está ocupada. | Número |
| subminexpiry | La duración mínima de esa suscripción. | Número |
| tcpauthlimit | Cuántas conexiones TCP sin autenticar puede haber abiertas a la vez. | Número |
| tcpauthtimeout | Cuántos segundos puede estar una conexión TCP sin autenticarse antes de cerrarse. | Número |
| tcpbindaddr | La IP en la que la central escucha SIP por TCP. | Texto |
| tcpenable | Habilita SIP por TCP. | no, yes. De fábrica: no |
| tlsbindaddr | La IP en la que la central escucha SIP cifrado por TLS. | Texto |
| tlsenable | Habilita SIP cifrado por TLS. | no, yes. De fábrica: no |
| tonezone | El país de los tonos: el de marcar, el de ocupado, el de timbre. | Texto |
| tos_audio, tos_sip, tos_text, tos_video | La marca de prioridad que lleva cada tipo de tráfico en la red, para que los equipos que la respetan le den paso al audio. | Texto. De fábrica: ef el audio, cs3 la señalización, af41 el video |
| transport | El transporte por defecto de los mensajes SIP. | udp, tcp, tls, ws, wss. De fábrica: udp |
| trustrpid | Si confía en la identificación de quien llama que llega en un encabezado aparte. | yes, no |
| useragent | Cómo se presenta la central en los mensajes SIP. | Texto. De fábrica: audara |
| usereqphone | Marca como número de teléfono las direcciones que lo son. Algunos proveedores lo piden. | no, yes |
| use_q850_reason | Al colgar, incluye la causa en el formato de la telefonía tradicional. Ayuda a saber de qué lado se cortó una llamada. | no, yes |
| videosupport | Si se permite video. | yes, no. De fábrica: yes |
| vmexten | El número que marca el teléfono cuando se presiona su botón de buzón de voz. | Texto |
Pestaña Avanzado
Aquí están los ajustes finos del audio, la red, los temporizadores y el diagnóstico. En el orden de la pantalla:
| Parámetro | Qué controla | Opciones y valor de fábrica |
|---|---|---|
| jbenable | Activa el buffer de jitter: la central guarda unos milisegundos de audio para suavizar una red que entrega los paquetes a destiempo. Sirve cuando el audio llega entrecortado. | yes, no. De fábrica: no |
| jbforce | Usa el buffer aunque el otro extremo tenga el suyo. | yes, no |
| jbimpl | El tipo de buffer: de tamaño fijo o adaptable a la red. | fixed, adaptive |
| jblog | Registra lo que hace el buffer, para diagnóstico. | yes, no |
| jbmaxsize | El tamaño máximo del buffer, en milisegundos. | Número |
| jbresyncthreshold | El salto de tiempo, en milisegundos, a partir del cual el buffer se vuelve a sincronizar. | Número |
| jbtargetextra | Los milisegundos extra que agrega el buffer adaptable. | Número |
| avpf | El perfil de audio con retroalimentación que piden los navegadores. | yes, no |
| directmedia | Si el audio puede ir directo entre los dos extremos sin pasar por la central. Con el audio fuera de la central no hay grabación, así que en un contact center va en no. | yes, nonat, update, outgoing, no |
| directmediaacl | El nombre de una lista de acceso que dice qué IP pueden recibir audio directo. | Texto |
| directmediadeny | Rango de IP que no recibe audio directo. | IP / máscara |
| directmediapermit | Rango de IP que sí lo recibe, como excepción. | IP / máscara |
| directrtpsetup | Arma el audio directo desde el inicio de la llamada. | yes, no |
| encryption | Cifra el audio de las llamadas. Solo si todos los equipos lo soportan: el que no, se queda sin audio. | yes, no |
| encryption_taglen | La longitud de la etiqueta que autentica el audio cifrado. | Número |
| ignoresdpversion | Procesa siempre la descripción de audio que manda el otro extremo, aunque diga que no cambió. Ayuda con proveedores que cambian el audio sin avisar. | yes, no |
| sdpowner | El nombre de propietario que va en la descripción de audio. | Texto |
| sdpsession | El nombre de sesión que va en la descripción de audio. | Texto |
| externaddr | La IP pública que la central anuncia cuando está detrás de un router. | Texto |
| externhost | Lo mismo, con un nombre en vez de una IP, para cuando la IP pública cambia. | Texto |
| externrefresh | Cada cuántos segundos vuelve a averiguar la IP de externhost. | Número |
| externtcpport | El puerto público de SIP por TCP. | Número |
| icesupport | Un mecanismo para atravesar routers que usan los navegadores. | yes, no |
| localnet | Tu red interna. A lo que está dentro de ella no se le anuncia la IP pública. | IP / máscara |
| media_address | La IP que se anuncia para el audio, si es distinta a la de los mensajes SIP. | Texto |
| nat | Cómo trata la central a los equipos que están detrás de un router. El valor de fábrica le responde a cada equipo por donde le llegó el mensaje y le manda el audio por donde le llega el audio. | Texto. De fábrica: force_rport,comedia |
| subscribe_network_change_event | Si la central reacciona cuando cambia la red del servidor. | yes, no |
| mailbox | El buzón de voz de otro servidor del que se reciben avisos. | Texto |
| mwi | La suscripción a ese buzón de voz externo. | Texto |
| registerattempts | Cuántas veces intenta la central registrarse en un proveedor antes de rendirse. 0 es sin límite. | Número. De fábrica: 0 |
| registertimeout | Los segundos entre un intento de registro y el siguiente. | Número. De fábrica: 20 |
| ignoreregexpire | Conserva los datos de registro de un dispositivo aunque se hayan vencido. | yes, no |
| rtautoclear, rtcachefriends, rtsavesysname, rtupdate | Cómo maneja la central los dispositivos que lee de la base de datos en tiempo real: cuándo los olvida, si los guarda en memoria, y qué actualiza al registrarse. | rtautoclear es texto; los otros tres, yes, no |
| rtpholdtimeout | Los segundos sin audio que aguanta una llamada en espera antes de colgarse. | Número. De fábrica: 300 |
| rtpkeepalive | Cada cuántos segundos manda la central un paquete de audio para mantener el camino abierto. 0 lo apaga. | Número. De fábrica: 0 |
| rtptimeout | Los segundos sin audio que aguanta una llamada activa antes de colgarse. | Número. De fábrica: 30 |
| dumphistory, recordhistory, sipdebug | Herramientas de diagnóstico: guardan el historial de mensajes SIP de cada llamada y activan la depuración. Llenan los registros del servidor, así que se prenden para investigar algo y se apagan después. | yes, no |
| allowexternaldomains | Acepta llamadas dirigidas a dominios que no están en domain. | yes, no |
| autodomain | Agrega solos la IP y el nombre del servidor a la lista de dominios propios. | yes, no |
| domain | Los dominios SIP que la central considera suyos. | Texto |
| fromdomain | El dominio que va como remitente en los mensajes que salen. | Texto |
| session-expires | Cada cuántos segundos se renueva una llamada en curso, para detectar llamadas que quedaron colgadas de un lado. | Número |
| session-minse | El mínimo de segundos de renovación que la central acepta. | Número |
| session-refresher | Quién hace la renovación: el que recibe la llamada (uas) o el que la hace (uac). | uas, uac |
| session-timers | Si la central pide la renovación (originate), la acepta solo cuando el otro la pide (accept) o la rechaza (refuse). | originate, accept, refuse |
| t1min | El mínimo, en milisegundos, que la central supone que tarda un mensaje en ir y volver. | Número |
| timerb | Los milisegundos que espera respuesta a una llamada antes de darla por perdida. | Número |
| timert1 | El tiempo base, en milisegundos, para volver a mandar un mensaje sin respuesta. | Número |
| allowsubscribe | Permite que un teléfono se suscriba al estado de otra extensión, lo que enciende las luces de ocupado. | yes, no. De fábrica: yes |
| callcounter | Lleva la cuenta de llamadas de cada dispositivo. Hace falta para limitar las llamadas simultáneas y para saber si una extensión está ocupada. | yes, no. De fábrica: yes |
| notifycid | Incluye quién llama en el aviso de que otra extensión está timbrando, para poder capturarle la llamada. | yes, no, ignore-context. De fábrica: yes |
| notifyhold | Avisa a los suscritos cuando una extensión pone una llamada en espera. | yes, no. De fábrica: yes |
| notifyringing | Avisa a los suscritos cuando una extensión está timbrando. | yes, no. De fábrica: yes |
| subscribecontext | Dónde busca la central las extensiones a las que un teléfono se puede suscribir. | Texto |
| faxdetect | Si la central detecta un fax entrante: por su tono (cng), por su señal (t38) o por los dos (yes). | yes, no, cng, t38 |
| t38pt_udptl | El soporte de fax por T.38. | Texto |
| tlscapath | La carpeta con los certificados de las autoridades en que confía la central. | Texto |
| tlscipher | Los cifrados permitidos en las conexiones TLS. | Texto |
| tlsclientmethod | La versión del protocolo de las conexiones TLS que abre la central. | tlsv1, sslv3, sslv2 |
| tlsdontverifyserver | No verifica el certificado del servidor al que se conecta. Solo para pruebas. | yes, no |
Pestaña Personalizado
Para los parámetros SIP que no tienen campo propio en las otras dos pestañas. Cada uno es un par de Propiedad y Valor, que la central escribe como propiedad=valor junto al resto de la configuración general.
Escribe la propiedad y el valor y presiona el Guardar de la pestaña. El par aparece en la lista de Registros creados, donde puedes reordenarlo arrastrando, y editarlo o eliminarlo desde su menú de tres puntos. Ese Guardar solo lo pone en la lista: el cambio se guarda de verdad con el Guardar de arriba.
Una instalación nueva ya trae algunos aquí, que son parte de la configuración de fábrica. No los borres sin hablar antes con soporte.
Importante
Los dos campos solo aceptan letras, números, puntos y espacios. Un parámetro con guion bajo en el nombre, o un valor con comas o dos puntos, no se puede escribir aquí. Si lo necesitas, pídeselo al equipo de soporte de Audara.
La pantalla Parámetros
Justo encima de SIP, en Configuración > Avanzado > Parámetros, hay otra pantalla de ajustes generales de la central. No es de SIP, pero su botón de ayuda abre este mismo artículo, así que la explicamos aquí.
- Inicio de Aviso por Temporización (seg)
- Cuando una extensión tiene un temporizador de llamadas, cuántos segundos antes del corte empieza a sonar el aviso.
- Repetición de Aviso por Temporización (seg)
- Cada cuántos segundos se repite ese aviso hasta el corte.
- Temporizados Máximo (min)
- El valor más alto que se le puede poner al temporizador de una extensión.
- Tiempo Máximo de Timbrado (seg)
- Cuánto timbra una extensión antes de pasar al buzón de voz o colgar.
- Extensión de Operadora
- La extensión que hace de operadora de la central. Se escoge de la lista de extensiones.
- País
- El país por defecto de la central.
- Idioma de Anuncios
- El idioma por defecto de los mensajes de voz en extensiones y dispositivos. Cada módulo lo puede cambiar después para lo suyo.
- Moneda
- La moneda por defecto de Audara.
- Delimiter
- El separador de los archivos CSV: punto y coma o coma.
- Usar Encripción
- Cifra los datos de las extensiones.
Los cuatro tiempos solo aceptan dígitos, y no se pueden dejar vacíos: si guardas uno en blanco, sale un error y no se guarda nada. Los tres primeros trabajan con el Temporizador de las troncales y el Temporizador de llamadas de cada extensión, que se explican en Troncales telefónicas y Extensiones.