Para usar la telefonía de Verimor en Mavibot, necesitas obtener una clave API de tu cuenta de Verimor e ingresarla en la configuración de la integración.

Verimor es un proveedor de telecomunicaciones turco. Su producto Bulut Santralim es una centralita en la nube: los empleados trabajan con extensiones internas y las llamadas se enrutan a través de esas extensiones.

El bot puede conectar a un empleado con un cliente, transferir y finalizar llamadas, recuperar grabaciones y enviar eventos de llamada a la conversación.

Obtención de los datos necesarios

  1. Activa el servicio Bulut Santralim con Verimor y crea extensiones internas para tus empleados.
  2. Abre Online İşlem Merkezi → Bulut Santralim → Santral Ayarlarım y copia la clave API. Se ve así:
K12345678-1234-5678-4321-123456789012
  1. Anota las extensiones internas de los empleados. Las necesitarás para especificarlas en la configuración de acceso.

La clave API se comparte en toda la centralita y se usa tanto para llamadas como para recibir eventos. Si la regeneras en el panel de Verimor, asegúrate de guardar nuevamente el formulario de conexión. De lo contrario, tanto las llamadas como los eventos de conversación dejarán de funcionar.

Conexión

En la pestaña de telefonía, selecciona Verimor e ingresa:

  • Clave API — la clave de la sección Santral Ayarlarım.
  • Número saliente — el número externo que verá el cliente, en el formato 908505320000. Este campo es opcional. Si se deja vacío, se usará el número asignado a la extensión interna del empleado.

La integración ahora está conectada.

Para desconectar la integración, limpia el campo Clave API y guarda la configuración.

No necesitas configurar la URL de notificación manualmente. Mavibot la establece automáticamente en tu centralita cuando se guarda la clave API.

Empleados

En la configuración del empleado, completa la extensión interna (dahili) del empleado — generalmente de 3 a 4 dígitos, por ejemplo 1001.

Ingresa la extensión interna de la centralita, no el número de teléfono móvil del empleado. Sin ella, el botón de llamada en la tarjeta del cliente no funcionará para ese empleado.

Llamada desde la tarjeta del cliente

Aparecerá un botón de llamada junto al número de teléfono del cliente en la tarjeta de conversación.

La centralita primero llama a la extensión interna del empleado. Solo después de que el empleado conteste, llama al cliente.

Este orden es intencional: el cliente no escuchará silencio en la línea porque el empleado ya está conectado cuando el teléfono del cliente comienza a sonar.

Funciones de la calculadora

Llamada de empleado a cliente

verimor_employee_call(client_phone, employee_extension, caller_id)

Parámetros:

  • client_phone — el número de teléfono del cliente. Obligatorio. Usa el formato turco 908505320000, o 00493027590915 para llamadas internacionales.
  • employee_extension — la extensión interna del empleado cuyo teléfono sonará. Obligatorio.
  • caller_id — el número que verá el cliente. Opcional. Si se omite, se usa el número saliente de la configuración de conexión.

La función devuelve call_uuid — el identificador de la llamada. También se guarda en la variable verimor_call_uuid.

Transferir llamada

verimor_transfer_call(employee_extension, call_uuid)

Transfiere la llamada actual a otra extensión interna.

Parámetros:

  • employee_extension — la extensión interna a la que se transferirá la llamada. Obligatorio.
  • call_uuid — el identificador de la llamada. Opcional. Si se omite, se usa la llamada más reciente del cliente.

Finalizar llamada

verimor_hangup_call(call_uuid)

Parámetros:

  • call_uuid — el identificador de la llamada. Opcional. Si se omite, se usa la llamada más reciente del cliente.

Obtener enlace de grabación de llamada

verimor_get_record_link(call_uuid)

Solicita un enlace nuevo a la grabación de la llamada.

Parámetros:

  • call_uuid — el identificador de la llamada. Opcional. Si se omite, se usa la llamada más reciente del cliente.

Callbacks durante una llamada

A medida que avanza la llamada, se envían callbacks a la conversación en el siguiente formato:

verimor_call_event answer

