Importante: Este artículo actualmente es compatible con las pruebas Beta de la experiencia unificada de CTI v3 para clientes que utilizan únicamente Aircall Salesforce CTI v3 (sin el paquete Sales Engagement v4 instalado).

Esta guía es para administradores de Salesforce cuya organización ya utiliza 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 actual de CTI v3 sigue gestionando las llamadas
  • El nuevo objeto Aircall Log (ALO) se convierte en el objeto dedicado para almacenar la actividad detallada de Aircall en Salesforce
  • Puedes usar Task + ALO (predeterminado) o pasar a Only ALO para el registro
Consejo: No omitas ningún paso de configuración de esta guía. Todos los pasos de las instrucciones internas de configuración se incluyen aquí 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 + Aircall Log object. 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 Salesforce System Administrator 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:

  1. Revisar el comportamiento de la actualización del paquete y confirmar la actualización de CTI v3
  2. Asignar AirCall_PermissionSet
  3. Configurar el diseño del objeto Aircall Log (ALO)
  4. Actualizar la configuración de Task para la nueva relación entre Task ↔ ALO
  5. Confirmar o ajustar el comportamiento del registro de llamadas en el Panel de control de Aircall
  6. Actualizar automatizaciones e informes si pasas a Only ALO
  7. Revisar cómo aparecerá la nueva opción de registro en el Panel de control de Aircall una vez que esté habilitada para tu empresaRealizar comprobaciones posteriores a la migración
  8. (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. Hasta entonces, utiliza 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 creado para almacenar la actividad de Aircall de una 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 mensajes, AI y IVR)
  • Un registro de llamadas más flexible
  • Informes y análisis más sólidos

Con ALO:

  • Las interacciones de Aircall se registran en un objeto diseñado específicamente para ello
  • 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 puede configurarse para:
    • Task + Aircall Log object (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 establece el registro en Task + Aircall Log object. Solo tienes que 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 sitio. Estás mejorando tu configuración actual de CTI v3 añadiendo ALO y las nuevas opciones de registro.

Screenshot 2026-04-03 at 12.15.03.png
Screenshot 2026-04-03 at 12.15.21.png

Paso 1. Verificar la versión instalada: CTI v3

Aircall ejecuta automáticamente la actualización por ti. Una vez completada la actualización, tendrás que verificar la versión instalada:

Pasos:

  1. En Salesforce, ve a Setup > Installed Packages.
  2. Busca Aircall CTI for Salesforce.
  3. Confirma que el Version Name es 2.27 (o la versión especificada por Aircall para este despliegue).
Screenshot 2026-04-03 at 12.15.47.png
Screenshot 2026-04-03 at 12.15.59.png
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 obtener más información, 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 los objetos estándar clave (Account, Contact, Lead, Opportunity y Case) para realizar búsquedas de contactos y mostrar el registro correcto cuando llega 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)

  1. En Setup de Salesforce, busca Permission Sets en el cuadro Quick Find.
  2. Busca 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 para 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)

  1. Busca el conjunto de permisos AirCall_PermissionSet y luego haz clic en Clone.
  2. Asigna al conjunto de permisos clonado un nombre descriptivo (por ejemplo, Aircall CTI View All) y luego haz clic en Save.
  3. En el conjunto de permisos clonado, ve a Object Settings.
  4. 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).
  5. Asigna el conjunto de permisos clonado (y el conjunto de permisos base de Aircall CTI) a los usuarios que necesiten 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 CTI busque contactos y muestre el registro correcto cuando llega 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)

  1. En Setup de Salesforce, busca Permission Sets en el cuadro Quick Find.
  2. Busca el conjunto de permisos AirCall_PermissionSet.
  3. Asígnalo a todos los usuarios de CTI.
Nota: Because AirCall_PermissionSet is a managed permission set, you cannot change its permissions directly.
Importante: Si quieres ajustar los 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)

  1. Busca el conjunto de permisos AirCall_PermissionSet.
  2. Haz clic en Clone.
  3. Asigna al conjunto de permisos clonado un nombre descriptivo, por ejemplo Aircall CTI View All, y luego haz clic en Save.
  4. En el conjunto de permisos clonado, ve a Object Settings.
  5. Para cada uno de estos objetos, revisa y ajusta el acceso según sea necesario:
    • Account
    • Contact
    • Lead
    • Case
    • Opportunity
  6. Si tu modelo de seguridad lo permite, habilita un acceso más amplio como View All donde sea necesario.
  7. Asigna el conjunto de permisos clonado y el AirCall_PermissionSet base a los usuarios que necesiten 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 que son importantes para los informes y la resolución de problemas.

