> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar Asterisk / FreePBX a Famulor

> Configura el enrutamiento, autentica las llamadas y prueba la conexión de Asterisk / FreePBX al asistente de Famulor.

Envía llamadas de Asterisk / FreePBX a tu asistente. Confirma el método de conexión de tu cuenta antes de cambiar el enrutamiento del número.

## Preparar el destino en Famulor

1. Abre **Ajustes → Números de teléfono → Añadir un número → Agregar integración SIP**. Selecciona la región SIP y copia la URI mostrada.
2. Para una conexión SIP estática, acuerda el número llamado exacto, el transporte y la autenticación entrante con el operador o administrador de la centralita. Introduce ese número como DID en Famulor. Usa todas las IP de señalización o credenciales si el operador admite Digest hacia el destino.
3. Introduce el host de terminación y la autenticación saliente si harás llamadas por esta conexión. Guarda y asigna el número al asistente.

### Qué introducir en Famulor

Las capturas muestran los nombres de los campos en inglés.

![Llamadas entrantes en Famulor](https://mintcdn.com/ouraicall/1SYDI0Rp2OzxQz66/images/guide-ui/sip-inbound-2026-11-17.webp?fit=max\&auto=format\&n=1SYDI0Rp2OzxQz66\&q=85\&s=3ccc75bb7a279b3fed67f99237270ff5)

Llamadas entrantes en Famulor

* **Your phone number (DID)** · Introduce el número exacto que entrega Asterisk / FreePBX, con el código de país y el signo + para un DID en formato E.164.
* **Inbound authentication / Allowed source IPs** · Selecciona **Provider source IPs** e introduce la lista completa de orígenes de señalización SIP de Asterisk / FreePBX para la ruta elegida.
* Si el proveedor envía autenticación Digest a Famulor, selecciona **SIP username/password** y usa las mismas credenciales entrantes que configuraste en el proveedor.

![Ejemplo en la aplicación en inglés](https://mintcdn.com/ouraicall/4u43DrIxuKKqCPTo/images/guide-ui/sip-asterisk-out-example.webp?fit=max\&auto=format\&n=4u43DrIxuKKqCPTo\&q=85\&s=1fda0b3b07b589aaea09db06c101b1de)

Ejemplo en la aplicación en inglés

Usa tu número, la configuración de tu proveedor y tus credenciales SIP. El campo de contraseña está vacío en el ejemplo.

* **Termination address** · Usa el nombre de host del proveedor indicado en la configuración (Asterisk / FreePBX), sin prefijo SIP ni puerto.
* **Outbound authentication / SIP username / SIP password** · Para Digest, selecciona **Username / password** e introduce el usuario y la contraseña SIP de **platform-auth**.

Si ambos sentidos usan Digest con credenciales distintas, elige **Separate inbound and outbound credentials** en **Credentials**. El formulario muestra un grupo de campos para cada sentido.

## Configurar Asterisk / FreePBX

Configura una troncal estática, sin registro, en ambas direcciones: Asterisk nunca envía a la plataforma un SIP REGISTER, y la plataforma nunca espera uno.

### FreePBX (interfaz gráfica)

1. Abre **Connectivity → Trunks → Add Trunk → Add SIP (chan\_pjsip) Trunk** y pon un nombre a la troncal.
2. En **pjsip Settings → General**, indica el host de Famulor de tu región como **SIP Server**, el puerto 5060 y tu transporte TCP. Configura **Registration → None** y **Authentication → Outbound**. Introduce el usuario y secreto configurados como credenciales entrantes en Famulor.
3. En **Advanced**, usa el mismo host como **From Domain** y el DID exacto como **From User**. Habilita ulaw y alaw y selecciona **Submit → Apply Config**.
4. En **Connectivity → Outbound Routes**, añade una ruta para el DID exacto y elige esta troncal en **Trunk Sequence**. Desde el destino entrante o desbordamiento de la cola, marca ese DID mediante la ruta. Comprueba que la solicitud SIP conserva el `+` del DID de Famulor.

### Configuración en bruto (pjsip.conf)

El ejemplo usa el host de Europa (UE). Usa el nombre de host de Famulor para la región que seleccionaste en la integración SIP. [Direcciones SIP por región](https://docs.famulor.io/es/telephony/sip-trunks.md#direcciones-sip-entrantes).

El ejemplo usa un acceso SIP para ambos sentidos. Introdúcelo como credenciales entrantes y salientes en Famulor. `outbound_auth` responde al desafío de Famulor; `auth` autentica las llamadas que vuelven desde Famulor. Crea secciones separadas si usas accesos distintos.

```text theme={null}
[platform]
type=endpoint
context=from-platform
disallow=all
allow=ulaw
allow=alaw
aors=platform-aor
auth=platform-auth
outbound_auth=platform-auth
from_domain=5wxj7da18ea.eu.sip.livekit.cloud
from_user=<did-in-e164>
direct_media=no
rewrite_contact=yes

[platform-aor]
type=aor
contact=sip:5wxj7da18ea.eu.sip.livekit.cloud;transport=tcp

[platform-auth]
type=auth
auth_type=userpass
username=<username>
password=<password>

[platform-identify]
type=identify
endpoint=platform
match=<famulor-outbound-source-cidr>
```

Selecciona para este endpoint el transporte TCP configurado en tu instalación de Asterisk.

Si las llamadas se cortan tras unos 30 segundos, comprueba en la traza de Asterisk si llega el ACK SIP y si Contact y las direcciones SIP y RTP son públicas. Si el audio solo funciona en un sentido, revisa NAT y RTP. Para un 488, compara los códecs. Para un 401 o 407, verifica las credenciales del lado al que se le pidió autenticarse.

Usa una línea `match=` por cada [rango saliente de Famulor](https://docs.famulor.io/es/telephony/sip-trunks.md#direcciones-de-origen-salientes) autorizado. Asocia el contexto `from-platform` a la extensión o ruta saliente que vas a exponer.

En `extensions.conf`, envía solo el DID configurado en Famulor a este endpoint. Sustituye `+12025550123` por tu DID y conecta el contexto a la ruta entrante o cola prevista.

```text theme={null}
[to-famulor]
exten => +12025550123,1,Dial(PJSIP/${EXTEN}@platform,60)
 same => n,Hangup()
```

![Integración SIP de Famulor con Europa y la dirección SIP entrante](https://mintcdn.com/ouraicall/1SYDI0Rp2OzxQz66/images/guide-ui/sip-region-2026-11-17.webp?fit=max\&auto=format\&n=1SYDI0Rp2OzxQz66\&q=85\&s=8f35c05be47202a269bf598eb620bc3b)

El formulario SIP muestra el destino entrante de la región elegida.

## Probar la ruta completa

Llama al número desde un teléfono externo. Comprueba en el **Historial** la entrada, el asistente, el número original y el audio en ambos sentidos. Prueba el horario, el desbordamiento de cola o la rama IVR que dirige al asistente. Si habilitas llamadas salientes, pruébalas por separado con el número seleccionado. Prueba también la transferencia al destino humano previsto.

## Si falla la prueba

Si la llamada no aparece en el Historial, comprueba la asignación del número, el host, el DID exacto y la autenticación. Si conecta sin audio, revisa los medios y códecs. Ante un rechazo saliente, revisa las credenciales, IP permitidas, identificador y países autorizados. Facilita al soporte la hora y el ID de llamada.

[Ajustes SIP comunes](https://docs.famulor.io/es/telephony/sip-trunks.md).

[Asterisk PJSIP and NAT](https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/Configuring-res_pjsip-to-work-through-NAT/).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.