Conecta Asterisk con Xcellerate OPS: identificación, clic para llamar y registro

Conecta tu propio Asterisk con Xcellerate OPS: las llamadas entrantes muestran el contacto, cada llamada llega a la línea de tiempo del CRM y tu equipo llama a clientes desde OPS. Guía para administradores de MSP y empresas de servicios con Asterisk autogestionado (16 o posterior).

TL;DR

• OPS se conecta a Asterisk por AJAM sobre HTTPS, con un usuario manager que solo acepta la dirección de OPS.
• Ventana de llamada entrante, clic para llamar (primero suena tu teléfono) y registro en la línea de tiempo del CRM.
• Opcional: grabaciones desde una carpeta HTTPS protegida y conciliación nocturna con tu base CDR.

Antes de empezar

• Eres administrador de OPS o tu rol puede gestionar la telefonía.
• Un administrador de Asterisk que pueda editar http.conf, manager.conf y el dialplan. Asterisk 16+; el fragmento de dialplan está probado en 18 y 20.
• OPS debe llegar a tu Asterisk por HTTPS; una centralita inaccesible aún no se puede conectar.
• La dirección de OPS para tu cortafuegos, en la página de telefonía como "Our address, for your firewall" (Nuestra dirección para tu cortafuegos).

La telefonía es una función básica en todos los planes.

Paso 1: prepara Asterisk

AJAM sobre HTTPS

En http.conf:

enabled = yes
tlsenable = yes
tlsbindaddr = 0.0.0.0:8089

Un usuario manager para OPS

En manager.conf, crea un usuario con un secreto largo, limitado a la dirección de OPS:

deny = 0.0.0.0/0.0.0.0
permit = <dirección OPS>/255.255.255.255
read = call,cdr,reporting,user
write = originate

Permite la dirección de OPS hacia ese puerto en el cortafuegos.

Opcional: grabaciones y CDR

• Añade las macros de grabación de OPS (ops-recording y ops-hangup) del fragmento de dialplan publicado a tus contextos entrantes y salientes. No cambies los nombres de archivo.
• Sirve la carpeta monitor (/var/spool/asterisk/monitor) en solo lectura por HTTPS, con basic auth y lista de IP permitidas.
• Para la conciliación: acceso de lectura a la base CDR, por ejemplo mysql:host=…;dbname=asteriskcdrdb, tabla cdr.

OPS nunca activa la grabación. Si debes anunciarla, hazlo en el dialplan antes de que empiece. Recarga Asterisk.

Paso 2: añade Asterisk en OPS

Abre Settings → Data and security → Telephony (Ajustes → Datos y seguridad → Telefonía), pulsa Add a phone system (Añadir una centralita), elige Asterisk y ponle nombre.

La página Telefonía con un desplegable de centralitas, un campo de nombre y el aviso de que aún no hay ninguna centralita conectada.

Rellena Asterisk address (https://pbx.example.com:8089), Manager user (AMI/AJAM), Manager secret. Para grabaciones: Recordings base URL, Recordings user, Recordings password. Para la conciliación: CDR database DSN, CDR database user, CDR database password. Con certificado autofirmado, marca Accept this certificate (Aceptar este certificado). Guarda.

Paso 3: prueba, asigna extensiones y activa

1. Pulsa Test connection (Probar la conexión). Espera "The PBX answered over AJAM." (La centralita respondió por AJAM) y "A recording source is configured." (Hay una fuente de grabaciones) o una indicación.
2. Las extensiones no se importan. Escribe cada una y elige en Belongs to (Pertenece a) la persona. Para un grupo, añade a todos con Add person (Añadir persona).
3. Pulsa Enable (Activar) y haz una llamada de prueba.

Qué pasa después de conectar

• Llamadas entrantes: OPS lee los eventos de Asterisk en intervalos cortos. Abajo a la derecha ves quién llama, con botones para abrir el contacto o la empresa, crear un ticket con el número o añadirlo como contacto. Una llamada transferida sigue siendo una llamada.
• Clic para llamar: con extensión propia (no un grupo) suena primero tu teléfono y luego el cliente. Después anotas el resultado.
• Registro: cada llamada va a la línea de tiempo del CRM del contacto y la empresa, vinculada a la oportunidad abierta más reciente. No a tickets. Los números desconocidos van a una lista aparte; OPS nunca crea contactos solo.
• Llamadas perdidas: aviso a quien sonó su teléfono o, si no, al responsable de la oportunidad.
• Grabaciones: se descargan tras la llamada, se asocian a la llamada correcta y se escuchan en OPS, con registro de escuchas. Las perdidas no se descargan.
• Conciliación: con base CDR, OPS completa cada noche.

Conviene saber

• Solo HTTPS: OPS nunca envía credenciales manager por HTTP simple.
• OPS descarga grabaciones solo desde una carpeta HTTPS.
• OPS inicia las llamadas salientes en el contexto from-internal.
• Grabar en dos canales duplica el disco, pero permite que los resúmenes de llamada separen llamante y agente. Los resúmenes están desactivados por defecto (ajustes de IA) y consumen créditos de IA.
• OPS no borra grabaciones de tu Asterisk. El secreto manager no se puede leer tras guardarlo.

Solución de problemas

• "The base URL is not HTTPS." (La URL base no es HTTPS.) Pon AJAM detrás de TLS.
• "The PBX did not answer over AJAM: …" (La centralita no respondió por AJAM.) Revisa el usuario manager, su línea permit y el puerto abierto a OPS.
• "No recording source is configured." (No hay fuente de grabaciones.) Sirve la carpeta monitor por HTTPS protegido y aplica el fragmento de dialplan.
• Sin grabaciones ni errores: revisa los nombres de archivo del dialplan.

Empieza ya

Empieza gratis. Descubre también las integraciones europeas de OPS y ventas y facturación.