Importante: Actualmente, este artículo es compatible con las pruebas Beta de la experiencia unificada de CTI v3 para clientes que usan únicamente Aircall Salesforce CTI v3 (sin el paquete Sales Engagement v4 instalado).
Esta guía está dirigida a administradores de Salesforce cuya organización ya usa la integración Aircall Salesforce CTI (v3) y ahora va a pasar al CTI v3 con el objeto Aircall Log (ALO) actualizado.
En este modelo actualizado:
- Tu integración existente de CTI v3 sigue gestionando las llamadas
- El nuevo objeto Aircall Log (ALO) se convierte en el objeto dedicado para almacenar actividad enriquecida de Aircall en Salesforce
- Puedes usar Task + ALO (predeterminado) o cambiar a Only ALO para el registro
Consejo: No omitas ningún paso de configuración de esta guía. Aquí se incluyen todos los pasos de las instrucciones de configuración internas porque son obligatorios o muy recomendables para una configuración correcta.
Nota: Debido a cambios en el despliegue, Aircall envía a los clientes la actualización del paquete CTI v3. De forma predeterminada, el registro está configurado como Task + objeto Aircall Log. Tú eres principalmente responsable de la configuración en Salesforce: diseño de ALO, configuración de Task, configuración opcional de Sales Engagement y actualización de cualquier automatización o informe si decides dejar de usar el registro basado en Task.
Antes de empezar
Asegúrate de que:
- Eres Administrador del sistema de Salesforce o tienes permisos equivalentes
- Tienes acceso a tu organización de Salesforce y al Panel de control de Aircall
En esta guía harás lo siguiente:
- Revisar el comportamiento de actualización del paquete y confirmar la actualización de CTI v3
- Asignar AirCall_PermissionSet
- Configurar el diseño del objeto Aircall Log (ALO)
- Actualizar la configuración de Task para la nueva relación Task ↔ ALO
- Confirmar o ajustar el comportamiento del registro de llamadas en el Panel de control de Aircall
- Actualizar automatizaciones e informes si cambias a Only ALO
- Revisar cómo aparecerá la nueva opción de registro en el Panel de control de Aircall una vez que esté habilitada para tu empresaejecutar comprobaciones posteriores a la migración
- (Opcional) Configurar Sales Engagement para CTI v3
Nota: La nueva opción de registro en el Panel de control de Aircall no está disponible de inmediato para todos los clientes. Aircall puede habilitarla antes para empresas específicas, o estará disponible como parte del lanzamiento general. Mientras tanto, usa este artículo para revisar los cambios y preparar tu configuración de Salesforce.
Qué está cambiando
Acerca del objeto Aircall Log (ALO)
El objeto Aircall Log es un nuevo objeto dedicado de Salesforce diseñado para almacenar la actividad de Aircall de forma estructurada y escalable.
Anteriormente, el registro de CTI v3 dependía principalmente del objeto Salesforce Task, lo que puede ser limitante si necesitas:
- Datos de llamada más completos (por ejemplo, información de mensaje, AI y IVR)
- Mayor flexibilidad en el registro de llamadas
- Informes y análisis más sólidos
Con ALO:
- Las interacciones de Aircall se registran en un objeto diseñado específicamente para este fin
- La calidad de los datos mejora y Salesforce se convierte en un sistema de registro más sólido para la actividad de Aircall
¿Qué cambia con el registro de llamadas?
Después de la actualización:
- Los usuarios de CTI v3 tienen acceso al objeto Aircall Log (ALO) para el registro de llamadas en Salesforce
- El registro de llamadas se puede configurar para:
- Task + objeto Aircall Log (predeterminado), o
- Only Aircall Log object
Para obtener más información sobre ALO, consulta nuestro artículo Aircall Log Object (ALO)
Nota: De forma predeterminada, la actualización configura el registro como Task + objeto Aircall Log. Solo necesitas cambiar esto si intencionadamente quieres registrar en Only Aircall Log object.
Para los clientes que solo usan v3, no se desinstala ningún paquete. Los registros de Task existentes permanecen en su lugar. Estás mejorando tu configuración actual de CTI v3 al añadir ALO y las nuevas opciones de registro.
Paso 1. Verificar la versión instalada: CTI v3
Aircall ejecuta automáticamente la actualización por ti. Una vez completada la actualización, deberás verificar la versión instalada:
Pasos:
- En Salesforce, ve a Setup > Installed Packages.
- Localiza Aircall CTI for Salesforce.
- Confirma que Version Name es 2.26 (o la versión especificada por Aircall para este despliegue).
Nota: Si estás haciendo pruebas en un sandbox, completa primero la actualización allí para poder validar los diseños y el registro antes de cambiar la producción. Para más detalles, consulta el artículo How to configure your Aircall CTI in Salesforce Lightning.
Establecer permisos para Aircall CTI
Aircall CTI necesita acceso de lectura a objetos estándar clave (Account, Contact, Lead, Opportunity y Case) para realizar la búsqueda de contactos y mostrar el registro correcto cuando entra una llamada.
Para simplificar la configuración, el paquete incluye un conjunto de permisos Aircall que puedes clonar y ajustar si necesitas un acceso más amplio (por ejemplo, View All en objetos específicos).
Paso 1: Asignar el conjunto de permisos de Aircall (obligatorio)
- En Setup de Salesforce, busca Permission Sets en el cuadro Quick Find.
- Localiza el conjunto de permisos AirCall_PermissionSet y asígnalo a todos los usuarios de CTI.
Nota: Debido a que el conjunto de permisos AirCall_PermissionSet está gestionado, no puedes cambiar estos permisos. Para actualizar cualquier permiso, clona el conjunto de permisos y asígnalo a los usuarios correspondientes.
Cualquier permiso nuevo que Aircall cree en nuevas versiones solo estará disponible en el conjunto de permisos original AirCall_PermissionSet. Se recomienda encarecidamente conceder a los usuarios tanto el conjunto de permisos de Aircall proporcionado como la versión clonada.
Paso 2: Clonar y asignar el conjunto de permisos de Aircall (opcional)
- Localiza el conjunto de permisos AirCall_PermissionSet y luego haz clic en Clone.
- Asigna al conjunto de permisos clonado un nombre descriptivo (por ejemplo, Aircall CTI View All) y luego haz clic en Save.
- En el conjunto de permisos clonado, ve a Object Settings.
- Para cada uno de los objetos Account, Contact, Lead, Case y Opportunity, revisa y ajusta el acceso según sea necesario (por ejemplo, habilita View All si tu modelo de seguridad lo permite).
- Asigna el conjunto de permisos clonado (y el conjunto de permisos base de Aircall CTI) a los usuarios que necesitan acceso a CTI:
- En Setup, busca Users.
- Abre el registro del usuario.
- En Permission Set Assignments, haz clic en Edit Assignments.
- Añade los conjuntos de permisos de Aircall CTI correspondientes y haz clic en Save.
Paso 2. Configurar el objeto Aircall Log (ALO)
Este paso incluye tanto la configuración obligatoria de permisos de CTI como la configuración del diseño de ALO.
2.1 Establecer permisos para Aircall CTI
Aircall CTI necesita acceso de lectura a objetos estándar clave de Salesforce, como Account, Contact, Lead, Opportunity y Case. Esto permite que el CTI busque contactos y muestre el registro correcto cuando entra una llamada.
Para simplificar la configuración, el paquete incluye un conjunto de permisos AirCall_PermissionSet. También puedes clonarlo si necesitas un acceso más amplio.
Paso 1: Asignar el conjunto de permisos de Aircall (obligatorio)
- En Setup de Salesforce, busca Permission Sets en el cuadro Quick Find.
- Localiza el conjunto de permisos AirCall_PermissionSet.
- Asígnalo a todos los usuarios de CTI.
Nota: Como AirCall_PermissionSet es un conjunto de permisos gestionado, no puedes cambiar sus permisos directamente.
Importante: Si quieres ajustar permisos, clona el conjunto de permisos y asigna la versión clonada a los usuarios correspondientes. Cualquier permiso nuevo que Aircall añada en futuras versiones solo se añadirá al AirCall_PermissionSet original. Por este motivo, se recomienda encarecidamente asignar a los usuarios tanto el conjunto de permisos original de Aircall como la versión clonada, si utilizas una.
Paso 2: Clonar y asignar el conjunto de permisos de Aircall (opcional)
- Localiza el conjunto de permisos AirCall_PermissionSet.
- Haz clic en Clone.
- Asigna al conjunto de permisos clonado un nombre descriptivo, por ejemplo Aircall CTI View All, y luego haz clic en Save.
- En el conjunto de permisos clonado, ve a Object Settings.
- Para cada uno de estos objetos, revisa y ajusta el acceso según sea necesario:
- Account
- Contact
- Lead
- Case
- Opportunity
- Si tu modelo de seguridad lo permite, habilita un acceso más amplio como View All donde sea necesario.
- Asigna el conjunto de permisos clonado y el AirCall_PermissionSet base a los usuarios que necesitan acceso a CTI:
- En Setup, busca Users
- Abre el registro del usuario
- En Permission Set Assignments, haz clic en Edit Assignments
- Añade los conjuntos de permisos de Aircall CTI correspondientes
- Haz clic en Save
2.2 Actualizar el diseño de página de ALO
Puedes configurar el diseño de página de ALO para adaptarlo a las necesidades de tu empresa y mostrar los campos importantes para los informes y la resolución de problemas.
Pasos:
- En Salesforce, ve a Setup.
- Haz clic en Object Manager.
- Busca Aircall Log.
- Haz clic en Page Layouts.
- Edita el diseño existente.
- Añade o reorganiza campos según sea necesario, como por ejemplo:
- Detalles de la llamada (dirección, duración, resultado)
- Campos relacionados con mensajes (si registras SMS o mensajes)
- Campos relacionados con AI (resúmenes, temas)
- Campos relacionados con IVR
- (Opcional) Clona el diseño de ALO para crear distintos diseños para distintos equipos o perfiles.
- Haz clic en Save.
Empieza mostrando los campos que tus equipos ya usan en los informes y para la resolución de problemas, luego iter
Paso 3. Actualizar la configuración de Task
Dado que ALO ahora tiene una relación directa con Task, debes asegurarte de que Task esté correctamente configurado para que el registro de CTI funcione como se espera.
3.1. Actualizar la seguridad a nivel de campo (FLS) para Task Type
Para habilitar el campo Type para los perfiles que usarán el registro de CTI:
Pasos:
- En Salesforce, ve a Setup.
- Ve a Object Manager > Task.
- Haz clic en Fields & Relationships.
- Busca el campo Type.
- Edita la seguridad a nivel de campo y establece Visible para los perfiles que usan el registro de CTI.
- Haz clic en Save.
3.2. Añadir el campo Aircall Log a los diseños de página de Task
Esta parte es obligatoria para permitir la vinculación entre Task y ALO.
Pasos:
- Aún en Object Manager, selecciona Task.
- Haz clic en Page Layouts.
- Edita los diseños de Task que se usan para la actividad de llamadas.
- Añade el campo Aircall Log a cada diseño correspondiente.
- Haz clic en Save.
Esto crea una relación clara entre cada Task y su registro ALO correspondiente y es obligatorio en el nuevo modelo de registro Task + ALO.
3.3. Actualizar la referencia de campo en tus flujos de trabajo y diseños de Salesforce
Si tus flujos de trabajo, diseños de página u otras configuraciones de Salesforce hacen referencia al siguiente campo de Task:
- aircall__External_contact_phone_number__c
Tendrás que actualizarlos para usar el nuevo nombre de campo:
- aircall__External_contacts_phone_number__c
Consejo: Ten en cuenta la diferencia: "contacts" en lugar de "contact"
Nota: Lo que debes hacer: busca en tu organización de Salesforce cualquier referencia a aircall__External_contact_phone_number__c —incluidos flujos de trabajo, reglas de validación, diseños de página, informes y código personalizado— y actualízalas para que apunten a aircall__External_contacts_phone_number__c.
Ambos campos de Task seguirán completándose durante un período de transición para darte tiempo a realizar el cambio. El campo antiguo quedará obsoleto en el tercer trimestre, por lo que recomendamos actualizar tus configuraciones lo antes posible.
Paso 4. Actualizar automatizaciones e informes (si usas Only ALO)
Solo necesitas realizar estos cambios si eliges Only Aircall Log object. Si sigues con Task + ALO, tus flujos de trabajo e informes existentes basados en Task pueden seguir funcionando y puedes adoptar ALO de forma gradual.
4.1. Automatizaciones
Si tu equipo tiene flujos de trabajo o informes de Salesforce creados en torno al registro basado en Task y cambias a Only ALO, es posible que debas actualizar:
-
Automatizaciones
- Flows
- Reglas de flujo de trabajo o Process Builder (si aún se usan)
- Triggers
- Cualquier lógica de enrutamiento basada en campos de Task
Acciones a tener en cuenta:
- Identifica todas las automatizaciones que se activan con campos de Task para el registro de llamadas.
- Vuelve a crearlas o ajústalas para que hagan referencia a los campos de Aircall Log cuando uses Only ALO.
4.2. Informes y paneles
Si cambias a Only ALO:
- Actualiza los informes y paneles para usar el objeto Aircall Log en lugar de solo Task
- Recrea los informes basados en Task cuando sea necesario para que lean desde ALO
Consejo: Puedes mantener el registro Task + ALO mientras creas nuevos informes basados en ALO y los validas. Cuando tengas confianza en ellos, podrás cambiar más informes y automatizaciones a ALO.
Para obtener información sobre cómo configurar Sales engagement para CTI V3, consulta Configure Aircall for Salesforce Sales Engagement.
Paso 5. Comportamiento del registro en el Panel de control de Aircall
La nueva opción de registro en el Panel de control de Aircall no está disponible de inmediato para todos los clientes.
Aircall está dando tiempo a los clientes para revisar los cambios y preparar su configuración de Salesforce antes de habilitar esta opción. Esto significa que es posible que aún no veas la configuración, salvo que:
- Aircall la habilite antes para tu empresa, o
- Pase a estar disponible como parte del lanzamiento general
Cuando esta opción esté disponible, controlará si las llamadas se registran en:
- Task + objeto Aircall Log (predeterminado), o
- Only Aircall Log object
Si tienes previsto cambiar a Only Aircall Log object, asegúrate de completar las actualizaciones de automatización e informes descritas en el paso anterior antes de habilitar ese cambio.
Cómo se verá esta configuración
Cuando esté disponible:
Pasos:
- Abre tu Panel de control de Aircall > integraciones & API.
- Busca tu integración de Salesforce v3.
- Selecciónala y abre la pestaña Configuración.
- Busca la sección Salesforce Settings.
- Localiza Call logging should be done on.
- Selecciona una opción:
- Both Task and Aircall Log Object (predeterminado), o
- Only Aircall Log Object
Nota: Si mantienes Task + objeto Aircall Log, tus flujos de trabajo e informes existentes basados en Task
Paso final: activar las funciones de registro
Una vez que hayas completado todos los pasos anteriores, hay dos formas de seguir para activar tus funciones de registro:
- Activación automática: El 18 de mayo de 2026, Aircall habilitará automáticamente las funciones de registro en tu nombre. No se requiere ninguna otra acción por tu parte.
- Activación anticipada: Si quieres que las funciones de registro se habiliten antes de esa fecha, ponte en contacto con el equipo de Soporte de Aircall y un miembro de nuestro equipo te ayudará.
Nota: Si has completado todos los pasos de esta guía y quieres que las funciones de registro se habiliten antes del 18 de mayo de 2026, contacta con nuestro equipo de Customer Support y lo habilitaremos por ti.