Descubre todo lo que puedes construir.

Una interfaz SIP familiar

Conserva los canales SIP, Dial(SIP/peer), los comandos habituales de la consola, las integraciones AMI y la familia realtime sippeers. Carga chan_sofia o chan_sip, no ambos, y consulta las diferencias de configuración antes de migrar.

UDP, TCP, TLS, WS y WSS

Conecta terminales SIP y clientes de navegador mediante transportes configurables. Los listeners seguros necesitan certificados válidos para su uso; activar un transporte seguro no protege automáticamente los demás.

Una cuenta, varios dispositivos

Registra contactos independientes, cada uno con su caducidad, y haz sonar los dispositivos disponibles en paralelo. Navegadores y teléfonos de sobremesa reciben el perfil de medios adecuado; la primera respuesta acepta la llamada y cancela las demás ramas.

Control de llamadas e integración de troncales

Utiliza registro saliente, comprobaciones OPTIONS, transferencias REFER, re-INVITE, UPDATE y temporizadores de sesión. Las respuestas provisionales fiables y los temporizadores son configurables; valida la interoperabilidad con tus terminales y operadores.

Presencia, BLF y mensajería SIP

Publica el estado de las extensiones mediante presencia y suscripciones BLF, con creación automática de hints para los terminales configurados. Los mensajes SIP autenticados pueden reenviarse a los dispositivos registrados del destinatario dentro del contexto configurado.

Registro SIP Outbound

Con sip_outbound=yes, el registro saliente anuncia un identificador de instancia estable y reg-id=1. El controlador registra la confirmación Outbound y el Flow-Timer del servidor. La implementación utiliza una sola conexión; el intervalo global de mantenimiento TCP se configura por separado.

Encaminamiento Path del registro

En un terminal con path=yes, conserva la ruta del proxy de acceso asociada a cada contacto registrado y úsala al enviar solicitudes a ese dispositivo. Aceptar Path es una decisión explícita de confianza, no una forma de confiar en cualquier proxy.

Service-Route del proveedor

Activa service_route en una troncal con registro saliente para aprender las rutas del proveedor tras un registro correcto y aplicarlas a las llamadas posteriores. Al retirar la opción o recibir una respuesta sin ruta, se borra el valor almacenado.

Identidad de dispositivo con GRUU

Con gruu=yes, anuncia +sip.instance y aprende los GRUU públicos y temporales emitidos por el servidor de registro. Un registro activo puede usar su GRUU público como Contact del diálogo. Esto no convierte a GABPBX en un servidor general de emisión de GRUU.

Publicación saliente de presencia

Publica el estado de las extensiones configuradas en un servidor de presencia SIP mediante PUBLISH, con renovaciones y seguimiento de ETag. Configura expresamente el destino y la identidad; la publicación queda desactivada si publish_server está vacío.

Suscripciones a eventos externos

Usa subscribe_event para observar un paquete de eventos configurado por terminal y exponer los NOTIFY recibidos mediante SofiaEventNotify en AMI. El controlador no interpreta cuerpos arbitrarios ni los convierte automáticamente en estados de dispositivo; limita el contenido exportado a 8 KiB.

Indicadores de mensajes pendientes

Entrega el número de mensajes de voz a los teléfonos suscritos o configurados. Una suscripción saliente opcional a message-summary puede asociar un buzón externo con la caché MWI local, con reintentos progresivos si falla la suscripción inicial. Las asociaciones de buzón y contexto se configuran expresamente.

Temporizadores de sesión negociados

Configura la caducidad, el intervalo mínimo y el responsable de renovar los diálogos SIP. La política compilada acepta temporizadores, pero no los inicia por defecto. El ajuste refuse impide iniciarlos localmente; no garantiza rechazar un temporizador propuesto por el otro extremo.

Causas Q.850 y cabecera SIP Reason

Traduce causas de finalización y rechazo a cabeceras Reason Q.850 en BYE, CANCEL y respuestas de rechazo INVITE compatibles, e interpreta las causas recibidas. La emisión saliente requiere use_q850_reason; es independiente del motivo de cancelación de una rama que no contestó primero.

