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.
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.
| Campo | Qué hace | Valores |
|---|---|---|
| Proveedor | Cuál proveedor externo es. | «Elige un proveedor…», Zadarma, Asterisk / FreePBX, 3CX, Twilio, Otro proveedor. |
| Servidor o URL | Dirección del proveedor. | Hasta 200 caracteres. Ej. pbx.miempresa.com. |
| Puerto | 1 a 65535 (ej. 5038). | |
| Usuario o Account ID | Hasta 200 caracteres. | |
| Contraseña o token | Se 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ón | Comprueba 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ón | Cómo funciona |
|---|---|
| Clic a clic | Se 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 llamadas | El 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. |
<!-- 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 -->