Wiline UCaaS, WiLine Connect, Wiline Voip
Saltar al contenido principal
WiLine UCaaS, WiLine Voip, WiLine PBX WiLine UCaaS, WiLine Voip, WiLine PBX WiLine UCaaS, WiLine Voip, WiLine PBX WiLine UCaaS, WiLine Voip, WiLine PBX

Salesforce Integration

Integra Salesforce con el Admin Portal para unificar CRM y comunicación. La integración sincroniza los datos de Salesforce con la actividad de llamadas, habilita ClickToCall para leads y contactos, y mantiene los registros alineados. Esto ayuda a los equipos a responder más rápido, reducir trabajo manual y mejorar la colaboración. Esta guía muestra cómo crear, ver, editar y eliminar integraciones de Salesforce.

Credenciales necesarias para la integración​

Para configurar la integración, necesitarás las siguientes credenciales:

  • Salesforce URL (por ejemplo, https://your-instance.salesforce.com)
  • OAuth Consumer Key
  • OAuth Consumer Secret
  • Salesforce Username
  • Salesforce Password

Vamos a recorrer el proceso de configuración paso a paso.

Paso 1: Preparar Salesforce para la integración​

  1. Inicia sesión en tu cuenta de Salesforce con un rol de administrador.

  2. Haz clic en el ícono de engranaje en la esquina superior derecha y selecciona Setup:

    Navigate to Setup
    Figura 1. Accediendo al menú Setup de Salesforce.

  3. Serás redirigido a la página principal de configuración de Salesforce:

    Salesforce main page
    Figura 2. Página principal de configuración de Salesforce.

  4. En el cuadro Quick Find a la izquierda, escribe External y selecciona Apps > External Client App Manager.

  5. Haz clic en New External Client App para crear una nueva Connected App de Salesforce:

    Salesforce New External Client App
    Figura 3. Creando una nueva Connected App en Salesforce.

    Esta página muestra todas las apps creadas para comunicación con servicios externos.

  6. Completa el formulario con la información requerida. Los siguientes campos son obligatorios:

    • External Client App Name: un nombre para tu app (ej.: MegaphoneApp)
    • API Name: un nombre para la API (ej.: MegaphoneApp)
    • Contact Email: tu dirección de correo electrónico
    • Distribution State: Local

    Salesforce Important Field
    Figura 4. Creación de Connected App en Salesforce - asegúrate que "Distribution State" esté en "Local".

    info

    El Distribution State debe estar configurado en Local. Esto limita la Connected App solo a tu organización Salesforce, evitando distribución pública y asegurando comunicación segura con el Admin Portal de WiLine.

  7. Desplázate hacia abajo en la misma página para habilitar las siguientes configuraciones:

    API (Enable OAuth Settings)
    Figura 5. Habilitando configuraciones OAuth y seleccionando OAuth scopes.

    1. Establece el Callback URL a:
      https://prod-mega-goapiv1.wiline.com/api/v1/salesforce/oauth/callback.

    2. Selecciona los siguientes OAuth scopes:

      • Full access (full)
      • Manage user data via APIs (api)
      • Perform requests on your behalf at any time (refresh_token, offline_access)

  8. Desplázate más abajo y habilita estas configuraciones:

    • Flow Enablement:
      • Enable Authorization and Credential Flow
    • Security:
      • Require secret for Web Server Flow
      • Require secret for Refresh Token Flow

    select the following fields
    Figura 6. Habilitando configuraciones de flujo y seguridad.

  9. Haz clic en el botón Create para guardar tu Connected App en Salesforce.

    Verás la siguiente pantalla de confirmación:

    Manage External Client App - Enabled
    Figura 7. Connected App de Salesforce creada y habilitada con éxito.

  10. Tu Connected App ya está activa. Ahora, necesitas obtener el Consumer Key y Consumer Secret. Desplázate a la sección Settings y selecciona OAuth Settings:

    App Settings - Consumer Key and Secret
    Figura 8. Accediendo a Consumer Key y Consumer Secret.

  11. Haz clic en el botón Consumer Key and Secret en App Settings. Por seguridad, estas credenciales están ocultas hasta que verifiques tu identidad.

    Salesforce - Verify your identity
    Figura 9. Solicitud de verificación de identidad en Salesforce.

  12. Completa la autenticación para verificar tu identidad. Esta es una medida de seguridad de Salesforce. Tras autenticarse, las claves serán mostradas.

    Salesforce - Verify your identity Email
    Figura 10. Código de verificación enviado por correo electrónico.

  13. Revisa tu correo para el Verification Code. Ingresa este código en la página anterior y haz clic en Verify.

  14. Tras la verificación exitosa, se mostrarán el Consumer Key y Consumer Secret:

    Validated - Consumer Key and Consumer Secret
    Figura 11. Consumer Key y Consumer Secret validados.

  15. Guarda la Connected App y espera hasta 10 minutos para que los cambios se propaguen. Es posible que recibas un correo de verificación para confirmar tu email de contacto.

  16. Después de crear la Connected App, haz clic en View para ver y copiar el Consumer Key y Consumer Secret. Necesitarás estas credenciales para el Admin Portal.

Paso 2: Configurar la integración WiLine​

Después de obtener tus credenciales de Salesforce, configura la integración en el Admin Portal.

  1. Inicia sesión en el Admin Portal.

  2. Ve a Features > Integrations > Salesforce Integration.

    Choose Salesforce Integration
    Figura 12. Accede a Salesforce Integration en el Admin Portal.

Crear una nueva integración Salesforce​

  1. Haz clic en el botón New en la ventana Salesforce Integration:

    Create New Salesforce Integration
    Figura 13. Ventana de Salesforce Integration.

  2. Completa el formulario de integración con la siguiente información:

    CampoAcción
    NAMEIngresa un nombre descriptivo para esta integración.
    URLIngresa la URL completa de tu instancia Salesforce.
    USERNAMEIngresa tu nombre de usuario de Salesforce.
    CONSUMER KEYPega el OAuth Consumer Key de tu Connected App de Salesforce.
    CONSUMER SECRETPega el OAuth Consumer Secret de tu Connected App de Salesforce.

    Nota: Asegúrate que las credenciales OAuth sean correctas para mantener la conexión exitosa. Visita Paso 1: Preparar Salesforce para la integración si es necesario.

    1. Haz clic en Next para continuar a los siguientes pasos. Aparecerá un popup de autorización de Salesforce. Autentica y autoriza a WiLine para acceder a Salesforce:

      Salesforce authorization popup
      Figura 14. Popup de autorización de Salesforce.

    2. Después de la autorización, se generará un token API:

      API token confirmation
      Figura 15. Confirmación del token API.

    3. Sincroniza usuarios entre Salesforce y WiLine:

      User synchronization
      Figura 16. Opciones de sincronización de usuarios.

      Haz clic en Sync User y luego selecciona el Salesforce User del menú desplegable.

      Una vez sincronizado, podrás usar la función ClickToCall. Al ver un lead o contacto en Salesforce, presionar ClickToCall iniciará una llamada al cliente, sonando la extensión configurada en tu cuenta WiLine.

    4. Para finalizar la integración, completa configuraciones adicionales:

    • Call Type: selecciona Inbound o Outbound.
    • Select TNs: elige los números telefónicos que activan esta integración.
    • Package Installation: sigue las indicaciones para instalar los paquetes requeridos.

  3. Revisa todos los campos. Haz clic en Finish para guardar la integración.

Paso 3: Habilitar Click2Call en la interfaz de Salesforce​

  1. Inicia sesión en Salesforce con un rol de administrador.

  2. Haz clic en el ícono de engranaje > Setup:

    PC_1
    Figura 17. Accede a Setup vía Quick Find.

  3. En Quick Find, busca Object Manager:

    PC_2
    Figura 18. Navega a Object Manager.

  4. Selecciona Lead:

    PC_3
    Figura 19. Selecciona el objeto Lead.

  5. Abre Lightning Record Pages > Lead Record Page:

    PC_4
    Figura 20. Abre la Lead Record Page.

  6. En Custom, arrastra el botón Click2Call a la ubicación deseada:

    PC_5
    Figura 21. Arrastra el botón Click2Call.

    aviso

    Modificar otros componentes puede afectar tu diseño de página e integración.

  7. Haz clic en el botón azul Save.

  8. Prueba el botón Click2Call en un Lead: debería sonar tu extensión y conectar con el cliente, registrando los detalles de la llamada.

Usar el botón Click2Call en Salesforce​

  • En un Lead o Contacto, haz clic en ClickToCall para iniciar una llamada a través de tu extensión asignada:

    MF_16
    Figura 22. Botón ClickToCall en un registro de Salesforce.

  • Verifica tu extensión en Profile > Settings. WiLine asigna automáticamente este valor (ejemplo: “175-3091”):

    MF_15
    Figura 23. Campo de extensión asignado por WiLine.

    aviso

    No cambies este campo manualmente; puede afectar tu integración.

  • Las llamadas iniciadas mediante ClickToCall registrarán automáticamente detalles en el registro Lead:

    MF_17
    Figura 24. Datos de llamada registrados en Lead.

    ClickToCall hace sonar tu extensión, conecta con el cliente y registra los datos de la llamada en el registro Lead.

Editar una integración Salesforce existente​

Ver la lista de integraciones Salesforce​

  1. En la página de Integrations, localiza la integración Salesforce que deseas modificar.

  2. Haz clic en el botón View/Edit junto a la integración o haz doble clic en la fila de la integración.

  3. Actualiza los campos según sea necesario, como Name, URL u otras configuraciones:

    Salesforce Integrations List
    Figura 25. Ver todas las integraciones Salesforce existentes.

  4. Usa el botón Refresh para actualizar la lista si una integración recién creada no aparece inmediatamente.

Editar una integración Salesforce​

Para editar una integración Salesforce existente:

  1. En la página de Integrations, localiza la integración Salesforce que deseas modificar.

  2. Haz clic en el botón View/Edit junto a la integración o haz doble clic en la fila de la integración.

  3. Actualiza los campos que necesites, como Name, URL, Consumer Key, Consumer Secret u otras configuraciones.

    important

    Al editar una integración, puedes modificar los campos necesarios. Ten en cuenta que cambios en Consumer Key o Consumer Secret pueden requerir re-autenticación con Salesforce para generar un nuevo token. El sistema te mostrará el popup de autorización si es necesario.

    Edit Salesforce Integration
    Figura 26. Modificar una integración Salesforce existente.

  4. Para avanzar entre cada paso, usa el botón azul Next.

  5. Haz clic en el botón verde Finish para guardar los cambios.

  6. Si es necesario, haz clic en el botón gris Previous para regresar y modificar algún elemento.

Eliminar una integración Salesforce​

Para eliminar una integración Salesforce:

  1. Selecciona la integración Salesforce en la lista de la página Integrations.

  2. Para eliminar la integración, haz clic en el botón rojo Delete en la barra de acciones superior.

  3. Confirma seleccionando DELETE! en el menú desplegable.

    Delete Salesforce Integration
    Figura 27. Usa el botón Delete para eliminar permanentemente una integración Salesforce.

aviso

Eliminar una integración es irreversible. Por favor confirma antes de continuar.

Notas adicionales​

  • Verifica que tu cuenta Salesforce tenga permisos de acceso a la API.
  • Mantén seguras tus credenciales Salesforce; no las compartas.
  • Confirma que la URL y credenciales de Salesforce sean correctas si encuentras problemas.
  • Asegúrate que los correos electrónicos de usuario coincidan entre Salesforce y WiLine para habilitar la sincronización adecuada.
  • Si es necesario, contacta soporte para ayuda adicional con la configuración OAuth o integración.
  • Confirma que la Connected App de Salesforce tenga los OAuth scopes correctos y que el acceso API haya sido aprobado por tu administrador.