Identidad y presentación del llamante

Controla la identidad mediante callerid, fromuser, P-Asserted-Identity o Remote-Party-ID, con gestión de la privacidad de presentación. La confianza en las identidades recibidas y su envío al proveedor son configurables. La política del operador sigue determinando qué identidades acepta y muestra.

Historial de desvíos con Diversion

Transporta la información de desvío en la cabecera SIP Diversion y, opcionalmente, fija una identidad de la troncal con forceddiversion. La cabecera depende de la información de desvío de la llamada; no crea por sí misma reglas de desvío ni garantiza su aceptación por el operador.

Control de caducidad del registro

Aplica duraciones mínima y máxima al registro y responde con 423 y Min-Expires si el intervalo es demasiado corto. La caducidad se controla por contacto; un REGISTER sin contactos consulta los registros sin modificarlos. El estado del registro no garantiza por sí solo que el dispositivo sea accesible.

Mantenimiento de conexiones TCP

Configura tcp_keepalive y tcp_pingpong para las comprobaciones CRLF de la capa SIP en conexiones TCP. Estos controles no se aplican a TLS/WS, que utilizan SO_KEEPALIVE del socket. Ambos ajustes están desactivados por defecto; ping/pong requiere activar keepalive. El Flow-Timer del proveedor genera avisos, pero no modifica automáticamente este intervalo global.

Audio WebRTC bidireccional

Los clientes de navegador pueden registrarse y llamar por WSS con DTLS-SRTP, ICE-lite y multiplexación RTCP. Activa webrtc en los terminales correspondientes y proporciona las bibliotecas y los certificados necesarios. Opus puede pasar sin transcodificación cuando ambas partes lo negocian.

Vídeo entre SIP y WebRTC

Retransmite vídeo VP8 o H.264 entre terminales compatibles, incluidas combinaciones SIP–WebRTC admitidas. El vídeo pasa sin transcodificación: ambas partes necesitan parámetros de códec compatibles; si no los hay, la llamada puede continuar solo con audio.

BUNDLE opcional para audio y vídeo

Usa webrtc_video_bundle para transportar el vídeo por la misma conexión ICE/DTLS que el audio, con identificación por payload y MID. Está desactivado por defecto; de otro modo, el vídeo utiliza su propio transporte. Actívalo para clientes de navegador que exijan negociación de audio y vídeo max-bundle.

Retransmisión de DataChannels WebRTC

Retransmite mensajes de texto y binarios entre dos conexiones WebRTC mediante SCTP sobre DTLS. Requiere usrsctp y datachannel=yes. El límite es de 256 KiB por mensaje, o el límite inferior del destinatario; no es un servicio de transferencia ilimitada de archivos.

Cambio de ruta ICE durante la llamada

El agente ICE-lite sigue la nominación autenticada de una nueva ruta de medios, lo que permite a clientes compatibles recuperarse de un cambio de red. La recuperación depende del cliente y la red; GABPBX no implementa un agente ICE completo con recopilación de candidatos ni un servidor TURN.

Negociación de fax T.38

Negocia T.38 sobre UDPTL con estados explícitos, gestión de re-INVITE y recuperación por tiempo de espera. Actívalo en terminales SIP compatibles; no transporta T.38 dentro de una sesión de medios WebRTC.

DTMF según el modo de medios negociado

Admite telephone-event sobre RTP, SIP INFO y detección de tonos en banda, con un modo auto que se resuelve tras la negociación. SIPDtmfMode permite cambiarlo durante la llamada. WebRTC utiliza telephone-event RTP; la detección en banda depende del audio y del comportamiento del terminal.

Políticas NAT separadas para SIP y medios

force_rport gobierna el encaminamiento de respuestas SIP; comedia activa el tratamiento RTP simétrico. Son controles distintos: la dirección de un proxy de señalización no debe convertirse automáticamente en el destino RTP. Configura las direcciones externas y las redes locales según la topología real.

