VICIfast
ENES
Todas las integraciones

Troncal SIP Twilio (Elastic SIP) para VICIdial

Conecte su troncal Elastic SIP de Twilio a VICIdial administrado. PJSIP con plantilla: tres campos y en funcionamiento en 30 segundos.

Twilio es el carrier más fácil para empezar: cinco minutos de configuración en Twilio y luego 30 segundos en el panel. La plataforma escribe el endpoint PJSIP, regenera el dialplan y recarga Asterisk por usted. Nunca edita pjsip.conf a mano.

Lo que necesita de Twilio

  • Un Elastic SIP Trunk creado en la consola de Twilio
  • La Termination URI de la troncal (se ve así: your-trunk.pstn.twilio.com)
  • Una credencial de terminación: su usuario y su contraseña (Console → Elastic SIP Trunking → Authentication)
  • Un DID comprado y enrutado a la Origination URI de su troncal

Agregue la troncal

Panel → su servidor → pestaña Troncales → Agregar troncal, y en el panel lateral Agregar troncal SIP elija Twilio Elastic SIP Trunking. El formulario, de arriba abajo:

CampoQué escribir
Nombre de la troncalViene con twilio-elastic. Letras minúsculas, dígitos y guiones; al guardarse se le agrega un sufijo de 4 caracteres, por ejemplo twilio-elastic-3f9a.
DirecciónAmbas (la predeterminada), Solo salientes o Solo entrantes
Hostname / IP del carriersu Termination URI, por ejemplo your-trunk.pstn.twilio.com (obligatorio)
Usuarioel usuario de su credencial de terminación (obligatorio)
Contraseñasu contraseña (obligatoria)
Notas (opcional)lo que quiera recordar sobre esta troncal

Si quiere, marque Asignar esta troncal a una campaña, elija la Campaña y, en Usar esta troncal para, marque Marcación automática, Marcación manual o Transferencia de 3 vías. Luego haga clic en Agregar troncal.

La troncal aparece como Instalando y luego como Activo. Mientras tanto, la plataforma escribe el endpoint PJSIP por SSH, regenera el dialplan, recarga Asterisk y asigna un prefijo de marcación de 4 dígitos (por ejemplo, 9042). Listo: con Enviar llamada de prueba, en la pestaña Troncales, hace una llamada de prueba en segundos.

Lo que se escribe en el servidor

La plataforma guarda sus troncales en dos archivos propios y los reescribe completos en cada cambio de troncal: /etc/asterisk/vicifast-trunks.conf (PJSIP), que pjsip.conf carga con #include vicifast-trunks.conf, y /etc/asterisk/vicifast-trunks-dialplan.conf (dialplan), que extensions.conf carga con #include vicifast-trunks-dialplan.conf.

/etc/asterisk/vicifast-trunks.conf, con Dirección en Ambas:

; --- trunk: twilio-elastic-3f9a (Twilio Elastic SIP Trunking, bidirectional, enabled) ---
[twilio-elastic-3f9a]
type=endpoint
context=trunkinbound
disallow=all
allow=ulaw
allow=alaw
allow=g729
outbound_auth=twilio-elastic-3f9a-auth
aors=twilio-elastic-3f9a-aor
from_domain=your-trunk.pstn.twilio.com
direct_media=no
rtp_timeout=120
rtp_symmetric=yes
force_rport=yes
trust_id_inbound=yes
trust_connected_line=no

[twilio-elastic-3f9a-auth]
type=auth
auth_type=userpass
username=<usuario de la credencial>
password=<contraseña de la credencial>

[twilio-elastic-3f9a-aor]
type=aor
contact=sip:your-trunk.pstn.twilio.com
qualify_frequency=60

[twilio-elastic-3f9a-identify]
type=identify
endpoint=twilio-elastic-3f9a
match=<rango de señalización de Twilio 1>
match=<rango de señalización de Twilio 2>
; --- end: twilio-elastic-3f9a ---

No hay sección registration: Elastic SIP Trunking no acepta REGISTER, sino que verifica su credencial de terminación en cada llamada. El único contacto del AOR es su Termination URI, y la sección identify lleva una línea match= por cada rango de señalización que publica Twilio, para que las llamadas que Twilio le envía lleguen a esta troncal. Con Solo salientes, el endpoint va en context=trunkoutbound y se omite la sección identify. Con Solo entrantes, la plantilla escribe la forma de autenticación por IP: una sección identify sobre el rango de originación de Twilio, su Termination URI como contacto y su credencial en una sección -auth que las llamadas entrantes nunca usan.

/etc/asterisk/vicifast-trunks-dialplan.conf, en el contexto [default] al que marca VICIdial:

[default]

; --- trunk: twilio-elastic-3f9a (Twilio Elastic SIP Trunking, outbound, enabled) ---
exten => _9042X.,1,NoOp(VICIfast trunk: twilio-elastic-3f9a)
exten => _9042X.,n,AGI(agi://127.0.0.1:4577/call_log)
; --- VICIFAST_BLA_BEGIN — managed by TCPA settings ---
; (no TCPA screening set up on this server, so there is nothing to call)
; --- VICIFAST_BLA_END ---
exten => _9042X.,n,Dial(PJSIP/${EXTEN:4}@twilio-elastic-3f9a,,tor)
exten => _9042X.,n,Hangup
; --- end: twilio-elastic-3f9a ---

Cuando el filtrado TCPA está configurado para el servidor (Cumplimiento predeterminado) o para la troncal (Cumplimiento (TCPA)), el comentario entre los dos marcadores VICIFAST_BLA se convierte en una verificación con vicifast-tcpa.agi que cuelga antes del Dial si el número está bloqueado.

Usted no pega nada de esto. Lo hacemos nosotros.

Vincule una campaña de VICIdial

La pestaña Troncales muestra el prefijo asignado en la fila de la troncal (por ejemplo, prefijo 9042). Hay dos opciones:

  • En el panel: haga clic en la troncal para abrirla, vaya a Enrutamiento y campañas, marque la campaña o las campañas de VICIdial y haga clic en Aplicar enrutamiento. La plataforma actualiza vicidial_campaigns.dial_prefix por SSH. (Asignar esta troncal a una campaña hace lo mismo mientras agrega la troncal).
  • Manual: abra vicidial_admin.php → Campaigns → <su campaña> → Dial Prefix, pegue el prefijo y guarde.

El efecto es el mismo de las dos formas.

DID entrantes

En Twilio Console → SIP Trunking → su troncal → Origination URI:

sip:<ipv4-de-su-servidor>;transport=udp

…o use el nombre de host de su servidor en lugar de la IP. Luego, en la pestaña Entrantes de su servidor → DID → Nuevo DID, escriba en Número de teléfono o ID del carrier el número tal como lo envía Twilio, elija el destino en Enrutar a (un In-Group, un call menu, una extensión, etc.) y haga clic en Crear DID.

Advertencias

  • Atestación: la atestación A de Twilio es de nivel empresarial; Elastic SIP recibe B/C por defecto. Si hace llamadas salientes a EE. UU. en serio, configure SHAKEN/STIR con Twilio antes de escalar.
  • Precio por minuto: Twilio es premium. Para alto volumen dentro de EE. UU., Bandwidth o Telnyx reducen la factura entre un 30 y un 50%.
  • Lista de IP permitidas: si prefiere no tener credenciales en vicifast-trunks.conf, agregue la troncal saliente con Genérico: autenticación por IP (en la sección Personalizado) en lugar de la plantilla de Twilio, y agregue la IPv4 de su servidor a la lista de IP permitidas en Twilio.