Integrar módulos de interface com o LivePerson

Este documento mostra as etapas necessárias para integrar módulos UI com LivePerson e apresentar sugestões em tempo real. Este tutorial inclui as seguintes ações:

  1. Instale o aplicativo Conversational Cloud no LivePerson.
  2. Atualize as variáveis de ambiente ausentes nos dois servidores e faça a nova implantação.
  3. Configure o widget do Assistente do agente no LivePerson.

Antes de começar

Conclua as ações a seguir 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 Assistente de agente.
  3. Implante um servidor proxy que vai processar a autenticação e as chamadas para a API Dialogflow.

Instalar um aplicativo do Conversational Cloud

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

O esquema do manifesto enviado à LivePerson 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, a LivePerson vai fornecer um ID 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. Depois, implante os dois servidores novamente.

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 de recursos do Assistente de agente que você quer incluir no aplicativo. Os recursos atualmente compatíveis incluem: SMART_REPLY, ARTICLE_SUGGESTION, FAQ e CONVERSATION_SUMMARIZATION. Inclua apenas 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