Espera, reanudación y fotogramas clave

Respeta las direcciones de medios propuestas durante la espera y reanudación y retransmite solicitudes de fotogramas clave mediante PLI/FIR, incluida la traducción SIP INFO admitida. Los codificadores compatibles pueden recuperar el vídeo al reanudar. Esto no implica soporte de REMB ni de control de congestión transport-cc.

Temporizadores de inactividad y mantenimiento RTP

Revisa periódicamente las llamadas contestadas y aplica las políticas rtptimeout, rtpholdtimeout y rtpkeepalive configuradas. El control omite T.38 activo y medios que nunca arrancaron; el tiempo de espera en retención depende de activar el temporizador RTP normal. Elige valores acordes con los terminales.

Encaminamiento directo de medios con restricciones

En llamadas RTP sin cifrar compatibles, directmedia permite que los terminales intercambien medios directamente. Los ajustes NAT y las ACL entre ambos extremos restringen esa ruta. Las conexiones SRTP/DTLS utilizan el puente genérico de la PBX; activar directmedia no elimina estas protecciones del cifrado.

Espera, activación y reanudación

Con push activado, la llamada puede esperar mientras APNs VoIP o FCM despierta la aplicación y reanudarse cuando esta se registra. Requiere cabeceras de token de la app, credenciales y el esquema realtime SQLite. La espera predeterminada es de 24 segundos; al agotarse devuelve NOANSWER.

Alternativa para aplicaciones suspendidas

Una conexión puede parecer abierta aunque la aplicación ya no responda. El temporizador configurable puede activar push tras 4 segundos sin respuesta provisional SIP en las llamadas compatibles con este mecanismo, reutilizando el Call-ID para que la app evite duplicados.

Aviso coordinado a varios dispositivos

Recoge los registros de activación durante una ventana configurable y después llama a los dispositivos disponibles; el valor predeterminado es de 2 segundos. Un registro tardío puede incorporarse mientras suena la llamada. El almacén push admite hasta 10 dispositivos por cuenta y limita las llamadas en espera.

Envío push nativo por HTTP/2

El emisor nativo multiplexa solicitudes APNs/FCM por HTTP/2 persistente, con un límite de 64 trabajos. Necesita libcurl compatible, OpenSSL y res_curl. Para localizar las credenciales lee archivos Python auxiliares que el repositorio público no incluye: debes suministrarlos junto con las credenciales. El envío alternativo también necesita scripts ejecutables.

Ciclo de vida de los tokens push

Actualiza los tokens al registrarse, unifica duplicados de una cuenta y retira entradas antiguas o rechazadas por el proveedor según la política configurada. El cierre de sesión con X-Device-ID elimina el token de ese dispositivo; sin ese identificador, la baja de registro lo conserva para futuras activaciones. La app debe identificar correctamente cada instalación.

Políticas digest MD5 y SHA-256

Selecciona los algoritmos digest ofrecidos y utiliza validación de nonce y comparación de respuestas en tiempo constante. Se conserva la compatibilidad MD5 heredada y auth_qop está desactivado por defecto; no presupongas protección universal contra repetición ni una configuración de ejemplo reforzada.

ACL y controles locales frente al abuso

Aplica listas de acceso al origen, al contacto de registro y a los medios directos, además de una lista negra SIP local y políticas de rechazo de autenticación. Configura expresamente el acceso de invitados: el valor compilado de allowguest es yes. Estos controles no garantizan protección frente a cualquier denegación de servicio.

Verificación TLS explícita

Configura la verificación de certificados, la comprobación opcional del certificado del cliente, los cifrados y la versión mínima de TLS. El mínimo predeterminado es TLS 1.2; la verificación de certificados de servidor y cliente requiere activación y una configuración de confianza adecuada.

Conexiones DTLS-SRTP verificadas

