Configure a Extensão de API TMS e Sinal no Fluxo AI Agents (Cognigy)

Depois de carregar a extensão, configure o Fluxo AI Agents (Cognigy) para capturar os metadados de SIP e a transcrição da conversa, e para enviar o sinal de controle correto para NiCE CXone no final de cada interação.

Quando você usa os modelos de script Studio fornecidos pelos Serviços Profissionais da NiCE CXone, os campos de sair da Interação são pré-preenchidos. Recomenda-se que você revise cada valor de campo para verificar se ele corresponde ao seu ambiente antes de testar.

Captura de Metadados SIP

  1. Em AI Agents (Cognigy), abra o Fluxo que você configurou para a integração do bot de voz.

  2. Selecione Fluxo Principal no seletor de fluxo na parte superior do editor de Fluxo se o projeto contiver múltiplos fluxos.

  3. Na ramificação Na Primeira Vez do Fluxo, clique no ícone + e adicione um nó Adicionar ao Contexto.

  4. Configure o nó Add to Context para armazenar a carga útil da solicitação SIP recebida:

    1. No campo chave Contexto, insira: sipBody

    2. No campo Valor, insira a expressão que é mapeada para o corpo da solicitação SIP recebida. NiCE CXone Os Serviços Profissionais confirmarão a expressão exata para o seu ambiente.

  5. Clique em Salvar Nó . A chave de contexto sipBody agora está disponível em todo o Fluxo para que o nó sair da Interação a referencie.

Adicionar Lógica do Bot de Voz

  1. Adicione ou verifique os nós de lógica do bot no Fluxo, como nós Say, nós Pergunta, manipuladores de intenção e substitutos de erro.

  2. Certifique-se de que o Fluxo inclua um caminho claro até a conclusão da interação (escalação ou encerramento) que se conecte ao nó Obter Transcrição e ao nó sair da Interação que você adicionará nas etapas a seguir.

Captura a transcrição da conversa

  1. Na ramificação Afterwards do Fluxo (ou imediatamente antes do nó sair da Interação), clique em + e adicione um nó Obter Transcrição.

  2. Configure o nó Get Transcript com as seguintes configurações:

    1. Armazenar localização

    2. Chave de entrada

      Para obter detalhes, consulte o tema Get Transcript node.

    3. Limite: Insira o número máximo de turnos de conversa a serem capturados. Um valor de 25 é adequado para a maioria das implantações.

  3. Clique em Salvar Nó. O nó Obter Transcrição captura a transcrição e a armazena na inserir variável de transcrição. O nó sair da interação lê essa variável e a envia para NiCE CXone TMS na próxima etapa.

    O nó Get Transcript captura a transcrição somente dentro do Fluxo. A transcrição não é enviada para NiCE CXone até que o nó sair da Interação seja executado na etapa seguinte.

Configure o Nó sair da Interação

  1. Após o nó Get Transcript, clique em + e selecione a aba Extensões .

  2. Na categoria CXone, selecione sair da Interação. O nó é adicionado ao Fluxo.

  3. Clique no nó sair da Interação e selecione Editar Nó.

  4. Configure os campos a seguir. Use a tabela abaixo para obter as descrições dos campos, os valores aceitáveis e o impacto de valores incorretos.

    Campo

    Descrição

    Impacto se estiver incorreto

    Ambiente Selecione a região do ambiente NiCE CXone que corresponde ao seu locatário. Selecione Outro se você usar uma URL base personalizada do NiCE CXone. Obrigatório. A seleção incorreta de região faz com que as solicitações da API Sinal falhem silenciosamente.
    URL base do ambiente A URL base para seu ambiente de API NiCE CXone. Por exemplo, https://cognigy-na1.nicecxone.com Necessário quando Ambiente estiver definido como Outro. Deve corresponder exatamente à região do locatário NiCE CXone.
    Ação de Handover Selecione Escalate to Agent para transferir o contato para uma fila DE espera de Agente em tempo real, ou selecione End Conversation para encerrar a interação. Obrigatório. Este é o sinal de controle primário enviado a NiCE CXone através da API de Sinal.
    Número da unidade de negócios Seu ID de unidade de negócios NiCE CXone. Normalmente mapeado a partir dos Cabeçalhos SIP. Por exemplo, {{context.sipBody.headers["X-InContact-BusNo"]}} Obrigatório. NiCE CXone usa esse valor para identificar o locatário correto. Um valor incorreto faz com que a autenticação da API Sinal falhe.
    Id do contato principal O id do contato NiCE CXone primário da interação. Mapeado a partir dos Cabeçalhos SIP. Por exemplo, {{context.sipBody.headers["X-InContact-ContactId"]}} Obrigatório. Identifica a interação de voz específica a ser escalada ou encerrada.
    Gerado Id do contato O id do contato gerado ou filho para o backchannel SIP. Mapeado dos Cabeçalhos SIP. Por exemplo, {{context.sipBody.headers["X-InContact-SpawnedId"]}} Obrigatório. Identifica a interação de backchannel associada ao contato principal.
    CXone Connection Objeto de conexão pré-configurado em AI Agents (Cognigy) que armazena as credenciais de autenticação de NiCE CXone. Criado e configurado por NiCE CXone Serviços Profissionais. Obrigatório. Se a conexão estiver ausente ou configurada incorretamente, todas as solicitações da Signal API e da TMS API serão rejeitadas.
  5. Clique em Salvar Nó.

  6. Repita essa configuração para cada caminho de saída no Fluxo que termina ou escalona a interação. Se você tiver tanto um caminho Escalonar para Agente quanto um caminho encerrar Conversa, adicione um nó saída de Interação separado a cada caminho e defina o campo Ação de Entregar conforme apropriado.