---
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


---

# Instale o. Virtual AgentAPI

# Instale o. Virtual AgentAPI {#ariaid-title1}

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

Instale o. Virtual AgentApp de API para integrar qualquer interface de bate-papo ou um bot ServiceNow® Virtual Agentou Bate-papo do agente.

## Antes de Iniciar

Se você estiver fazendo upgrade de uma versão anterior à versão 2 e se a autenticação for necessária para sua instância, será preciso reverter a personalização antes de fazer upgrade. Para essas versões, o upgrade ignora o serviço REST com script quando a autenticação está ativada. Para obter mais informações, consulte [Revert a customization](https://www.servicenow.com/docs/access?context=uc-revert-customization&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).  
Você deve atender aos seguintes requisitos:

* Certifique-se de que a aplicação e todas as suas aplicações ServiceNow Store associadas tenham direitos válidos ServiceNow. Para obter mais informações, consulte [Obter direito para um ServiceNow produto ou aplicação](https://store.servicenow.com/$appstore.do#!/store/help?article=KB0030186).
* Revise o. [Virtual Agent API](https://store.servicenow.com/sn_appstore_store.do#!/store/application/62c44c6353311010ad77ddeeff7b120c/3.8.1?referer=/store/search?listingtype=allintegrations%253Bancillary_app%253Bcertified_apps%253Bcontent%253Bindustry_solution%253Boem%253Butility%253Btemplate%253Bgenerative_ai&q=virtual%20agent%20api&sl=sh)lista de aplicações no ServiceNow Storepara obter informações sobre dependências, requisitos de licenciamento ou assinatura e compatibilidade de versões.
* Certifique-se de ativar o Glide Virtual Agent(com.glide.cs.chatbot), que ativa o plug-in Integração de bate-papo personalizado conversacional (com.glide.cs.custom.adapter).

  Para obter mais informações sobre este plug-in, consulte [Ativar Virtual Agent](https://servicenow-prod.fluidtopics.net/x29DHiAyrn8MG9RIcUUskA "Você pode ativar o plug-in Glide Virtual Agent (com.glide.cs.chatbot) se tiver a função de administrador. Este plug-in ativa automaticamente outros plug-ins necessários se eles ainda não estiverem ativos.").
{#install-virtual-agent-api__ul_q4g_55s_qmb}  
Nota:  
. Virtual AgentA API requer uma licença Pro semelhante à de Virtual Agent.

Função necessária: admin ou virtual_agent_admin

## Por Que e Quando Desempenhar Esta Tarefa

A tabela Controle de bot para bot \[sys_cs_bot_to_bot_control\] é instalada com o. Virtual AgentAPI. Esta tabela rastreia o número de vezes que uma determinada tarefa em um tópico é executada. Você pode usar esta tabela para depuração. Por exemplo, use-o para determinar se Virtual Agentestá preso em um determinado controle ou tópico.

## Procedimento

1. Navegar até TudoAplicações do sistemaTodas as aplicações disponíveisTudo.  
2. Encontre o. Virtual AgentAplicação de API usando os critérios de filtro e a barra de pesquisa.  
   Você pode pesquisar a aplicação pelo nome ou ID. Se você não conseguir encontrar a aplicação, talvez seja necessário solicitá-la ao ServiceNow Store.

   Acesse o site [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as [ServiceNow Store notas de versão do histórico de versão](https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html).
3. Escolha uma versão na lista e selecione Instalar.  
   Na caixa de diálogo Instalar exibida, todas as dependências instaladas junto com a aplicação são listadas.{#install-virtual-agent-api__p_id1_nfg_h1c}
4. Se for solicitado, siga os links para ServiceNow Store e obtenha direitos adicionais para as dependências.
{#install-virtual-agent-api__steps_t4g_55s_qmb}

## O que Fazer Depois

[Revise o endpoint REST de entrada e configure a autenticação de entrada](https://servicenow-prod.fluidtopics.net/oxZ2GnMEPMHrPdf0zTOwBA "Depois de instalar o. Virtual AgentAPI, navegue até o recurso REST API com script para revisar o endpoint e configurar a autenticação.")