Migrar de Aircall Salesforce CTI v3 + v4 a la CTI unificada v3

Importante: Este artículo actualmente soporta pruebas Beta de la experiencia unificada CTI v3 para clientes que usan tanto CTI v3 como Sales Engagement v4.

Esta guía es para administradores de Salesforce cuya organización tiene actualmente instalados ambos:

• La integración Aircall Salesforce CTI (v3)
• El paquete Aircall para Salesforce Sales Engagement (v4)

Estás migrando a una experiencia única CTI v3 donde:

• Sales Engagement funciona directamente con el Aircall Workspace CTI en lugar del Salesforce Sales Dialer
• El nuevo objeto Aircall Log (ALO) se convierte en el lugar central para almacenar datos enriquecidos de actividad de Aircall en Salesforce

Al final de esta migración, desinstalarás el paquete v4. Sales Engagement y el registro de llamadas seguirán funcionando a través de CTI v3.

Nota: Como parte del despliegue, Aircall envía:
- La actualización del paquete CTI v3 a todos los clientes, y
- Los cambios en el registro del Dashboard específicamente a clientes con v3 + v4.

Tú eres principalmente responsable de la configuración de Salesforce: diseños, asignaciones de centros de llamadas, respaldo de datos y cualquier automatización o informe que haga referencia a objetos v4.

Antes de comenzar

Asegúrate de:

• Ser Administrador del Sistema de Salesforce o tener permisos equivalentes
• Tener acceso a tu organización Salesforce y al Dashboard de Aircall
• Saber qué equipos y usuarios usan actualmente Sales Engagement (v4)

En esta guía harás:

1. Revisar qué cambia con el paquete unificado CTI v3 y el nuevo objeto Aircall Log (ALO)
2. Confirmar la versión del paquete CTI v3 y asignar los conjuntos de permisos requeridos
3. Configurar el objeto Aircall Log (ALO) y actualizar los diseños de Tareas para que la nueva relación Tarea ↔ ALO funcione correctamente
4. Configurar Sales Engagement para que las llamadas de cadencia funcionen con el Aircall CTI y el componente Aircall Call Resolution
5. Probar la configuración actualizada con un pequeño grupo de usuarios
6. Cuando estés listo para dejar v4, respaldar los datos de AVO / v4, luego actualizar cualquier automatización e informes que dependan de objetos v4
7. Desinstalar el paquete v4 y realizar verificaciones finales para confirmar que el registro y las cadencias de Sales Engagement se comportan según lo esperado

Qué está cambiando

Acerca del objeto Aircall Log (ALO)

Aircall Log es un nuevo objeto dedicado de Salesforce diseñado para almacenar la actividad de Aircall de forma más estructurada y escalable.

Antes, el registro en CTI v3 dependía principalmente del objeto Salesforce Task, lo que puede ser limitante para clientes que necesitan:

• Datos de llamada más ricos (por ejemplo, información de mensaje, IA y IVR)
• Opciones robustas de informes
• Más flexibilidad en cómo se captura el compromiso de Aircall en Salesforce

Con ALO:

• Los equipos pueden rastrear interacciones de Aircall en un objeto diseñado para este propósito
• La calidad de los datos mejora y Salesforce se vuelve un sistema de registro más sólido para la actividad de Aircall

Qué cambia con el registro de llamadas

Después de esta 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:
  • Tarea + objeto Aircall Log (por defecto), o
  • Solo objeto Aircall Log

Si actualmente usas Sales Engagement (v4):

• Transicionarás de Aircall Voice Object (AVO) a objeto Aircall Log (ALO)
• ALO reemplaza el uso de AVO para registrar llamadas de Sales Engagement

Para más información sobre ALO, consulta nuestro artículo Objeto Aircall Log (ALO)

Nota: Por defecto, la actualización configura automáticamente a los clientes en Tarea + objeto Aircall Log. Solo necesitas cambiar esto si deseas registrar en Solo objeto Aircall Log.

Qué cambia con Sales Engagement

Con esta actualización:

• Sales Engagement ahora funciona directamente con el Aircall Workspace CTI, en lugar del Salesforce Sales Dialer predeterminado
• Después de que termina una llamada, se solicita a los usuarios registrar la resolución de la llamada en un modal post-llamada
• Una vez que envían la resolución, pueden seguir trabajando en el Aircall CTI mientras navegan por Salesforce sin interrupciones

Paso 1. Planifica tu respaldo y comprende el impacto

Cuando desinstales el paquete v4:

• El Aircall Voice Object (AVO) y sus registros serán eliminados
• Cualquier configuración de Salesforce que haga referencia a campos de AVO dejará de funcionar hasta que se actualice

