Configurar um AI Agents (Cognigy) Text Bot em Virtual Agent Hub

Use esta página para conectar um bot de texto AI Agents (Cognigy) a NiCE CXone por meio de Virtual Agent Hub. Quando você concluir este procedimento, NiCE CXone roteará as mensagens do cliente de um canal digital por meio de Studio e Virtual Agent Hub para o seu bot AI Agents (Cognigy), e retornará as respostas do bot para o contato. Essa integração oferece suporte a digital channels baseadas em texto, incluindo chat digital, WhatsApp, Apple Messages for Business, Facebook Messenger e SMS Messaging.

Esta página aborda somente integrações de bot de texto. Integrações de bot de Voz usam um método de backchannel SIP separado e exigem a assistência do representante de conta NiCE CXone. Não use este procedimento para configurar um bot de voz.

Como funciona a Integração do Text Bot

Quando um contato envia uma mensagem por meio de um canal digital, o NiCE CXone roteia a interação para um script do Studio. O script usa a TextBotExchange ação para encaminhar a mensagem ao AI Agents (Cognigy) por meio de Virtual Agent Hub. O AI Agents (Cognigy) processa a mensagem, identifica a intenção do contato e retorna uma resposta e um sinal de controle. O script então entrega a resposta ao contato ou age de acordo com o sinal de controle.

Fluxo de mensagem

A sequência a seguir descreve o fluxo de mensagens para cada turno em uma conversa com bot de texto:

  1. O contato envia uma mensagem por meio de um canal digital.

  2. O canal digital invoca a AskCaller ação para passar a mensagem para o script Studio.

  3. O script Studio encaminha a mensagem para a ação TextBotExchange.

  4. A ação TextBotExchange envia a mensagem para AI Agents (Cognigy) por meio do Virtual Agent Hub.

  5. AI Agents (Cognigy) processa a mensagem e gera uma resposta.

  6. O Virtual Agent Hub entrega a resposta e o sinal de controle de AI Agents (Cognigy) para a TextBotExchange ação.

  7. A TextBotExchange ação passa a resposta e o sinal de controle para o script Studio.

  8. O script Studio avalia o sinal de controle e determina a ramificação apropriada.

    1. Se a conversa continuar: o script Studio retorna à AskCaller ação, vá para a etapa 9.

    2. Se a tarefa estiver concluída ou se a escalação for necessária: O script Studio sai do loop do bot e continua com a próxima ação no script.

  9. A AskCaller ação entrega a resposta ao contato por meio do canal digital e aguarda a próxima mensagem. O fluxo se repete a partir da etapa 1.

    Isso se aplica somente à agência OnPromptAndCollectNextResponse.

Sinais de Controle Retornados por AI Agents (Cognigy)

Após cada turno, AI Agents (Cognigy) retorna um dos seguintes sinais de controle para a TextBotExchange ação. Seu script Studio deve lidar com cada sinal:

  • PromptAndCollectNextResponse: A conversa deve continuar. O script retorna à ação AskCaller para aguardar a próxima mensagem do contato.

  • OnReturnControlToScript: O agente virtual concluiu sua tarefa ou determinou que é necessário um agente ativo. O controle retorna ao script Studio. AI Agents (Cognigy) passa dados de escalação através docustomPayload, e o script do Studio os lê para determinar a próxima ação de roteamento. A prática recomendada é usar uma intenção de escalação que comece com escalat, para que o script possa detectar de forma confiável a escalação em diferentes nomes de intenção do bot, como "escalate" ou "escalation".

  • OnError: ocorreu um erro inesperado. O script segue o caminho de tratamento de erros. Verifique a variável _ERR e a propriedade de saída errorDetailsVarName para obter detalhes.

Pré-requisitos

Verifique se todos os pré-requisitos foram atendidos antes de iniciar este procedimento. Pré-requisitos ausentes são a causa mais comum de falhas de integração.

Requisitos do NiCE CXone

  • Virtual Agent Hub habilitado para sua unidade de negócios ou locatário. Contate seu TAM se Virtual Agent Hub não estiver disponível em seu sistema.

  • AI Agents (Cognigy) deve estar habilitado para o seu locatário NiCE CXone. Esse aplicativo é habilitado por um TAM ou pelos Serviços Profissionais. Se a opção AI Agents (Cognigy) não aparecer no menu do aplicativo, verifique se as funções e permissões apropriadas foram atribuídas. Se as permissões necessárias não estiverem disponíveis, isso significa que sua organização não está configurada para usar o AI Agents (Cognigy); nesse caso, entre em contato com seu TAM.

  • Visualizar, criar e editar Scripts - necessário para criar e modificar scripts do Studio.

  • Um canal digital configurado no CXone Digital Experience (DX). digital channels baseados em texto suportados, incluindo chat digital, WhatsApp, Apple Messages for Business, Facebook Messenger e SMS Messaging.

  • Um script do Studio configurado para um tipo DE mídia digital (ou permissão para criar um). Os tipos de script de Voz não oferecem suporte à ação TextBotExchange.

Requisitos do AI Agents (Cognigy)

  • Um projeto AI Agents (Cognigy) com um Fluxo totalmente configurado, treinado e pronto para implantação. A prática recomendada é que o Fluxo inclua respostas para, no mínimo, a intenção DE boas vindas e uma intenção DE tempo limite.

  • Permissão de edição em NiCE CXone para AI Agents (Cognigy) (mapeia para a função de Admin em AI Agents (Cognigy)), ou permissões AI Agents (Cognigy) suficientes para criar e gerenciar Endpoints.

  • Um entendimento do nome do projeto AI Agents (Cognigy) e do Fluxo que você deseja usar.

Configure a Integração AI Agents (Cognigy) Text Bot

Complete the following tasks in order. Each task depends on the results of the previous task.

  1. Recuperar credenciais do Terminal de AI Agents (Cognigy)

  2. Adicionar uma configuração em Virtual Agent Hub

  3. Criar ou abrir o script Studio para os canais Digital

  4. Configure a TextBotExchangeação

  5. Atribuir a configuração de Virtual Agent Hub à TextBotExchangeação

  6. Configurar Ramificações de resultado no script Studio

  7. Salvar, Validar e Publicar o Script Studio

  8. Testar a Integração do Text Bot