JavaScript do Dialogflow CX Messenger

O Dialogflow CX Messenger fornece functions que você pode chamar para afetar o comportamento dele.

renderCustomText

Essa função renderiza uma mensagem de texto simples, como se ela viesse do agente como uma resposta de texto simples ou tivesse sido inserida pelo usuário final.

Argumentos:

  • string: mensagem de texto
  • boolean: verdadeiro para uma mensagem do agente, falso para o usuário final

Devolução:

  • void

Exemplo:

const dfMessenger = document.querySelector('df-messenger');
dfMessenger.renderCustomText('Custom text', true);

renderCustomCard

Essa função renderiza um cartão personalizado, como se ele viesse do fulfillment do Dialogflow.

Argumentos:

  • payload: uma lista de respostas de payload personalizadas, que são definidas na seção Fulfillment.

Devolução:

  • void

Exemplo:

const dfMessenger = document.querySelector('df-messenger');
const payload = [
  {
    "type": "info",
    "title": "Info item title",
    "subtitle": "Info item subtitle",
    "image": {
      "rawUrl": "https://example.com/images/logo.png"
    },
    "anchor": {
      "href": "https://example.com",
      "target": "_blank"
    }
  }
];
dfMessenger.renderCustomCard(payload);

sendQuery

Essa função envia uma consulta para a API Dialogflow e aguarda a resposta. Isso simula uma entrada do usuário final que normalmente é fornecida à caixa de diálogo do agente. A resposta será processada como qualquer consulta do usuário final.

Argumentos:

  • string: consulta de texto

Devolução:

  • Promise<void>: valor de retorno para a operação assíncrona

Exemplo:

const dfMessenger = document.querySelector('df-messenger');
dfMessenger.sendQuery('Describe shipping costs.');

sendRequest

Essa função envia uma solicitação para a API Dialogflow e aguarda a resposta.

Argumentos:

  • string: tipo de solicitação, compatível com query (consulte também sendQuery acima) e event (consulte evento personalizado).
  • any: payload que corresponde ao tipo de solicitação, que atualmente é uma string para os dois tipos de solicitação aceitos

Devolução:

  • Promise<void>: valor de retorno para a operação assíncrona

Exemplo:

const dfMessenger = document.querySelector('df-messenger');
dfMessenger.sendRequest('query', 'Describe shipping costs.');

setQueryParameters

Essa função define valores padrão para o campo queryParams da solicitação detectIntent da API Dialogflow. Outros métodos do Dialogflow CX Messenger podem substituir os respectivos valores padrão nos parâmetros de consulta.

Argumentos:

  • object: dados JSON. Para o esquema de parâmetros de consulta, consulte QueryParameters.

Devolução:

  • void

Exemplo:

const dfMessenger = document.querySelector('df-messenger');
const queryParameters = {
  parameters: {
  timeZone: "America/New_York"
  }
};
dfMessenger.setQueryParameters(queryParameters);

setContext

Essa função envia informações de personalização generativa sobre o usuário final para o Dialogflow. Essas informações vão permanecer pelo restante da sessão.

Argumentos:

  • object: dados JSON. Consulte a documentação de personalização generativa.

Devolução:

  • void

Exemplo:

const dfMessenger = document.querySelector('df-messenger');
const metadata = {
  "subscription plan": "Business Premium Plus",
  "devices owned": [
    {
      model: "Google Pixel 7",
    },
    {
      model: "Google Pixel Tablet",
    },
  ],
};
dfMessenger.setContext(metadata);

clearStorage

Essa função limpa o armazenamento persistente da caixa de diálogo do agente. Ele também limpa o estado atual da caixa de diálogo do agente.

Argumentos:

  • nenhum

Devolução:

  • void

Exemplo:

const dfMessenger = document.querySelector('df-messenger');
dfMessenger.clearStorage();

clearAuthentication

Essa função limpa a autenticação da caixa de diálogo do agente.

Argumentos:

  • nenhum

Devolução:

  • void

Exemplo:

const dfMessenger = document.querySelector('df-messenger');
dfMessenger.clearAuthentication();

startNewSession

Essa função inicia uma nova sessão na caixa de diálogo do agente. Ele pode manter ou redefinir o histórico de mensagens atual. Ele não limpa a autenticação dos usuários.

Argumentos:

Nome Tipo Descrição
args object? Argumento opcional para configurar a criação de uma nova sessão.
args.retainHistory boolean? Flag opcional para manter o histórico. Se definido como "true", o histórico será mantido. Caso contrário, ele será apagado.

Devolução:

  • void

Exemplo:

const dfMessenger = document.querySelector('df-messenger');
dfMessenger.startNewSession({ retainHistory: true });

openChat

Essa função abre o chat. Chame-o no elemento df-messenger-chat-bubble para abrir o chat. Não faz nada se o chat já estiver aberto.

Argumentos:

  • nenhum

Devolução:

  • void

Por exemplo:

const dfMessengerBubble = document.querySelector('df-messenger-chat-bubble');
dfMessengerBubble.openChat();

closeChat

Essa função fecha o chat. Chame-o no elemento df-messenger-chat-bubble para fechar o chat. Não faz nada se o chat já estiver fechado.

Argumentos:

  • nenhum

Devolução:

  • void

Por exemplo:

const dfMessengerBubble = document.querySelector('df-messenger-chat-bubble');
dfMessengerBubble.closeChat();

openMinChat

Chat minimizado do Dialogflow CX Messenger

Essa função abre a janela de chat em uma versão minimizada. Chame-o no elemento df-messenger-chat-bubble para abrir o chat minimizado. Não faz nada se o chat já estiver minimizado.

Argumentos:

Nome Tipo Descrição
args objeto? Argumento opcional para configurar a conversa minimizada
args.anchor string? anchor opcional para configurar onde o chat minimizado está sendo aberto. Mesma lógica que o atributo anchor no elemento de balão de chat. O padrão é left-top.
args.showActorImages booleano? Flag opcional para mostrar imagens de atores (se especificadas no elemento df-messenger-chat-bubble). O padrão é "false".

Exemplo:

const dfMessengerChatBubble = document.querySelector('df-messenger-chat-bubble');
dfMessengerChatBubble.openMinChat({
  anchor: 'top-left'
});

closeMinChat

Fecha o chat minimizado. Chame-o no elemento df-messenger-chat-bubble para fechar o chat minimizado. Não faz nada se o chat já estiver fechado.

Exemplo:

const dfMessengerChatBubble = document.querySelector('df-messenger-chat-bubble');
dfMessengerChatBubble.closeMinChat();