Antes de cambiar algo, decide:

• Qué datos de AVO debes conservar (por ejemplo, registros históricos de llamadas o informes)
• Qué flujos, automatizaciones e informes dependen de AVO u otros objetos v4
• Si restaurarás algún dato en ALO después de la migración

Importante: No desinstales el paquete v4 todavía.

Respaldarás datos, completarás la configuración de CTI v3, verificarás el registro y solo entonces eliminarás v4.

Paso 2. Confirma la actualización del paquete CTI v3 y asigna conjuntos de permisos

2.1. Comportamiento de la actualización del paquete

Como parte de este despliegue:

• Si proporcionas tu ID de organización Salesforce, Aircall actualiza automáticamente tu organización a la nueva versión del paquete CTI v3
• Si es necesario, también puedes realizar la actualización manualmente usando el enlace del paquete proporcionado por Aircall

2.2. Asignar conjuntos de permisos

Después de la actualización, asigna los conjuntos de permisos requeridos para asegurarte de que los administradores y usuarios de Sales Engagement puedan acceder a CTI v3, ALO y funciones de Sales Engagement.

Pasos:

1. En Salesforce, ve a Configuración > Conjuntos de permisos.
2. Asigna los siguientes conjuntos de permisos a un Administrador del Sistema y a los roles apropiados:
   • AirCall_PermissionSet
   • Sales Engagement Cadence Creator
   • Sales Engagement Conversation Insights
   • Sales Engagement Quick Cadence Creator
   • Sales Engagement User

Importante: El plan de migración destaca conjuntos de permisos, diseños de página, el modal de Sales Engagement y el registro en el Dashboard como áreas clave de configuración para clientes con v3 + v4.

Paso 3. Configura el objeto Aircall Log (ALO)

Actualiza el diseño de página de ALO

Puedes configurar el diseño de página de ALO para ajustarlo a las necesidades de tu negocio.

Pasos:

1. En Salesforce, ve a Configuración.
2. Haz clic en Administrador de objetos.
3. Busca Aircall Log.
4. Ve a Diseños de página.
5. Edita el diseño y añade o reorganiza campos según sea necesario.
6. (Opcional) Clona el diseño de ALO para crear diferentes diseños para distintos equipos o perfiles.
7. Guarda.

Paso 4. Actualiza la configuración de Tareas

Como ALO ahora tiene una relación directa con Tarea, debes asegurarte de que la configuración de Tarea refleje esto.

4.1. Actualiza la seguridad a nivel de campo para Tipo de Tarea

Para habilitar el campo Tipo para los perfiles que usarán CTI:

Pasos:

1. Ve a Configuración.
2. Navega a Administrador de objetos > Tarea.
3. Busca el campo Tipo.
4. Configúralo como Visible para los perfiles que usarán CTI (registro de llamadas).
5. Guarda.

4.2. Añade el campo Aircall Log a los diseños de página de Tarea

Para permitir la vinculación entre Tarea y ALO:

Pasos-

1. En Administrador de objetos, selecciona Tarea.
2. Abre Diseños de página.
3. Añade el campo Aircall Log a los diseños de Tarea relevantes.
4. Guarda.

Esto crea una relación clara entre cada Tarea y su registro ALO y es requerido por el nuevo modelo de registro.

Paso 5. Confirma o actualiza el comportamiento de registro en el Dashboard de Aircall

Solo necesitas actuar en el Dashboard si quieres registrar en Solo objeto Aircall Log.

Por defecto, la actualización configura automáticamente el registro de llamadas en Tarea + objeto Aircall Log.

5.1. Verifica el modo actual de registro

Pasos:

1. Ve a Dashboard de Aircall > Integraciones y API.
2. Encuentra tu integración Salesforce v3 y selecciónala.
3. Abre la pestaña Configuración.
4. En la sección Configuración de Salesforce, localiza El registro de llamadas debe hacerse en.
5. Confirma que la opción seleccionada coincide con tus expectativas:
   • Tanto Tarea como objeto Aircall Log (por defecto), o
   • Solo objeto Aircall Log

5.2. Cambiar modo de registro (opcional)

Si quieres registrar solo en ALO:

Pasos:

1. Sigue los pasos 1 a 5 anteriores.
2. Cambia El registro de llamadas debe hacerse en a Solo objeto Aircall Log.
3. Guarda los cambios.

Nota: Si cambias a “Solo objeto Aircall Log”, puede que necesites actualizar flujos de trabajo y reportes de Salesforce que se basan en el registro mediante Tareas.

Paso 6. Configura Sales Engagement para CTI v3

Si ya usas Sales Engagement con v4, ahora debes asegurarte de que Sales Engagement esté correctamente configurado para CTI v3.