Posibles eventos:

Evento Cuándo se activa
ringing La llamada está sonando
answer La llamada ha sido contestada
hangup La llamada ha finalizado
user_hangup El empleado finalizó la llamada

Las llamadas entre empleados no aparecen en la conversación.

Un escenario típico de "sin respuesta → enviar un mensaje en el messenger" se puede activar con hangup y verificando la variable verimor_call_answered.

Variables del cliente después de una llamada

Variable Valor
verimor_call_uuid Identificador de la llamada
verimor_call_direction Dirección: inbound — el cliente te llama, outbound — tú llamas al cliente
verimor_call_extension Extensión interna del empleado que gestionó la llamada
verimor_call_duration Duración de la llamada en segundos
verimor_call_answered 1 — la llamada fue contestada, 0 — no fue contestada
verimor_hangup_cause Código que indica por qué finalizó la llamada
verimor_has_record 1 — existe una grabación, 0 — no existe grabación
verimor_record_link Enlace a la grabación de la llamada después de llamar a verimor_get_record_link()

Códigos de causa de finalización

Los valores más comunes de verimor_hangup_cause son:

Código Significado
NORMAL_CLEARING La llamada se completó y finalizó normalmente
USER_BUSY Ocupado
NO_ANSWER Sin respuesta
ORIGINATOR_CANCEL El llamante colgó antes de que se contestara la llamada
CALL_REJECTED La llamada fue rechazada
UNALLOCATED_NUMBER Número inválido
NO_USER_RESPONSE El suscriptor no está disponible
NOT_ALLOWED_BY_IYS Sin permiso en İYS, el registro de consentimiento turco para llamadas comerciales

Grabaciones de llamadas

La grabación de llamadas debe estar habilitada en la configuración de tu centralita Verimor. Las grabaciones se almacenan en tu cuenta de Verimor.

⏳ Los enlaces de grabación permanecen válidos durante 60 minutos desde el momento en que se solicitan. Después, dejan de funcionar. Verimor también permite un máximo de cinco solicitudes de enlace de grabación por minuto por clave API.

Qué significa esto:

  • La variable verimor_record_link no se completa automáticamente. Primero debes llamar a verimor_get_record_link().
  • En un escenario que envía una grabación, llama a verimor_get_record_link() en el momento en que se envía la grabación, no con antelación.
  • Verifica verimor_has_record primero para no desperdiciar el límite de solicitudes en llamadas que no tienen grabación.
  • Si necesitas conservar una grabación permanentemente, guarda el archivo en tu propio almacenamiento inmediatamente después de la llamada.
  • El archivo de grabaciones permanece disponible en el panel de Verimor, donde las grabaciones se pueden reproducir y descargar más tarde.

La grabación de llamadas está regulada por la ley. En Turquía, está sujeta a los requisitos de KVKK: el cliente debe ser informado sobre la grabación, y el almacenamiento de datos personales debe tener una base legal. El propietario de la cuenta de Verimor es responsable de cumplir con los requisitos aplicables.

Solución de problemas

Error Causa / Solución
Gecersiz anahtar Clave API inválida. Obtén la clave actual de la sección Santral Ayarlarım.
extension 1005 not found La extensión interna no existe en tu centralita. Asegúrate de que la configuración del empleado contenga un dahili existente.
"Verimor internal extension is not specified" La configuración del empleado está vacía o contiene un número de teléfono móvil en lugar de una extensión interna.
Las llamadas funcionan, pero no aparecen callbacks en la conversación La URL de notificación no fue configurada. Guarda nuevamente el formulario de conexión.
Las llamadas dejaron de funcionar después de cambiar la clave API La clave fue regenerada en el panel de Verimor. Ingresa la nueva clave en el formulario de conexión y guárdala.
El enlace de grabación no se abre El enlace ha caducado. Solicita uno nuevo con verimor_get_record_link() o abre la grabación en el panel de Verimor.
El enlace de grabación no se devuelve Se ha alcanzado el límite de cinco solicitudes por minuto, o la llamada no tiene grabación. Verifica verimor_has_record.