---
sourceDocument: Interfaces conversacionais de Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais de Yokohama

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Virtual Agent Recursos da API

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

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

Você pode usar o. Virtual AgentAPI para integrar muitos dos mesmos recursos que estão disponíveis em Virtual Agente. Bate-papo do agenteem seu ambiente de bate-papo. O suporte a recursos varia de acordo com seu ServiceNowE o número da versão do app Store da API.

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

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

Os principais recursos em Virtual AgentA API a partir da versão 1.0.9 inclui o seguinte:

* Autenticação do provedor usando autenticação estática, hash e baseada em token
* Vinculando automaticamente IDs de usuário a ServiceNowcontas para uma experiência personalizada
* Virtual Agent transferência 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 Agentpara que o tópico correspondente seja exibido ao usuário.
  * O bot primário envia o enunciado do usuário para Virtual Agentpara 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}

[Encerre automaticamente conversas ociosas de bot para bot](https://servicenow-prod.fluidtopics.net/6h9lpNbEzHOSBNl2X6V0SQ "Nas integrações de bot para 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 de hora em hora, todos os dias.")
:   Você pode encerrar automaticamente conversas que ficaram ociosas por mais de uma hora. . Time Out Abandoned B2B Conversationso trabalho é executado de hora em hora todos os dias e fecha automaticamente as conversas ociosas que os solicitantes abandonaram.

[estados da conversa e códigos de motivo nos registros de interação do Virtual Agent](https://servicenow-prod.fluidtopics.net/K~yNP_mtcLEJQCsiQOqRaQ "Cada vez que um Virtual AgentA conversa ocorre, um registro de interação captura toda a conversa na tabela Interações [Interação]. O registro inclui todos os elementos de tópico usados na conversa, bem como transferências do atendente.")
:   Quando um usuário ou bot primário encerra uma conversa, Virtual Agentregistra os códigos de estado e motivo nos registros de interação. Por exemplo, um usuário final pode digitar Fim para interromper a conversa ou clique em X botão para fechar o bate-papo.

Notificando quando uma conversa termina
:   O bot primário é notificado quando Virtual Agentou Bate-papo do agenteconversas encerradas O bot primário também é notificado quando precisa assumir o controle de uma conversa. Virtual Agentusa os seguintes sinalizadores:

    * completed: Enviado quando a conversa com Virtual Agentou um atendente está concluído.
    * takeControl: Enviado quando o bot primário precisa assumir o controle. Isso normalmente ocorre quando Virtual Agentnão é possível determinar a intenção da conversa após duas tentativas consecutivas (o valor padrão). Você pode adicionar va.bot.to.bot.take.control_timespropriedade do sistema para alterar o número padrão de tentativas que Virtual Agenttenta determinar a intenção da conversa.

    {#va-api-features__ul_dqs_51h_kqb}

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

Mudanças com intenções
:
    * Compartilhe a pontuação de confiança de NLU para uma correspondência de intenção se a NLU estiver habilitada em Virtual Agent.
    * Permita que os usuários finais saltem diretamente para 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, Virtual AgentA API oferece suporte ao registro em log como uma propriedade do sistema ( va.bot.to.bot.logging_enabled).