6.1. Habilita configuraciones de Sales Engagement

Pasos:

1. En Salesforce, ve a Configuración.
2. Busca Configuraciones de Sales Engagement.
3. Ve a la subpestaña Automatizar.
4. Habilita Activar Sales Engagement.
5. Ve a la pestaña Llamada.
6. Habilita Configuraciones de Cadencia de Llamadas.

6.2. Mapea la resolución de llamada a la progresión de cadencia

Para avanzar los pasos de cadencia basados en los resultados de llamadas, debes mapear los valores de resolución de llamada de Aircall a los resultados de llamada de la cadencia en Sales Engagement.

Ejemplo de mapeo

• Valor de resolución de llamada de Aircall: Resuelto
• Resultado de llamada de cadencia: Conexión significativa

Esto asegura que cuando una llamada se marca como Resuelta:

• El elemento de trabajo se completa
• La cadencia avanza al siguiente paso

6.3. Añade el componente Aircall Call Resolution a las páginas de registros

Los administradores deben añadir el componente Aircall Call Resolution (aircallCallResolution) a las páginas de registros relevantes (Cuenta, Lead y Contacto).

Pasos:

1. Navega a la aplicación Lightning correspondiente.
2. Abre un registro de Cuenta, Lead o Contacto.
3. Haz clic en el icono de engranaje y elige Editar página.
4. En Lightning App Builder, busca aircallCallResolution.
5. Arrastra el componente a la página.

6. Haz clic en Guardar.
7. Haz clic en Activar.

8. Selecciona Predeterminado de la aplicación + Asignar como predeterminado de la aplicación
9. Selecciona las aplicaciones Lightning correspondientes

10. Haz clic en Siguiente
11. Selecciona la forma de escritorio y teléfono o solo escritorio Form Factor
12. Haz clic en Siguiente
13. Haz clic en Guardar

6.4. Actualiza las asignaciones de centro de llamadas (de v4 a v3)

Los usuarios de Sales Engagement deben estar asignados al centro de llamadas CTI v3.

Los usuarios solo pueden estar asignados a un centro de llamadas a la vez.

Consejo: Comienza moviendo 1-2 usuarios piloto al centro de llamadas v3. Si ocurren problemas, devuélvelos a v4 antes de continuar.

Pasos

1. En Configuración, ve a Centro de llamadas > Centros de llamadas.
2. Identifica el centro de llamadas v4 (por ejemplo, Aircall CTI 2.0 para Salesforce).
3. Haz clic en Administrar usuarios del centro de llamadas.
4. Elimina a los usuarios que ahora usarán CTI v3.
5. Regresa a Centros de llamadas y abre el centro de llamadas v3 (por ejemplo, Aircall CTI para Salesforce).
6. Haz clic en Administrar usuarios del centro de llamadas.
7. Haz clic en Añadir y selecciona los usuarios de Sales Engagement.
8. Haz clic en Añadir para confirmar.

Importante: No elimines el centro de llamadas v4 después de eliminar usuarios. Aún puede usarse como plan de reversión si es necesario.

Si prefieres una guía dedicada paso a paso para esta configuración, también puedes seguir el artículo Configurar Aircall para Salesforce Sales Engagement.

Paso 7. Respalda datos v4 (AVO) con Data Loader

Se recomienda encarecidamente realizar este respaldo una vez que estés completamente listo para dejar v4, para que no haya interrupción en el registro de datos entre tus últimas llamadas v4 y la desinstalación del paquete.

Pasos:

1. Abre Data Loader.
2. Haz clic en Exportar.
3. Selecciona el objeto personalizado v4 que quieres respaldar, por ejemplo:
   • aircall2gp__Aircall_Voice__c (Aircall Voice Object)
4. Selecciona Todos los campos.
5. Exporta a CSV y guarda el archivo de forma segura.
6. Repite para cualquier otro objeto personalizado v4 del que dependas.

Restaurar datos más tarde (opcional)

Para restaurar datos en el nuevo objeto (por ejemplo, Aircall Log):

Pasos:

1. Abre Data Loader.
2. Haz clic en Insertar.
3. Selecciona el nuevo objeto destino (por ejemplo, Aircall Log).
4. Sube el archivo CSV que exportaste anteriormente.
5. Asocia las columnas del CSV con los campos correspondientes de ALO.
6. Completa la inserción.

Opcionalmente, puedes usar VLOOKUP o IDs externos para mantener relaciones de búsqueda al restaurar.

Paso 8. Revisa automatizaciones y dependencias

Como ALO reemplaza a AVO para usuarios v4 y de Sales Engagement, puede que necesites actualizar la configuración de Salesforce que hace referencia a campos de AVO, incluyendo:

• Flujos de trabajo y flujos
• Automatizaciones y triggers
• Informes y dashboards
• Reglas de validación y lógica personalizada

Usa este paso para identificar todos los lugares donde se usan componentes v4.

Pasos:

1. En Salesforce, ve a Configuración > Paquetes instalados.
2. Abre el paquete Sales Engagement (v4).
3. Haz clic en Ver dependencias para ver dónde se referencian componentes v4.
4. Anota todas las dependencias que involucren:
   • Campos AVO
   • Componentes o tipos de registro v4

Conserva esta lista. La usarás en pasos posteriores cuando cambies de AVO a ALO y de informes solo con Tarea a ALO.

Paso 9. Actualiza automatizaciones e informes (de Tarea y AVO a ALO)

Si usas Solo objeto Aircall Log, o quieres aprovechar un registro más rico, puede que necesites actualizar:

9.1. Automatizaciones

Actualiza:

• Flujos
• Reglas de flujo de trabajo o Process Builder (si aún se usa)
• Triggers
• Cualquier lógica de enrutamiento basada en campos de Tarea
• Cualquier lógica o validación que use campos AVO

Para clientes de Sales Engagement:

• ALO reemplaza a AVO
• Cualquier automatización que haga referencia a AVO debe actualizarse para usar ALO donde corresponda

9.2. Informes

• Actualiza informes y dashboards para usar Aircall Log donde antes usabas Tarea o AVO
• Reconstruye informes basados en Tarea donde sea necesario para aprovechar los datos enriquecidos de ALO

Paso 10. Respalda datos (si no lo hiciste) y desinstala v4

Para entornos sandbox y de pruebas, el respaldo de datos no es estrictamente necesario antes de probar las nuevas funciones. Para producción y GA, es obligatorio antes de migrar completamente a CTI v3.

10.1. Recordatorio de respaldo de datos

Si no completaste el Paso 2 anteriormente, exporta datos de objetos personalizados v4 usando Data Loader o informes de Salesforce, luego verifica:

• Que los registros clave existan en tu respaldo
• Que las relaciones de búsqueda se conserven (o puedan restaurarse usando IDs externos o VLOOKUP)
• Que los informes y dashboards puedan reconstruirse si es necesario con los datos restaurados

10.2. Desinstala el paquete v4

Cuando estés listo para desinstalar el paquete v4:

Pasos:

1. En Salesforce, ve a Configuración.
2. Busca Paquetes instalados.
3. Localiza Salesforce Sales Engagement (el paquete v4).
4. Haz clic en Desinstalar.
5. Sigue el flujo de desinstalación y resuelve cualquier advertencia de dependencias que muestre Salesforce.

Importante: Una vez desinstalado el paquete v4, el objeto AVO y sus datos se eliminan.

Asegúrate de que todos los respaldos requeridos estén hechos y cualquier dato necesario haya sido restaurado o archivado antes de continuar.

Paso 11. Realiza verificaciones post migración

Después de haber migrado completamente al paquete unificado CTI v3, realiza estas verificaciones finales.

11.1. Llamadas estándar CTI

• Realiza una llamada de prueba desde un Contacto o Lead usando el Aircall CTI.
• Confirma que:
  • Se crea una Tarea y un registro Aircall Log (si usas Tarea + ALO), o

Se crea un único registro Aircall Log (si usas Solo ALO)

11.2. Llamadas de Sales Engagement

• Inicia una llamada desde una cadencia de Sales Engagement en la Cola de Trabajo.
• Después de que termina la llamada, confirma que el usuario ve el modal post-llamada y puede registrar la resolución de la llamada.
• Verifica que:
  • El elemento de trabajo se completa
  • La cadencia avanza al siguiente paso correcto basado en el resultado de llamada mapeado

11.3. Informes

• Abre tus informes y dashboards clave de actividad de llamadas.
• Confirma que aparecen nuevas llamadas según lo esperado.
• Valida que cualquier nuevo informe basado en ALO muestre los campos y datos esperados.

Si algo no funciona como esperas, revisa:

• Configuración de ALO y Tarea (Pasos 5 y 6)
• Configuraciones y componentes de Sales Engagement (Paso 8)
• Comportamiento del registro de llamadas en el Dashboard de Aircall (Paso 7)
• Actualizaciones de automatizaciones e informes (Paso 9)

Una vez que estas verificaciones pasen, tu organización habrá migrado completamente de Aircall Salesforce CTI v3 + Sales Engagement v4 a la CTI unificada v3 con objeto Aircall Log (ALO) y Sales Engagement funcionando sobre Aircall CTI.