Pasos:

  1. En Salesforce, ve a Setup.
  2. Haz clic en Object Manager.
  3. Busca Aircall Log.
  4. Haz clic en Page Layouts.
  5. Edita el diseño existente.
  6. 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
  7. (Opcional) Clona el diseño de ALO para crear distintos diseños para diferentes equipos o perfiles.
  8. Haz clic en Save.

Empieza mostrando los campos que tus equipos ya utilizan en informes y resolución de problemas, y 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 utilizarán el registro de CTI:

Pasos:

  1. En Salesforce, ve a Setup.
  2. Ve a Object Manager > Task.
  3. Haz clic en Fields & Relationships.
  4. Busca el campo Type.
  5. Edita la seguridad a nivel de campo y establece Visible para los perfiles que usan el registro de CTI.
  6. 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:

  1. Todavía en Object Manager, selecciona Task.
  2. Haz clic en Page Layouts.
  3. Edita los diseños de Task que se utilizan para la actividad de llamadas.
  4. Añade el campo Aircall Log a cada diseño correspondiente.
  5. Haz clic en Save.

Esto crea una relación clara entre cada Task y su registro ALO correspondiente, y es obligatorio para 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: Qué 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 periodo de transición para darte tiempo a hacer el cambio. El campo antiguo quedará obsoleto en el Q3, 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 mantienes Task + ALO, tus flujos de trabajo e informes existentes basados en Task pueden seguir funcionando, y podrás adoptar ALO gradualmente.

4.1. Automatizaciones

Si tu equipo tiene flujos de trabajo o informes de Salesforce creados en torno al registro basado en Task, y te pasas a Only ALO, puede que necesites actualizar:

  • Automatizaciones
    • Flows
    • Reglas de flujo de trabajo o Process Builder (si todavía se usa)
    • Triggers
    • Cualquier lógica de enrutamiento basada en campos de Task

Acciones a tener en cuenta:

  • Identifica todas las automatizaciones que se activan en campos de Task para el registro de llamadas.
  • Vuelve a crearlas o ajústalas para que hagan referencia a campos de Aircall Log cuando uses Only ALO.

4.2. Informes y paneles

Si pasas a Only ALO:

  • Actualiza informes y paneles para usar el objeto Aircall Log en lugar de solo Task
  • Reconstruye 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. Una vez que tengas confianza, podrás trasladar 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 que esta opción se habilite. Esto significa que es posible que aún no veas el ajuste a menos que:

  • Aircall lo habilite antes para tu empresa, o
  • Esté disponible como parte del lanzamiento general

Cuando esta opción esté disponible, controlará si las llamadas se registran en:

  • Task + Aircall Log object (predeterminado), o
  • Only Aircall Log object

Si planeas pasar 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á este ajuste

Cuando esté disponible:

Pasos:

  1. Abre tu Panel de control de Aircall > Integraciones & API.
  2. Busca tu integración Salesforce v3.
  3. Selecciónala y abre la pestaña Configuración.
  4. Busca la sección Salesforce Settings.
  5. Busca Call logging should be done on.
  6. Selecciona una opción:
    • Both Task and Aircall Log Object (predeterminado), o
    • Only Aircall Log Object
Nota: Si mantienes Task + Aircall Log object, es posible que tus flujos de trabajo e informes existentes basados en Task deban actualizarse.

• Automatizaciones - Flows, reglas de flujo de trabajo, triggers, lógica de enrutamiento
• Informes - Reconstruye cualquier informe basado en Task para incluir el campo Aircall Log, utiliza el nuevo tipo de informe Task and Aircall Log y actualiza los paneles.

Paso final: Activación de las funciones de registro

Una vez que hayas completado todos los pasos anteriores, hay dos formas de proceder con la activación de tus funciones de registro:

  1. 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 acción adicional por tu parte.
  2. Activación anticipada: Si deseas que las funciones de registro se habiliten antes de esa fecha, ponte en contacto con el 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, ponte en contacto con nuestro equipo de soporte al cliente y lo habilitaremos por ti.