---
sourceDocument: Interfaces conversacionais do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais do Xanadu

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Recursos da API Virtual Agent

# Recursos da API Virtual Agent {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

Você pode usar a API Virtual Agent para integrar muitos dos mesmos recursos que estão disponíveis em Virtual Agent e Bate-papo do agente em seu ambiente de bate-papo. O suporte ao recurso varia de acordo com a versão ServiceNow e o número da versão da aplicação da Store da API.

Para obter informações sobre os modelos de solicitação e de resposta para a API Virtual Agent, bem como exemplos de casos de uso comuns, consulte [API Virtual Agent Bot Integration](https://www.servicenow.com/docs/access?context=bot-api&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US).

## Principais recursos {#va-api-features__section_yps_1fc_qmb}

Os principais recursos na API Virtual Agent a partir da versão 1.0.9 incluem o seguinte:

* Autenticação de provedor usando autenticação estática, hash e baseada em token
* Vinculação automática de IDs de usuário a ServiceNow contas para uma experiência personalizada
* Virtual Agent transfere para um atendente em Bate-papo do agente
* Classificação de intenção em integrações de bot para bot por meio das seguintes estratégias:
  * O bot primário determina a intenção do usuário e envia a solicitação do usuário para Virtual Agent de maneira que o tópico correspondente seja exibido para o usuário.
  * O bot primário envia o enunciado do usuário para Virtual Agent de maneira que ele possa descobrir a intenção e retornar uma pontuação de confiança de previsão. Uma pontuação de confiança mais alta indica que o tópico previsto corresponde com mais precisão ao enunciado do usuário.
  {#va-api-features__ul_n2c_nfc_qmb}
{#va-api-features__ul_y2x_cfc_qmb}

## Recursos da versão 1.0.12 {#va-api-features__section_fxf_22h_kqb}

[Encerrar automaticamente conversas ociosas de bot para bot](https://servicenow-prod.fluidtopics.net/0F4faiWiazjMoZglG1Y9oQ "Em integrações de bot a bot (API do Virtual Agent), as conversas abandonadas que estão \"ociosas\" por mais de uma hora são encerradas automaticamente pelo trabalho agendado, Time Out Abandoned B2B Conversations. Este trabalho é executado por hora todos os dias.")
:   Você pode fechar automaticamente conversas que estão ociosas por mais de uma hora. O trabalho Time Out Abandoned B2B Conversations é executado por hora todos os dias e fecha automaticamente as conversas ociosas que os solicitantes abandonaram.

[Estados de conversa e códigos de motivo nos registros de interação do Virtual Agent](https://servicenow-prod.fluidtopics.net/rjxD6tMxWvyqfKgnw3u4nQ "Sempre que uma conversa do Virtual Agent ocorre, um registro de interação captura toda a conversa como um tipo de registro de bate-papo na tabela Interações [interaction]. O registro inclui todos os elementos de tópico usados na conversa, bem como as transferências para o atendente.")
:   Quando um usuário ou bot primário termina uma conversa, Virtual Agent registra o estado e os códigos de motivo nos registros de interação. Por exemplo, um usuário final pode digitar Finalizar para parar a conversa ou clicar no botão X para fechar o bate-papo.

Notificar quando uma conversa termina
:   O bot primário é notificado quando as conversas Virtual Agent ou Bate-papo do agente terminam. O bot primário também é notificado quando deve assumir o controle de uma conversa. Virtual Agent usa os seguintes sinalizadores:

    * completed: Enviado quando a conversa com Virtual Agent ou um atendente é encerrada.
    * takeControl: Enviado quando o bot primário deve assumir o controle. Isso normalmente ocorre quando Virtual Agent não pode determinar a intenção de conversa após duas tentativas consecutivas (o valor padrão). Você pode adicionar a propriedade do sistema va.bot.to.bot.take.control_times para alterar o número padrão de tentativas que Virtual Agent tenta determinar a intenção de conversa.

    {#va-api-features__ul_dqs_51h_kqb}

    Para obter mais informações, consulte [API Virtual Agent Bot Integration](https://www.servicenow.com/docs/access?context=bot-api&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US).

Mudanças com intenções
:
    * Compartilhe a pontuação de confiança da NLU para uma correspondência de intenção se a NLU estiver habilitada em Virtual Agent.
    * Permita que os usuários finais acessem diretamente um tópico com base na correspondência de intenção do bot primário.
    {#va-api-features__ul_gbx_mz3_kqb}

## Recursos da versão 1.3.0 {#va-api-features__section_aj4_22h_kqb}

A partir da versão 1.3.0, a API Virtual Agent oferece suporte ao registro em log como uma propriedade do sistema (va.bot.to.bot.logging_enabled).