Conectar 3CX
Conecta tu sistema telefónico 3CX con EspoCRM para identificar a quien llama, registrar llamadas, el botón Llamar, las grabaciones y la ventana emergente.
Con 3CX, el enrutamiento, las colas, el buzón de voz y los horarios siguen en 3CX. EspoCRM agrega:
- Quién llama en la app de 3CX: nombre, empresa y un enlace al registro en EspoCRM.
- Registro de llamadas: al terminar una llamada, se registra una Llamada en el Contacto, Cliente potencial o Cuenta (entrante, perdida, saliente o no contestada, con su duración), asignada al usuario de esa extensión de 3CX. Quien llama y no está en el CRM no se registra.
- Botón Llamar: abre el marcador del cliente web de 3CX o la app de 3CX.
- Con el cliente de API de 3CX (abajo): grabaciones que se escuchan en EspoCRM y la ventana emergente al sonar.
En EspoCRM
- Abre Administración → Integraciones → S+M EspoCRM VOIP · 3CX, marca la casilla para activarla y completa Dirección de
3CX (por ejemplo
https://tuempresa.3cx.us). En El botón Llamar abre, elige Cliente web de 3CX o App de 3CX (enlaces tel:). Si quieres, elige quién recibe las llamadas perdidas sin usuario asignado. Guarda. - Abre Administración → S+M EspoCRM VOIP → Plantilla de 3CX. Se descarga
SMEspoCRMVOIP.xmlcon las direcciones y el secreto de este CRM ya completos. - Para cada persona, completa Extensión 3CX en su Usuario (por ejemplo
101).
Advertencia
Mantén el archivo de plantilla en privado: contiene el secreto que permite a 3CX consultar tu CRM.
En la consola de administración de 3CX
Las pantallas de 3CX se indican con sus nombres en inglés.
- Abre Integrations → CRM y anota lo que está seleccionado hoy, para poder volver atrás.
- Elige Add Template y sube el archivo. Conserva su nombre
SMEspoCRMVOIP.xml: 3CX rechaza nombres con espacios, guiones, "+" o "(1)". - En la lista de CRM, elige SMEspoCRMVOIP. Las direcciones y el secreto ya están completos. Deja activado Enable Call Journaling y activa Always query. Guarda.
- Usa TEST con un número que esté en el CRM: debería mostrar el nombre.
3CX tiene una sola conexión de CRM para todo el sistema: desde ahora, sus llamadas se registran en este CRM. Para volver atrás, elige allí el CRM anterior.
Grabaciones y ventana emergente (opcional)
Necesitan un cliente de API de 3CX.
- En la consola de 3CX, abre Integrations → API y elige Add. Client ID: por ejemplo
espocrm. - Marca XAPI Access: Department DEFAULT, Role Owner (con otros roles no se pueden leer el historial de llamadas ni las grabaciones).
- Marca 3CX Call Control API Access y agrega las extensiones de los agentes (no los números DID).
- Guarda y copia la clave de API; 3CX la muestra una sola vez.
- En la configuración de 3CX en EspoCRM, completa Client ID de la API de 3CX (grabaciones, llamadas en vivo) y Clave de la API de 3CX (secreto). Guarda.
- Abre Prueba de búsqueda 3CX y elige Test the 3CX API.
Las grabaciones se quedan en 3CX: EspoCRM las reproduce después de comprobar que el usuario puede ver esa Llamada, y no guarda nada.
Prueba
- Llama desde un número que esté en el CRM, contesta en 3CX y cuelga: aparece una "llamada entrante" realizada en el registro, asignada al usuario de esa extensión.
- Llama otra vez y no contestes: se registra una "llamada perdida" y el usuario recibe un aviso. Las llamadas que solo llegaron a una recepcionista, un grupo de timbrado o una cola también se registran como perdidas.
Cambia el secreto
Vacía Secreto para 3CX en la configuración de 3CX en EspoCRM, guarda, descarga de nuevo la plantilla y súbela a 3CX. Si vuelves a descargar la plantilla sin vaciarlo, se conserva el mismo secreto.
Si la búsqueda no funciona, consulta Solución de problemas.