VOICEBOT STREAM

Esta página de ajuda é para Studio. Estas informações também estão disponíveis para Desktop Studio.

Icon of a smiling robot head

Integra um agente virtual de autoatendimento com Scripts de voz usando um fluxo contínuo de áudio da plataforma. Esta ação permite que NiCE CXone use áudio em streaming com SIPClosed Protocolo usado para sinalização e controle de sessões de comunicação multimídia, como chamadas de voz e vídeo.conexões.

Esta ação não permite alterar o comportamento DO agente virtual entre turnos. Você só precisa de uma instância desta ação em seu script.

Ao clicar em Abrir editor nas propriedades desta ação, Virtual Agent Hub opções. As únicas opções de provedor que você vê são aquelas que oferecem suporte à telefonia personalizada. Atualmente, o único provedor compatível é Google Dialogflow CX VoiceStream. Você pode abrir Virtual Agent Hub na plataforma NiCE CXone para ver outros provedores disponíveis em seu sistema.

Dependências

Esta ação é destinada somente ao uso com o Google Dialogflow CX VoiceStream agente virtualClosed Um aplicativo de software que gerencia as interações com clientes no lugar de um agente humano ao vivo.. Use esta ação em vez da ação VOICEBOT EXCHANGE para integrações com Dialogflow CX VoiceStream.

Tipos de script com suporte

Icon of purple telephone handset

Telefone

Propriedades de Entrada

Estas propriedades definem dados que a ação usa durante a execução.Você pode usar substituição de variável em todas as propriedades desta ação.

Propriedade

Descrição

Adicionar legenda

Insira uma frase curta que identifique exclusivamente esta ação no script. A legenda aparece na tela do script no ícone da ação.

virtualAgentId ```

O nome do agente virtual selecionado no Virtual Agent Hub. Quando você atribui um aplicativo de agente virtual a uma ação Studio no Virtual Agent Hub, ele preenche automaticamente esta propriedade. O nome é o valor usado no campo Virtual Agent (Bot) Name no aplicativo Virtual Agent Hub. Você pode usar substituição de variável nesta propriedade.

```
Custom Payload to Bot

A variável que armazena a carga útil personalizada a ser enviada ao agente virtualClosed Um aplicativo de software que gerencia as interações com clientes no lugar de um agente humano ao vivo..

Digite o nome do objeto JSON que passa dados do script para o agente virtual. Você deve definir o objeto de carga útil personalizada em uma ação Snippet. O objeto deve ser convertido em JSON, seja no snippet ou na propriedade customPayload.

Não use essa propriedade se precisar processar dados que o agente virtual retorna ao script. Em vez disso, use a variável customPayloadVarName (out).

Intenção inicial

A primeira intençãoClosed O significado ou a finalidade por trás do que um contato diz/digita; o que o contato deseja comunicar ou realizar. que a ação envia ao agente virtualClosed Um aplicativo de software que gerencia as interações com clientes no lugar de um agente humano ao vivo..

Propriedades de saída

As propriedades contêm variáveis que armazenam dados retornados pela execução da ação. Elas estão disponíveis para referência e uso quando a ação é concluída.

Propriedade

Descrição

``` CustomPayloadFromBotVarName (out) ```

Esta variável contém a carga útil personalizada retornada pelo agente virtualClosed Um aplicativo de software que gerencia as interações com clientes no lugar de um agente humano ao vivo..

ErrorDetailsVarName (out)

Quando a ramificação Error é adotada, esta variável contém todos os detalhes associados ao erro.

Condições de ramificação de Resultado

As condições de ramificação de resultado permitem que você crie ramificações no seu script para tratar diferentes resultados quando uma ação é executada.

Condição

Descrição

Padrão

Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.

OnContained

O ramo taken quando a interação com o agente virtual é concluída com êxito.

Error During Session

Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.

On Escalate

A ramificação taken quando a interação é escalada para um agente humano.

On Failed to Initialize

O branch seguido quando o perfil nomeado em virtualAgentID tem as credenciais incorretas ou o perfil de agente virtual incorreto é selecionado.

Práticas recomendadas para Carga útil personalizada com Dialogflow CX VoiceStream

Ao usar esta ação com Dialogflow CX VoiceStream, siga estas práticas recomendadas para integrar cargas úteis personalizadas:

  • Você pode passar dados personalizados para Dialogflow CX usando pares de chave-valor JSON. Em uma Snippet ação no seu script, crie um objeto dinâmico customPayload e adicione os pares de chave-valor a ele. Por exemplo:

    DYNAMIC customPayload
    customPayload.ani = ani
    customPayload.contactID = contactId
    customPayload.masterContactId = masterId
    customPayloadJSON = "{customPayload.asJSON()}"	
  • Na ação VoiceBOT STREAM ação do seu script, configure a propriedade customPayload com uma variável que tenha a função asJSON() em seu valor. Você pode encontrar essa variável no objeto customPayload.
  • Transmita a customPayload JSON para o agente virtual usando a propriedade Payload de QueryParameters. Consulte a documentação de Google sobre QueryParameters A square with an arrow pointing from the center out from the top right corner. para Google Dialogflow CX.
  • Dados transmitidos por meio de QueryParameters são recebidos por um webhook em Dialogflow CX.Você pode escrever código no console CX Dialogflowpara manipular os dados passados.
  • Não aninhe um objeto dentro do objeto customPayload. Os objetos são enviados como strings literais.
  • Para passar dados personalizados do seu agente virtual Dialogflow CX de volta para o script, use o campo Carga útil personalizada no console Dialogflow CX.Verifique se você está no console do agente virtual que está usando NiCE CXone. Mapeie isso para seu script usando a variável customPayloadVarName (out) na ação VOICEBOT STREAM em seu script.
  • Para passar dados personalizados para o Dialogflow CX a partir do script, use session_params no objeto customPayload em uma ação Snippet. Por exemplo:

    DYNAMIC customPayload
    customPayload.session_params.name = "Winnie le Pooh" 
    customPayload.session_params.job = "Food critic" 
    customPayload.session_params.location = "Hundred Acre Wood"	

    Acesse os parâmetros de sessão no intent do agente CX Dialogflow usando a seguinte sintaxe:

    $session.params.name = Winnie Le Pooh
    $session.params.job = Food critic
    $session.params.location = 100 Acre Wood 

    Os parâmetros de sessão são usados apenas com agentes virtuais Dialogflow CX. Para obter um resultado semelhante com Dialogflow ES, use contextos.

  • Configurar dicas de contexto de fala e um ID de conversa personalizado para transferir a conversa para um agente virtual Dialogflow CX diferente no snippet Carga útil personalizada .

  • Para configurar por quanto tempo o agente virtual aguarda quando o contato faz uma pausa ao falar, adicione o maxPostEnergySilenceMS parâmetro à Next Prompt Behaviorsou Default Next Prompt Behaviors Snippet ação.