La generación de claves DTLS espera a la huella negociada en SDP y rechaza las discrepancias. La centralita termina y conecta los medios SRTP/WebRTC: es cifrado entre el terminal y la PBX, no cifrado de extremo a extremo que oculte los medios al servidor.

SRTP con negociación de claves SDES

Los terminales SIP compatibles pueden negociar SRTP mediante a=crypto en SDP, con suites AES-CM configurables y GCM admitidas. Los parámetros criptográficos se validan antes de aplicar cambios a los medios. SDES transporta claves en la señalización: protege ese canal y sus diagnósticos.

Visibilidad operativa

Consulta terminales, contactos, registros, canales y la versión de Sofia-SIP cargada. Las acciones y los eventos AMI permiten la gestión externa, y sip show push muestra la caché de tokens y las llamadas en espera ocultando parte del token.

Trazas SIP y captura HEP

Activa diagnósticos de SIP, SDP, ICE, DTMF y llamadas en paralelo, o exporta la señalización descifrada a un colector HEP o a un archivo. La captura está desactivada por defecto. Las trazas pueden contener metadatos de llamadas y SDP sensibles: limita el acceso y la conservación.

Una arquitectura que puedes medir

Un hilo de eventos de señalización, búsquedas mediante tablas hash y trabajadores opcionales para REGISTER realtime hacen explícito el modelo de ejecución. La descarga de REGISTER está desactivada por defecto. Los diagnósticos de hash y colas permiten medir tu carga; no existe una capacidad de llamadas garantizada para todos los entornos.

Funciones experimentales identificadas

Los medios anticipados de llamadas en paralelo y los re-INVITE de espera generados localmente existen tras opciones desactivadas por defecto. Son funciones experimentales: valídalas con tus terminales antes de activarlas. El soporte de espera y reanudación solicitado por el terminal es una función distinta.

Historial SIP acotado por llamada

Activa una cronología compacta de señalización con filtro opcional por origen o destino. Cada diálogo conserva hasta 50 entradas y el controlador retiene hasta 32 historiales terminados. Incluyen resúmenes y metadatos, no mensajes completos ni cabeceras Authorization; no sustituyen un almacén CDR persistente.

Funciones SIP del plan de llamadas

Consulta terminales, cabeceras, información del canal y dominios SIP locales mediante SIPPEER, SIP_HEADER, SIPCHANINFO y CHECKSIPDOMAIN. La implementación documenta los campos y valores admitidos; conservar el nombre de una función no implica que todos sus campos históricos tengan un valor operativo.

Almacenamiento realtime de terminales y registros

Carga terminales mediante la familia realtime sippeers y, opcionalmente, usa sipregs para el estado del registro. rtupdate controla la escritura de registros; un pool opcional mueve esas escrituras fuera del hilo de señalización. Configura aparte el motor y el esquema, sin asumir que toda opción de caché implemente expulsión de entradas.

Dialplan y encaminamiento de llamadas

Organiza las llamadas mediante contextos, extensiones y prioridades. Combina Dial y subrutinas para definir su lógica; el código también incluye motores de dialplan AEL, Lua y realtime.

IVR y locuciones

Combina reproducción de locuciones, recogida de dígitos y reglas de dialplan para crear menús de voz. ExternalIVR y AGI permiten conectar aplicaciones más especializadas.

Buzón de voz

VoiceMail graba los mensajes y VoiceMailMain permite acceder al buzón. El código incluye además comprobación de buzones y funciones de autenticación.

Colas y gestión de agentes

Queue dirige las llamadas a las colas configuradas. Las aplicaciones del dialplan permiten añadir, retirar, pausar y reactivar agentes, con registro de eventos de cola para integraciones.

Conferencias de audio

ConfBridge utiliza el núcleo de puentes para reuniones de audio, con opciones de moderación, participantes silenciados, menús y música en espera.

Grabación de llamadas

MixMonitor graba y mezcla el audio de la llamada; StopMixMonitor cierra la grabación para su procesamiento posterior. Record y Monitor ofrecen otras herramientas de grabación.

