Health Check Monitor es una herramienta de diagnóstico integrada que comprueba automáticamente si existen problemas habituales de configuración incorrecta en tu organización de Salesforce con la integración de Aircall. Es de solo lectura: no se escribe ni modifica nada en tu organización. Los resultados aparecen al instante y se pueden exportar como CSV.
Úsala cuando configures la integración de Aircall por primera vez, después de actualizar un paquete o al solucionar problemas como campos que no se rellenan o llamadas que no se registran.
IMPORTANTE: Health Check Monitor solo está disponible en Salesforce Lightning. No está disponible en Salesforce Classic.
Quién debe ejecutarla
Administradores de Salesforce o cualquier otro Usuario de Salesforce con permisos responsable de configurar o mantener la integración Aircall<>Salesforce en tu organización.
Qué comprueba
El monitor realiza comprobaciones en tres categorías:
Instalación del paquete: verifica que el paquete de Aircall esté instalado correctamente, que todos los componentes necesarios estén presentes y que la configuración de sitios remotos esté establecida.
Permisos de usuario: verifica que el usuario de la integración tenga acceso a la API, los permisos CRUD correctos en los objetos necesarios, el conjunto de permisos requerido asignado y el permiso Ver todo en los objetos clave.
Seguridad a nivel de campo: verifica que el usuario de la integración pueda leer y escribir en todos los campos obligatorios de Aircall de los objetos clave.
NOTA: Está previsto añadir más categorías de comprobación en futuras versiones, como Accesibilidad de endpoints de Apex, Datos y flujos, Configuración de CTI y voz y Conectividad. Actualmente, el monitor solo cubre la integración V3/CTI. Está previsto incorporar soporte para Service Cloud Voice (SFV) en una fase futura.
Configurar Health Check Monitor
Una vez instalado el paquete de Aircall, se requieren dos pasos manuales para que la pestaña Health Check esté disponible en tu aplicación Lightning.
Paso 1: Añadir la pestaña Health Check a tu aplicación Lightning
Pasos
- Ve a Configuración > Gestor de aplicaciones.
- Busca tu aplicación Lightning y haz clic en Editar.
- Ve a Elementos de navegación y añade la pestaña Health Check.
- Guarda los cambios.
Paso 2: Establecer la pestaña como Activada de forma predeterminada para el perfil Administrador del sistema
Pasos
- Ve a Configuración > Perfiles.
- Abre el perfil Administrador del sistema.
- Ve a Configuración de pestañas personalizadas.
- Busca aircallHealthCheckDashboard y establécela como Activada de forma predeterminada.
- Guarda los cambios.
Ejecutar Health Check
Pasos
- Ve a la pestaña Health Check de tu aplicación Lightning.
- Haz clic en Ejecutar Health Check de V3.
- Los resultados aparecen en la misma página. Expande cada categoría para ver los detalles de cada comprobación.
En la esquina superior derecha, el Panel de control muestra el nombre, el rol, el correo electrónico y el perfil del usuario que está ejecutando la comprobación. Antes de ejecutarla, confirma que has iniciado sesión como el usuario correcto, ya que las comprobaciones reflejan los permisos del usuario que las ejecuta.
NOTA: Los resultados no se almacenan y desaparecen al actualizar la página. Usa el botón Descargar informe para exportar todos los resultados como CSV antes de cerrar o actualizar la página.
Comprender los resultados
Cada comprobación devuelve uno de estos tres estados:
| Estado | Qué significa | Qué hacer |
|---|---|---|
| CORRECTO | La comprobación se ha superado; no se requiere ninguna acción. | Nada. |
| ERROR | Se ha detectado una configuración incorrecta. | Expande la fila para ver el mensaje de error, los pasos para solucionarlo y un enlace a la documentación correspondiente. |
| ADVERTENCIA | Es informativo, no se trata de un error, pero conviene revisarlo. | Revisa los detalles que aparecen en la fila de la comprobación. |
Cuando una comprobación falle, expande la fila correspondiente para ver qué ha ocurrido y cómo solucionarlo. Cada comprobación fallida incluye un mensaje de error, pasos específicos para solucionarlo y un enlace a la documentación correspondiente.
Solucionar problemas habituales
Los campos no se rellenan en los registros de Salesforce
Los campos afectados incluyen SMS, Resolución de llamadas, Información de IA, Grabación de llamadas y Etiquetas.
Causa probable: falta seguridad a nivel de campo (FLS) en los campos de Aircall para el usuario de la integración.
Pasos
- Ejecuta Health Check y busca errores en la categoría Seguridad de campos.
- Asigna AirCall_PermissionSet al usuario de la integración. Esto concede FLS de lectura y escritura en todos los campos obligatorios de Aircall.
- Si el conjunto de permisos ya está asignado, verifica que esté asignado a un usuario activo.
La configuración del usuario de la integración falla o las llamadas no se registran
Causa probable: falta el permiso API activada o el acceso CRUD es insuficiente en los objetos necesarios (Tarea, Contacto, Cliente potencial, Cuenta, Caso, Oportunidad).
Pasos
- Ejecuta Health Check y busca errores en la categoría Permisos de usuario.
- Asigna AirCall_PermissionSet y confirma que API activada esté establecida en el perfil del usuario.
- Si solo los usuarios inactivos tienen el conjunto de permisos, reasígnalo al usuario activo de la integración.
La actualización del paquete falla con el «Error de permiso de objeto de IA»
Causa probable: AirCall_PermissionSet está asignado a un usuario con licencia de invitado. Salesforce bloquea las actualizaciones de paquetes en este estado.
Pasos
- Ejecuta la comprobación de estado y busca errores en la categoría Instalación del paquete.
- Ve a Configuración > Conjuntos de permisos > AirCall_PermissionSet > Gestionar asignaciones.
- Elimina de la asignación a todos los usuarios con licencia de invitado.
- Vuelve a intentar actualizar el paquete.
Preguntas frecuentes
¿La comprobación de estado realiza algún cambio en mi organización?
No. Es completamente de solo lectura. No se escriben ni modifican datos.
¿Cuánto tarda en ejecutarse?
Unos segundos.
¿Qué permisos refleja la comprobación?
La comprobación refleja los permisos del usuario que la está ejecutando, no los permisos del usuario de la integración. Asegúrate de ejecutar la comprobación con el usuario correcto. El nombre, el rol, el correo electrónico y el perfil del usuario que la ejecuta aparecen en la esquina superior derecha del Panel de control.
¿Qué integración abarca?
Actualmente, solo V3/CTI. Está previsto añadir compatibilidad con Service Cloud Voice (SFV) en una fase futura.
¿Qué debo hacer si una comprobación falla?
Despliega la fila de la comprobación fallida. Muestra el mensaje de error, qué debes corregir y un enlace a la documentación correspondiente. Para consultar situaciones de error habituales, consulta la sección «Solución de problemas habituales» anterior.
Si necesitas contactar con el soporte de Aircall
Si has ejecutado la comprobación de estado y no puedes resolver el problema, recopila lo siguiente antes de contactar con el soporte de Aircall:
- La exportación CSV de la comprobación de estado (haz clic en Descargar informe).
- El ID de tu organización de Salesforce.
- La versión del paquete de Aircall (que aparece en la comprobación de advertencia sobre la versión del paquete).
- El nombre del perfil del usuario que ejecuta la comprobación (que aparece en el cuadro de información del usuario situado en la esquina superior derecha).
- Una captura de pantalla de todas las comprobaciones fallidas.
Para obtener los registros de depuración de Salesforce, ve a Configuración > Registros de depuración y captura un registro de ejecución de Apex mientras ejecutas la comprobación de estado. Si está disponible, inclúyelo en tu ticket de soporte.