Integrar módulos de interface com o LivePerson

Este documento orienta você nas etapas necessárias para integrar módulos UI com LivePerson e mostrar sugestões em tempo real. As seguintes ações estão incluídas neste tutorial:

  1. Instalar o aplicativo Conversational Cloud no LivePerson.
  2. Atualizar as variáveis de ambiente ausentes nos dois servidores e implantá-los novamente.
  3. Configurar o widget do Agent Assist no LivePerson.

Antes de começar

Conclua as seguintes ações antes de começar este tutorial. Os dois repositórios precisam ser implantados para que a integração do LivePerson funcione:

  1. Para acessar o repositório, entre em contato com agent-assist-ui-modules-support@google.com.
  2. Implante um servidor de aplicativos que vai veicular a UI dos módulos do Agent Assist.
  3. Implante um servidor proxy que vai processar a autenticação e as chamadas para a API Dialogflow.

Instalar um aplicativo Conversational Cloud

É necessário registrar seu aplicativo como um aplicativo Conversational Cloud na sua conta do LivePerson para fazer a integração com a autenticação OAuth do LivePerson. Entre em contato com um membro da equipe do LivePerson que possa facilitar a instalação. Siga as instruções para fazer isso na documentação do LivePerson.

O esquema de manifesto enviado ao LivePerson precisa ser semelhante ao seguinte. Substitua todas as instâncias de {APPLICATION_SERVER_URL} pelo URL do servidor de aplicativos dos módulos UI:

{
  "client_name": "com.liveperson.GoogleAgentAssist",
  "display_name": "Agent Assist",
  "response_types": ["code"],
  "scope": "msg.consumer",
  "entry_uri": "{APPLICATION_SERVER_URL}",
  "grant_types": [
    "authorization_code",
    "client_credentials",
    "refresh_token"
  ],
  "redirect_uris": [
    "{APPLICATION_SERVER_URL}/home"
  ]
}

Atualizar variáveis de ambiente ausentes

Depois que o aplicativo Conversational Cloud for instalado, o LivePerson vai fornecer um ID do cliente e uma chave secreta do cliente. Atualize as variáveis de ambiente do servidor de aplicativos e do servidor proxy para incluir os valores corretos de LP_CLIENT_ID e LP_CLIENT_SECRET e, em seguida, reimplante os dois servidores.

Configurar o widget do LivePerson

Para configurar o widget do LivePerson, siga as instruções para adicionar seus próprios widgets ao espaço de trabalho do agente.

O URL do aplicativo precisa estar no seguinte formato, com as seguintes substituições:

  • Substitua {APPLICATION_SERVER_URL} pelo URL do servidor de aplicativos da UI.
  • Substitua {CONVERSATION_PROFILE_NAME} pelo nome do perfil de conversa que você quer usar (exemplo: projects/my-project/conversationProfiles/abc123).
  • Substitua {FEATURES} por uma lista separada por vírgulas dos recursos do Agent Assist que você quer incluir no aplicativo. Os recursos aceitos no momento incluem: SMART_REPLY, ARTICLE_SUGGESTION, FAQ e CONVERSATION_SUMMARIZATION. Inclua apenas os recursos configurados no seu perfil de conversa.

{APPLICATION_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}

URL de exemplo:

https://my-project.wm.r.appspot.com?conversationProfile=projects/my-project/conversationProfiles/abc123&features=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION