El conector de telefonía une Portail ZAPP con el operador de telefonía de la empresa: Ringover, Aircall, 3CX (V20) o Teams Phone. Solo hay un operador activo a la vez. La pantalla está reservada a los administradores; la entrada Telefonía está en el menú Administración › Conectores y automatización.
Sin conector, nada se rompe: los números siguen siendo enlaces que abren la aplicación de llamadas de cada persona. El conector añade, en el CRM, la llamada en un clic, la ficha del interlocutor en la llamada entrante y el registro automático de llamadas (consulta Telefonía en la documentación del CRM).
Preparar las credenciales
Las claves y secretos nunca se escriben en esta pantalla: guárdalos primero en el Almacén de secretos y luego elige su nombre.
| Operador | Lo que necesitas |
|---|---|
| Ringover | una clave de API (Panel › Desarrolladores) con permisos de Llamadas y Usuarios; la región (Europa o Estados Unidos) |
| Aircall | el API ID y el token de API (Integraciones › API Keys); el token del webhook, que Aircall muestra al crearlo |
| 3CX | la dirección HTTPS de la centralita, el ID de cliente y el secreto de una aplicación «Call Control API» (Integraciones › API) |
| Teams Phone | una aplicación de Entra ID: ID del inquilino, ID de cliente, secreto de cliente y el permiso de Microsoft Graph CallRecords.Read.All de tipo Aplicación, con el consentimiento del administrador |
Elige también el país por defecto: sirve para los números introducidos sin prefijo.
Declarar el webhook
Después de guardar, el recuadro Conexión muestra la dirección del webhook. Declárala en el operador:
- Ringover: webhooks de llamada (sonando, contestada, colgada, perdida);
- Aircall: un webhook con los eventos de llamada (
call.created,call.ringing_on_agent,call.answered,call.ended,call.voicemail_left); - 3CX: la integración CRM del servidor. La búsqueda de contacto llama a la dirección con
event=lookup&number=[Number]&agent=[Agent]; el registro de llamadas envíaevent=journal,number,agent,type([CallType]),start([DateTime]) yduration([Duration]).
Teams Phone no usa webhook: las llamadas terminadas se recogen automáticamente cada cinco minutos.
La dirección contiene un token secreto: compártela solo con el operador. Regenerar la dirección crea una nueva, y la antigua deja de funcionar al instante.
Probar la conexión comprueba las credenciales con el operador.
Asociar a los usuarios
En Correspondencia de usuarios, asocia cada cuenta a su identidad en el operador:
- Ringover: su
user_idy su número de Ringover, el que suena en la llamada en un clic; - Aircall: su identificador de usuario de Aircall;
- 3CX: su número de extensión;
- Teams Phone: el Object ID de su cuenta de Entra ID.
Sin correspondencia, una persona no tiene la llamada en un clic y sus llamadas no se registran.
Un número de línea solo se asocia a una cuenta. Un número compartido (centralita) no identifica a nadie: sus llamadas se guardan en el registro técnico, pero no se asignan a ningún comercial.
Lo que permite cada operador
| Llamada en un clic | Ficha al sonar | Registro de llamadas | Transcripción | |
|---|---|---|---|---|
| Ringover | sí | sí | sí | sí (si la llamada está grabada y la IA activada) |
| Aircall | sí | sí | sí | sí (si la llamada está grabada y la IA activada) |
| 3CX | sí | sí | sí | no |
| Teams Phone | no (enlace tel:) |
no | sí, al terminar la llamada | no |
Datos conservados
El conector guarda un registro técnico de las llamadas (para reconocer un envío repetido) durante 30 días por defecto (de 1 a 365 días). Las llamadas en sí se conservan en el CRM, como actividades.