Ir al contenido
Documentación de Connecto
connecto.lat
Guía de usuarioCall center y telefonía

Proveedor externo

Para qué sirve#

Es una conexión opcional con la API de un proveedor de telefonía externo. Sirve para dos cosas: hacer el clic a clic (el proveedor llama primero al asesor y luego al contacto) y recibir los eventos de llamadas del proveedor para registrarlos en el historial.

No necesitas completar este formulario para llamar. Hoy las llamadas funcionan con la telefonía propia: las extensiones de tu proveedor de telefonía conectadas en Servidor y líneas y Extensiones, con el softphone del navegador. Ver Servidor y líneas.

Quién puede usarlo y cómo llegar#

  • Quién: solo administradores.
  • Cómo llegar: Configuración → Telefonía y llamadas → pestaña Proveedor externo. El módulo Call center debe estar encendido (si no: «El módulo Call center está desactivado. Actívalo en Preferencias para configurarlo.»).

El formulario#

Un interruptor a la derecha del título muestra u oculta el formulario. Apagarlo solo lo oculta: no borra los datos guardados. Arranca encendido solo si ya hay un proveedor guardado.

CampoQué haceValores
ProveedorCuál proveedor externo es.«Elige un proveedor…», Zadarma, Asterisk / FreePBX, 3CX, Twilio, Otro proveedor.
Servidor o URLDirección del proveedor.Hasta 200 caracteres. Ej. pbx.miempresa.com.
Puerto1 a 65535 (ej. 5038).
Usuario o Account IDHasta 200 caracteres.
Contraseña o tokenSe guarda cifrada. Si ya hay una guardada, el campo dice «Guardada — escribe una nueva para cambiarla».Hasta 500 caracteres.
Dominio SIP (opcional)Hasta 200 caracteres.
Probar conexiónComprueba que los datos sean válidos.Ver abajo.

Se guarda solo al cambiar un campo (aviso «Cambios guardados»). Mientras no elijas proveedor no se guarda nada; si intentas guardar con un proveedor no válido: «Elige un proveedor.». Puerto fuera de rango: «El puerto debe estar entre 1 y 65535.».

Zadarma (ejemplo de proveedor externo)#

Zadarma es solo un ejemplo de proveedor externo opcional; no es el proveedor que usa la telefonía de tu empresa. Es el único para el que hoy existe integración completa (clic a clic, prueba de conexión y recepción de eventos).

Al elegir Zadarma aparece una ayuda: en «Usuario o Account ID» escribe tu API key y en «Contraseña o token» tu API secret (se obtienen en el panel de Zadarma → Ajustes → Integraciones y API). Luego, en el panel de Zadarma, en Notificaciones, registra la dirección que Connecto te muestra en pantalla (termina en /api/llamadas_webhook.php) para recibir los eventos de llamadas entrantes y salientes.

Probar conexión#

  • Con Zadarma: consulta el saldo de la cuenta (no genera llamadas ni cambios). Resultado: «Conexión correcta con Zadarma (saldo: …).» o «Zadarma no aceptó los datos: ….». Si faltan datos: «Completa el API key y el API secret de tu cuenta de Zadarma para probar.».
  • Con otro proveedor: «La prueba automática solo existe para los proveedores externos compatibles (por ahora Zadarma); con este proveedor la conexión se comprueba al recibir la primera llamada.».
  • Sin proveedor: «Elige primero un proveedor.».

Qué hace la conexión#

FunciónCómo funciona
Clic a clicSe activa eligiendo «Clic a clic del proveedor externo» en Cómo se marca. Al pulsar Llamar, el proveedor llama primero a la extensión del asesor y, cuando contesta, marca al contacto. Requiere un proveedor compatible configurado y que el asesor tenga extensión; si no, se le muestra el número para marcar a mano.
Eventos de llamadasEl proveedor avisa a Connecto de cada llamada (inicio, respuesta y fin). Connecto las registra en el historial verificando la firma del proveedor; si no hay módulo, proveedor o firma válida, no se registra nada.
Solo Zadarma tiene integración hoy. Los demás proveedores de la lista (Asterisk / FreePBX, 3CX, Twilio, Otro) permiten guardar los datos, pero no tienen clic a clic ni recepción de eventos. Sin verificar: no se confirmó ninguna otra función para ellos en el código.

<!-- Fuente: tenant-app/views/partials/cfg_callcenter.php, tenant-app/views/partials/cfg_preferencias_post.php, tenant-app/public/api/llamadas_webhook.php, shared/src/Core/TelefoniaZadarma.php, shared/src/Core/CallMarcacion.php, shared/src/Core/Llamadas.php -->

¿Te fue útil esta página?
Última actualización: 14/11/2026