Integración CRM Salesforce

Introducción

3CX provee la integración con Salesforce a través de la API 3CX para CRM con las siguientes funciones:

• ID de Llamada a Nombre de Contacto - las llamadas entrantes activan una búsqueda de contactos en Salesforce.
• Búsqueda de Contactos en Salesforce basado en Nombre, Número o Correo Electrónico si busca un nombre en el Cliente Web 3CX.
• Registro de Llamada y Chat – las llamadas y los chats se registran en la Tarjeta de Contacto de Salesforce como registros de llamadas de CRM.
• Crear un nuevo contacto Salesforce desde el cliente 3CX para llamadas desde nuevos números.
• Click to Call - realice llamadas directamente desde Salesforce a través de 3CX, utilizando las extensiones de navegador 3CX Click2Call para Google Chrome y Microsoft Edge.

Requerimientos:

• Su cuenta de Salesforce debe tener Habilitada la API REST. Compruebe aquí las ediciones de Salesforce en las que la API está disponible.
• Las cuentas de Salesforce con Cuentas Personales activadas no son compatibles.

Paso 1: Configuración de Salesforce

1. Inicie sesión en su cuenta de Salesforce https://login.salesforce.com/ o genere una cuenta de desarrollador desde aquí https://developer.salesforce.com/signup.
2. Haga clic en “Ícono de Engranaje” > “Configuración”.
3. En la barra lateral, en la sección PLATFORM TOOLS, seleccione "Apps > Administrador de Apps".
4. Haga clic en el botón “Nueva Aplicación Cliente Externa” en la parte superior derecha de la página web.
5. Aparecerá el formulario “Administrador de Aplicación de Cliente Externo”.

6. En el panel Información Básica, proporcione un nombre de Aplicación de Cliente Externo, un correo electrónico de Contacto y un Estado de Distribución.

7. Desplácese hasta API (Enable OAuth Settings) y active la casilla "Enable OAuth".
8. En el campo Callback URL, introduzca el URL que utiliza para acceder a su Consola de Administración 3CX, añadiendo “/api/oauth2crm” al final, por ejemplo: “https://my-pbx.example.com:5001/api/oauth2crm”. Después conceda permiso como muestra la imagen superior. Los permisos son:

• Acceder al servicio URL de identidad (id, perfil, correo electrónico, dirección, teléfono).
• Acceder a identificadores de usuario únicos (openidid).
• Acceso Completo (full).
• Administrar los datos de los usuarios a través de API (api).
• Administrar los datos de los usuarios a través de navegadores Web (web).
• Realizar peticiones en cualquier momento (refresh_token, offline_access).

9. Vaya a la sección Seguridad y asegúrese de que las opciones "Requerir Secreto para el Flujo del Servidor Web" y "Requerir Secreto para Refrescar el Flujo del Token" están seleccionadas.
10. PKCE (‘Proof Key for Code Exchange’) ahora es soportado en 3CX Versión 20, Update 6. Se puede utilizar el flujo de autenticación PKCE habilitando la opción “Requerir Clave de Prueba para Intercambio de Código (PKCE) Extensión para Flujos de Autorización Soportados”.  Si la opción está deshabilitada, la PKCE será ignorada y la autorización será hecha exitosamente.
11. Presione Crear.
12. Haga clic en “Apps > Administrador de Apps > Encontrar su app” desde la lista y haga clic en “Editar Políticas”.

13. Debajo de Políticas, vaya a la sección políticas OAuth y asigne usuarios Permitidos a “Todos los usuarios auto-autorizarse”.
14. Haga clic en Guardar.

15. Debajo de Ajustes, vaya a la sección Ajustes OAuth y haga clic en “Clave y Secreto del Consumidor”. Luego copie los valores “Consumer key” y “Consumer secret” - necesitaremos añadir estos después dentro de la sección de Integración CRM 3CX.

Paso 2: Configure 3CX

1. Ingrese a la Consola de Administración 3CX y vaya a “Integraciones” > “CRM”.
2. Seleccione “SalesforceV2” desde el menú desplegable.
3. Ingrese los detalles obtenidos en el paso anterior para “Consumer Key” y “Consumer Secret”, y presione “Guardar” luego presione el botón de “Autorizar” para empezar el proceso de autenticación. Permita el acceso a 3CX y el Refresh Token se mostrará debajo del botón de Autorizar.

Paso 3: Configurar el Registro de Llamadas y Chat

