Integrar módulos de interface com o LivePerson

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

  1. Instale o aplicativo Conversational Cloud no LivePerson.
  2. Atualize as variáveis de ambiente ausentes nos dois servidores e reimplante-as.
  3. Configure o widget de assistência ao agente no LivePerson.

Antes de começar

Você precisa concluir as seguintes ações antes de começar este tutorial. Os dois repositórios precisam ser implantados antes que a integração com a 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 exibir a UI dos módulos do Assistente do agente.
  3. Implante um servidor proxy que processe 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 sua conta do LivePerson para integrar com a autenticação OAuth do LivePerson. Entre em contato com um membro da equipe da LivePerson que possa facilitar a instalação. Siga as instruções na documentação do LivePerson.

O esquema de 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 da 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 do 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 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 formato abaixo, com as seguintes substituições:

  • Substitua {APPLICATION_SERVER_URL} pelo URL do servidor do aplicativo 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 compatíveis no momento são: 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