Aprende mokapen

3CX

3CX conecta la centralita a Mokapen para el popup del contacto, el diario de llamadas y, si lo configuras, el click-to-call. Mokapen no se convierte en la centralita: genera una API key y una plantilla XML que cargas en el admin 3CX. Desde ahí 3CX pregunta a Mokapen quién es el número, y Mokapen puede escribir la nota de llamada en el contacto o la empresa.

Panorámica: Integraciones.

Requisitos

• Una instalación 3CX en la que puedas abrir Admin → Integrations → CRM y cargar una plantilla.
• Plan Mokapen Medium.
• Para el click-to-call, además: plan 3CX con Call Control / WebAPI (Enterprise), un host 3CX alcanzable desde Mokapen, y un interno mapeado al usuario que hace clic.

API key y plantilla

Menú de usuario → Integraciones → 3CX. Mokapen muestra la API key a usar en la plantilla CRM: como nombre de usuario de la Basic auth, o en la cabecera X-Api-Key. Descarga la plantilla XML. La clave ya está insertada como valor predeterminado. Cárgala en 3CX Admin → Integrations → CRM.

En página también encuentras la URL base de las API CRM: es la dirección que llama la plantilla. Si 3CX está detrás de una red que no alcanza Mokapen, el popup no se abre aunque la plantilla esté cargada.

Puedes regenerar la clave al guardar. La anterior deja de valer: hay que recargar la plantilla, o actualizar la clave ya pegada en 3CX. Dejar la clave antigua en la centralita produce errores de autenticación, no una segunda conexión.

Notas de llamada y click-to-call

Dos interruptores deciden el comportamiento hacia la agenda:

• Guardar notas de llamada en contactos y empresas — al final de la llamada Mokapen escribe la nota en la ficha encontrada.
• Permitir creación de contactos desde 3CX si el número es desconocido — si el número no está en la agenda, Mokapen crea el contacto. Apágalo si la centralita recibe tráfico genérico (centralita de sede, números de cortesía): de lo contrario cada desconocido se convierte en una ficha.

El click-to-call es aparte. Hacen falta host 3CX (FQDN) y clave WebAPI / Call Control. Sin clave, Mokapen dice que la clave Call Control no está configurada. Sin host, que falta el FQDN. Sin mapeo, la llamada no sabe qué interno hacer sonar.

El mapeo es una fila por persona, en la forma interno=user_id (ejemplo 102=15). Sirve tanto para atribuir la nota de llamada al usuario correcto como para el click-to-call. Si tu usuario no tiene una fila, Mokapen dice que no hay un interno mapeado. El clic normal llama con 3CX; Mayús, Ctrl o Alt junto con el clic abre el marcador del dispositivo.

Si 3CX rechaza la solicitud, comprueba en este orden FQDN, clave Call Control e interno. El mensaje en página es que 3CX no ha aceptado la llamada.

Cuándo el popup no sale

• La plantilla no se ha cargado, o se cargó antes de regenerar la clave.
• El número entrante no coincide con un teléfono de la agenda y la creación automática está apagada. El popup no tiene ficha que abrir.
• Buscas la videollamada de la cita. 3CX no pone Meet o Teams en la ficha de cita.