1. Para reportar llamadas externas y chats a Salesforce, la dirección de correo electrónico configurada para la extensión 3CX debe coincidir con la dirección de correo electrónico de un usuario Salesforce. De esta manera 3CX puede asociar la extensión 3CX que recibe la llamada o chat al usuario Salesforce.
2. Marque la opción "Activar Registro de Llamadas" para notificar las llamadas externas al CRM, y configure estos parámetros de "Registro de Llamadas":

• “Asunto de Llamada” - asunto de la llamada.
• “Llamada Entrante Contestada” - descripción para llamadas entrantes contestadas.
• “Llamada Perdida” - descripción para llamadas perdidas.
• “Llamada Saliente Contestada” - descripción para llamadas salientes contestadas.
• “Llamada Saliente No Contestada” - descripción para llamadas salientes no contestadas.

3. Tenga en cuenta que puede utilizar variables en los parámetros de "Registro de Llamadas", indicadas como
   [variable_name]
   , por ejemplo: el número externo se especifica cómo
   [Number]
   . Las variables disponibles se enumeran aquí.

4. Si desea informar de los chats al CRM, marque la casilla Habilitar Registro de Chat y configure los parámetros que se indican a continuación:

• Asunto del Chat: El asunto de la sesión de chat.

5. Tenga en cuenta que puede utilizar variables en los parámetros de "Registro de Chat", indicados como
   [variable_name]
   , por ejemplo: el número externo se especifica cómo
   [Number]
   . Las variables disponibles se enumeran aquí.

Paso 4: Configuración de los Contactos y del Identificador de Llamada E164

1. Para obtener una coincidencia con Salesforce, los últimos 7 dígitos del Identificador de Llamadas entrante debe coincidir con los últimos 7 dígitos del campo teléfono en la entrada de CRM, o el número completo recibido por la Troncal SIP debe coincidir totalmente con el número en el CRM.
2. Salesforce puede almacenar los números en formato E164, así que si su Troncal SIP provee el número del llamante en formato E164 también, se prefiere una coincidencia exacta. También puede utilizar el Reformateo de Caller ID para ajustar el número de la persona que llama antes de pasarlo al CRM.
3. ⚠ Importante: En la Consola de Administración 3CX, vaya a “Sistema” > “Agenda” > “Opciones”. Establezca la estrategia de coincidencia a "Coincidir exactamente" cuando sea posible (formato E164 requerido en Salesforce y la Troncal SIP), o “Coincida al menos con X número de caracteres" y establezca el valor en 7.
4. ⚠ Importante: En Salesforce asegúrese de que todos los números de sus contactos están almacenados en formato E164, incluyendo el prefijo más (+). Este prefijo más (+) impide que Salesforce modifique automáticamente el número si se encuentra en EE.UU. o Canadá, lo que provoca que falle la búsqueda de contactos.

Paso 5: Configure la Creación de Contactos

1. Si desea crear nuevos contactos en el CRM cuando se recibe una llamada de un número desconocido (no encontrado en 3CX o en CRM), active la casilla “Permitir la creación de contactos directamente a su CRM usando el Cliente Web 3CX” y configure los parámetros a continuación.
2. Los parámetros de Creación de Contactos son:

• Crear Prospecto o Contacto - La entidad que se va a crear (Prospecto/Contacto).
• Nueva Empresa Prospecto - El nombre de la Compañía cuando se crea un Prospecto.

3. Tenga en cuenta que puede usar variables en los parámetros. Las variables se especifican entre [], por ejemplo: el número externo se especifica cómo [Numero]. Las variables disponibles se enumeran aquí.
4. Cuando el número de la persona que llama no coincida con un contacto, el Cliente 3CX permitirá al usuario crear el contacto llenando los detalles en un diálogo.

📄 Nota: al crear contactos en Salesforce, se ignorará el nombre de la empresa especificado en el Cliente Web. Esto se debe a las limitaciones de la API de Salesforce. Esto sólo se aplica a los contactos, el nombre de la empresa se establece al crear prospectos.

Ver También

• Vea cómo integrar su CRM con la API 3CX.
• Aprenda cómo configurar la integración Bitrix24.
• Aprenda cómo configurar la integración ConnectWise.
• Aprenda cómo configurar la integración Microsoft 365.
• Aprenda cómo configurar la integración Zendesk.
• Aprenda cómo configurar la integración Zoho.
• Aprenda cómo configurar las integraciones de bases de datos Servidor Microsoft SQL, MySQL y PostgreSQL.

Última Actualización

Este documento se actualizó por última vez el 16 de Julio de 2025

https://www.3cx.es/docs/integracion-crm-salesforce/