Música en espera

Organiza el audio de espera en clases configurables. MusicOnHold, StartMusicOnHold y StopMusicOnHold permiten controlar la reproducción desde el dialplan, con fuentes nativas basadas en archivos.

Aparcamiento y recuperación de llamadas

Park sitúa una llamada en una posición de aparcamiento y ParkedCall la recupera. Los grupos de aparcamiento proporcionan contextos de dialplan, posiciones numeradas y reglas de tiempo de espera y retorno.

Captura de llamadas dirigida y por grupos

Pickup permite contestar una extensión que está sonando, un canal marcado o una llamada del grupo de captura correspondiente. PickupChan puede seleccionar un canal concreto que esté sonando.

Avisos y anuncios a varios teléfonos

Page llama a varios destinos y los incorpora como oyentes, con un modo bidireccional opcional y una locución común. La respuesta automática depende de la configuración de los terminales.

Búsqueda del destinatario: Find-Me / Follow-Me

FollowMe ejecuta un perfil de contacto con pasos de llamada configurables. Sus opciones permiten anunciar el nombre grabado del llamante e informar cuando no se localiza ningún destino.

Identidad de llamada desde el dialplan

CALLERID consulta o actualiza la identidad del canal. CONNECTEDLINE y REDIRECTING permiten usar la información del interlocutor conectado y de los desvíos en la lógica de las llamadas.

Directorio por nombre

Directory permite buscar extensiones asociadas a buzones por nombre, apellido o ambos y continuar por el contexto de dialplan seleccionado.

Acciones y eventos AMI

Gestiona llamadas y recibe eventos de la centralita mediante Manager Interface. El núcleo implementa acciones como Originate, Status, Redirect y Hangup.

AGI, FastAGI y EAGI

Controla un canal desde programas externos mediante AGI, utiliza FastAGI por red o accede al audio entrante con EAGI. res_agi también incluye integración AGI asíncrona.

Configuración realtime

Asocia familias de configuración mediante extconfig.conf. El código incluye controladores PostgreSQL, ODBC, SQLite3, LDAP y cURL para obtener la configuración del sistema que elijas.

CDR y eventos de canal

CDR genera resúmenes de llamadas; CEL registra eventos del ciclo de vida de los canales. Los módulos opcionales incluyen archivos, eventos AMI, PostgreSQL, ODBC y SQLite3.

Eventos personalizados de aplicación

UserEvent emite desde el dialplan un evento AMI con nombre y cabeceras adicionales, para que las aplicaciones externas puedan seguir los hitos que definas en el flujo de llamada.

Opus y audio de banda ancha

El código incluye un codificador y decodificador Opus basado en libopus y un transcodificador G.722. Complementan el audio tradicional G.711 A-law y μ-law.

Reproducción y formatos de archivo

Los módulos de formato permiten trabajar con archivos WAV, audio lineal, PCM y GSM, entre otros. Leer un formato de archivo no equivale a transcodificar su códec.

Fax con SpanDSP

res_fax ofrece SendFAX y ReceiveFAX; res_fax_spandsp incorpora tecnologías de fax G.711 y T.38. Elige una alternativa: res_fax con res_fax_spandsp, o app_fax por separado. No cargues ambas: registran los mismos nombres de aplicación.

Compilación y selección de módulos

Compila primero Sofia-SIP v2.0.4 en /usr/local; después configura GABPBX y selecciona los módulos con menuselect. La guía oficial incluye una receta para Debian 13 y pasos de comprobación.

Dependencias y configuración segura

TLS, SRTP, códecs y módulos de base de datos necesitan sus bibliotecas correspondientes. Comprueba qué módulos están instalados y cargados; make samples es para instalaciones nuevas de laboratorio y puede sobrescribir la configuración existente.

GPLv2 y créditos originales

GABPBX es un fork de Asterisk distribuido bajo GPLv2. El proyecto conserva en su código los avisos de autoría y licencia aplicables de Asterisk, Digium y terceros.