Integração com o Genesys Audio Connector

Antes de iniciar

Você deve ter os seguintes pré-requisitos antes de começar a integrar o seu assistente com o Genesys Audio Connector:

• Crie uma nova conta ou faça login em uma conta existente do Genesys Cloud com acesso ao Genesys Architect e à região correta no portal do Genesys Cloud.

• A função " Admin na organização do Genesys Cloud.

Para obter mais informações sobre funções e permissões do Genesys Cloud, consulte a Visão geral de funções e permissões.

Crie a integração do Audio Connector em seu assistente

1. Acesse a página Integrações clicando no ícone de integrações () no menu à esquerda.

Armazene as credenciais, pois você não poderá vê-las depois de clicar em Salvar. Você precisa dessas credenciais para configurar o Genesys Audio Connector.

1. Clique em Add (Adicionar ) na caixa Phone (Telefone ).

2. Clique no bloco Genesys Audio Connector.

3. Na seção Credentials (Credenciais ), copie e armazene as credenciais geradas automaticamente nos campos a seguir:

   • Chave de API

   • Segredo do cliente

   • URI de conexão de áudio do Genesys

   • ID do conector do bot

4. Clique em Save and Exit (Salvar e sair).

Configure o conector de áudio para integrar o assistente

Para configurar o Genesys Audio Connector, siga as etapas descritas no tópico “Configurar e ativar o Audio Connector no Genesys Cloud ”.

Na página de administração do Genesys, vá para Integrações > Configuração para adicionar o valor do URI de conexão de áudio do Genesys que você copiou ao criar a integração do conector de áudio em seu assistente.

Na página " Administrador do Genesys, vá para " Integrações > " Credenciais para adicionar as credenciais para os campos " Chave da API e " Segredo do cliente que você copiou enquanto " criar a integração do Audio Connector em seu assistente.

Compartilhamento de contexto por meio de variáveis de sessão

No nó Conector de Áudio do fluxo do Genesys Architect, é possível especificar variáveis de sessão que podem ser usadas para passar informações ao criador de assistentes de IA. Você pode especificar os parâmetros de entrada e saída. Para a integração, esses dois parâmetros são combinados em um único objeto sob o context objeto.

Os parâmetros de entrada e saída estão disponíveis no assistente de contextIA, e as informações são compartilhadas a cada turno. Por exemplo, o recurso context disponibilizado no assistente de IA é:

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

Acesse os parâmetros de entrada do seu assistente de IA usando a variável de sessão ` ${system_integrations.genesys_audio_connector.user_id} `.

Para definir os parâmetros de saída, use uma expressão como ` ${system_integrations.genesys_audio_connector.some_variable} `, à qual você poderá acessar posteriormente no seu fluxo.

Execute as etapas a seguir para definir uma variável de saída:

1. Vá até a etapa de ações do assistente de IA, onde você deseja definir a variável.

2. Clique em Definir nova variável e selecione Expressão.

3. Insira a seguinte expressão:

${system_integrations.genesys_audio_connector.<variable_name>} = "<variable_value>"

Exemplo:

${system_integrations.genesys_audio_connector.some_variable} = "this is an output variable"

Neste exemplo, o nome da variável é some_variable, com o valor definido como "esta é uma variável de saída".

Finalização do fluxo do Genesys Audio Connector

Depois de receber a conversa de áudio do usuário, o nó Audio Connector no Genesys Architect facilita a troca de mensagens entre o usuário e o assistente até o final da conversa. Para enviar a conversa de áudio de volta ao Genesys, você deve usar o tipo de resposta ' end_session.

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

Tipos de resposta

Após integrar seu criador de assistentes de IA ao Genesys Audio Connector, você poderá usar os seguintes tipos de resposta no assistente:

• Texto

• opção

• end_session

• speech_to_text

• text_to_speech

• start_activities

• stop_activities

• dtmf

• user_defined

• connect_to_agent

• imagem

• áudio