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


---

# Instale a API Virtual Agent

# Instale a 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) 1 min. de leitura

Instale o app API Virtual Agent para integrar qualquer interface de chat ou um bot com ServiceNow® Virtual Agent ou Bate-papo do agente.

## Antes de Iniciar

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

* Certifique-se de que o aplicativo e todos os seus aplicativos ServiceNow Store associados tenham direitos válidos ServiceNow. Para obter mais informações, consulte [Obter direito para um produto ou aplicativo do ServiceNow](https://store.servicenow.com/$appstore.do#!/store/help?article=KB0030186).
* Confira a lista de aplicações da [API do Virtual Agent](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) em ServiceNow Store para obter informações sobre dependências, requisitos de licenciamento ou assinatura e compatibilidade de lançamento.
* Certifique-se de ter ativado o plug-in Glide Virtual Agent (com.glide.cs.chatbot), que ativa o plug-in Conversational Custom Chat Integration (com.glide.cs.custom.adapter).

  Para obter mais informações sobre este plug-in, consulte [Como ativar Virtual Agent](https://servicenow-prod.fluidtopics.net/gL_Yh6m_ZsFF7oq1l6vwjA "É possível ativar o plug-in Glide Virtual Agent (com.glide.cs.chatbot) se você tiver a função de administrador. Este plug-in ativa automaticamente outros plug-ins necessários, caso ainda não estejam ativos.").
{#install-virtual-agent-api__ul_q4g_55s_qmb}  
Nota:  
A API Virtual Agent 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 de controle de bot para bot \[sys_cs_bot_to_bot_control\] é instalada com a API Virtual Agent. Esta tabela rastreia o número de vezes que uma tarefa específica em um tópico é executada. Você pode usar esta tabela para depuração. Por exemplo, use-o para determinar se Virtual Agent está travado em um controle ou tópico específico.

## Procedimento

1. Navegue até TodasAplicações do sistemaTodas as aplicações disponíveisTodas.  
2. Encontre a aplicação da API Virtual Agent 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/RNA_e5nsQ_A0vkZX42oVdg "Depois de instalar a API Virtual Agent, navegue até o recurso de API REST de script para revisar o endpoint e configurar a autenticação.")