Integración de BLIP Desk con Salesforce MIAW

Índice

1. Obtener la URL y configuraciones de la API MIAW después de habilitarla

2. Registro de Conjuntos de Claves Web JSON (JWK) para autenticación

3. Habilitar “Verificación de usuario” en el canal MIAW de Blip

4. Vincular el JWK registrado al canal MIAW de Blip

5. Configuraciones de Blip para integración con MIAW Salesforce

6. Configuración de “SalesforceMessaging.RoutingAttributes”

Contexto

Estamos publicando una nueva documentación para apoyar a las marcas que actualmente utilizan la antigua integración con la API de Salesforce LiveAgent. El objetivo es facilitar la transición al MIAW, asegurando que la integración continúe funcionando de manera estable y alineada con el estándar actual de la plataforma.

Consulta la documentación completa de la API en el sitio web de Salesforce:
https://developer.salesforce.com/docs/service/messaging-api/references/miaw-api-reference?meta=Summary

Obtener la URL y configuraciones de la API MIAW

Accede a Configuración (Setup) en Salesforce.

En Quick Find, escribe “Embedded Service”.

Haz clic en “Embedded Service Deployments”.

Busca y selecciona la implementación MIAW configurada para Blip.

Dentro de los detalles, haz clic en “Install Code Snippet”.

En el JSON, anota:

OrganizationId

DeveloperName

Url (URL base de la API MIAW)

Registro de JWK para autenticación

En Setup, busca “Messaging for In-App and Web User Verification”.

En el grid “JSON Web Keysets”, haz clic en “New Keyset”.

Completa el formulario:

Name: [elección del usuario]

API Name: [elección del usuario]

JSON Web Key Issuer: blipsalesforce

Type: Endpoint

Endpoint URL: https://blipmediastore.blip.ai/permanent-public-jwk-salesforce/blipai-SalesforceJWK.json

Haz clic en “Save”.

Habilitar “Verificación de usuario” en el canal MIAW

En Salesforce, abre Setup.

Busca “messaging settings”.

Edita el canal MIAW configurado para Blip.

Marca “Add User Verification”.

Define el tiempo de expiración del token.

Haz clic en “Save”.

Vincular JWK al canal MIAW de Blip

En Setup, busca “messaging settings”.

Abre el canal MIAW configurado.

En el grid “User Verification Configuration”, haz clic en “New”.

Completa el formulario:

Keyset: selecciona el registrado en el paso 2

Configuration Name: [elección del usuario]

Marca “Active”

Haz clic en “Save”.

Configuraciones del Blip para integración con MIAW Salesforce

Abre Configuraciones avanzadas del bot que se conectará al canal Salesforce.

Configuración de “SalesforceMessaging.RoutingAttributes”

El objetivo principal del routingAttributes es enriquecer el contexto del servicio humano antes de que el agente inicie la interacción.

Este objeto JSON permite enviar datos adicionales del Blip al Salesforce, los cuales se mapean en el Formulario Pre-Chat.

Ejemplo de mapeo:

{
  "static.Microsoft Bot Framework": ["userAgent"],
  "Ticket.Team": ["queueId"],
  "Contact.Name": ["visitorName"],
  "Contact.Extras.accountId": ["accountId", "leadId"],
  "Contact.Extras.objetivo": ["goals"]
}

Ejemplo de salida enviada de Blip a Salesforce:

"routingAttributes": {
  "userAgent": "Microsoft Bot Framework",
  "queueId": "cola 1",
  "visitorName": "daniel couto",
  "accountId": "88888888",
  "leadId": "88888888",
  "goals": "ocio"
}

Para más información, consulta la comunidad o los videos en nuestro canal. 😃