Integración con Genesys Bot Connector

Antes de empezar

Debe cumplir los siguientes requisitos antes de empezar a integrar su asistente con Genesys Bot Connector:

• Crea una nueva cuenta o inicia sesión en una cuenta existente de Genesys Cloud que tenga acceso a Genesys Architect y a la región correcta en el portal de Genesys Cloud.

• El rol ' Admin ' en la organización de Genesys Cloud.

Para obtener más información sobre los roles y permisos de Genesys Cloud, consulte la sección «Descripción general de los roles y permisos ».

Configurar Bot Connector en Genesys

1. Vaya a la página Genesys Admin.

2. En Integraciones, haga clic en Integraciones.

3. En la página Integraciones, haga clic en +Integraciones.

4. Busque Genesys Bot Connector y haga clic en Instalar.

5. En la pestaña Detalles, introduce un nombre y cualquier nota para tu Bot Connector.

6. Haga clic en Copiar el ID de integración y guarde. Necesitas el ID de integración para crear la integración del asistente de IA Genesys Bot Connector.

7. En la pestaña Configuración, en Propiedades, introduzca un marcador de posición Bot Connector Handle Utterance URI. Deberás volver y actualizar este URI una vez que se haya creado la integración del asistente de IA Genesys Bot Connector.

8. En la pestaña «Credenciales», haz clic en «Configurar» para crear un campo de credenciales con el nombre «x-watson-genesys-verification-token » y con el valor del secreto que hayas establecido en el asistente de IA.

Necesitas este valor para crear la integración del asistente de IA Genesys Bot Connector. Copia y guarda el token y el valor para poder pegarlos en el campo «Token de verificación» cuando realices la integración con el asistente de IA.

No podrá volver a ver estas credenciales después de hacer clic en Guardar.

1. Haga clic en Aceptar y Guardar.

Mantenga la página web de Genesys abierta en una pestaña del navegador para poder consultar y completar los campos a medida que avanza la configuración.

Integrar el asistente de IA con Genesys

Chatea con el asistente

Para iniciar una conversación con el asistente, siga los pasos siguientes:

1. Abra Genesys Architect y cree un flujo de mensajes entrantes.

2. En la Caja de herramientas, haz clic en Bot y, a continuación, en Conector de bot de llamada.

3. Selecciona los valores:

   • Integración de bots:

   • Nombre del bot: Conector de bot del asistente de IA « IBM »

   • Versión Bot: 1.0

4. Introduce las variables de sesión que quieras que se transfieran al asistente de IA y desde él. Para obtener más información, consulte «Compartir contexto mediante variables de sesión ».

5. La salida del Bot Connector es ' Success o ' Failure. Deberías bifurcar tu flujo Genesys al salir del Bot Connector según la salida ' Intención del Bot Connector. Para más información, consulte Condicionamiento y ramificación de la salida.

Compartir el contexto mediante variables de sesión

Desde el nodo «Bot Connector» del flujo de Genesys Architect, puedes especificar variables de sesión que se pueden utilizar para enviar información al asistente de IA. Puede especificar tanto parámetros de Entrada como de Salida. Para la integración, ambos parámetros se fusionan en un único objeto bajo el context objeto.

Tanto los parámetros de entrada como los de salida están disponibles en el asistente de contextIA, y la información se comparte en cada turno. Por ejemplo, la context función disponible en el asistente de IA es:

{
  "context": {
    "integrations": {
      "genesys_bot_connector": {
        "user_id": "<SENT FROM GENESYS>",
        "some_variable": "<SET_FROM_WATSON_ASSISTANT>"
      }
    }
  }
}

En cuanto a los parámetros de entrada, puedes acceder a la variable de sesión en el asistente de IA de la siguiente manera:

• Para Dialog : Utilice $integrations.genesys_bot_connector.user_id.

• Para acciones : Utilice ${system_integrations.genesys_bot_connector.user_id}.

Para los parámetros de Salida, puede asignar las variables de sesión a una variable de estado en Genesys (por ejemplo, ' State.some_variable y acceder a ellas más adelante en su flujo).

Acondicionamiento y bifurcación de salida

Desde Genesys Architect, puedes utilizar Logical funciones para ramificar tu flujo en función del contexto que te devuelva el asistente de IA. Por ejemplo, el asistente de IA devuelve un Intent parámetro que se guarda en State.Intent.

En architect, puede añadir una acción ' Switch ' para ramificarse en diferentes escenarios. Por ejemplo, puede configurar un caso en el que ' State.Intent == "connect_to_agent", y luego ramificarse.

Finalización del flujo de Genesys Bot Connector

Cuando la conversación llega al nodo «Bot Connector» en Architect, Genesys actúa como intermediario en los mensajes entre el usuario y el asistente de IA, y continúa hasta que la conversación finaliza. Para devolver la conversación a Genesys, debes utilizar el tipo connect_to_agent de respuesta o el tipo end_session de respuesta.

{
  "output": {
    "generic": [
      {
        "response_type": "text",
        "values": [
          {
            "text": "You have ended the call."
          }
        ]
      },
      {
        "response_type": "end_session"
      }
    ]
  }
}

{
  "output": {
    "generic": [
      {
        "response_type": "text",
        "values": [
          {
            "text": "Connecting you to an agent."
          }
        ]
      },
      {
        "response_type": "connect_to_agent"
      }
    ]
  }
}

Tipo de respuesta definida por el usuario

El tipo de respuesta ' user_defined ' le permite pasar una respuesta personalizada a Genesys. Por ejemplo, esto se puede utilizar para devolver Cards Carousels y a Genesys, que no cuentan con un tipo de respuesta equivalente en el asistente de IA. Un ejemplo de cómo devolver un Card a Genesys es:

{
  "output": {
    "generic": [
      {
        "user_defined": {
          "replyMessages": [
            {
              "type": "Structured",
              "content": [
                {
                  "contentType": "Card",
                  "card": {
                    "title": "Card title",
                    "description": "Card description",
                    "image": "http://www.samplesite.com/photo/1234.jpg",
                    "actions": [
                      {
                        "type": "Link",
                        "text": "Link display text",
                        "url": "http://www.samplesite.com"
                      },
                      {
                        "type": "Postback",
                        "text": "Postback display text",
                        "payload": "Postback text"
                      }
                    ]
                  }
                }
              ]
            }
          ]
        },
        "response_type": "user_defined"
      }
    ]
  }
}

Tipos de respuesta

Estos tipos de respuesta son compatibles y se muestran como se espera cuando su asistente se despliega para el canal Genesys Bot Connector.

• connect_to_agent

• end_session

• opción

• Texto

• user_defined