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


---

# Adicione um controle personalizado a um tópico ou bloco de tópicos Virtual Agent.

# Adicione um controle personalizado a um tópico ou bloco de tópicos 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

Adicione um controle personalizado a um tópico ou bloco de tópicos Virtual Agent. Durante a conversa, você pode coletar entradas do usuário ou exibir saídas para o usuário.

## Antes de Iniciar

Faça o seguinte antes de iniciar esta tarefa:

* [Crie e publique a entrada personalizada ou o controle de resposta](https://servicenow-prod.fluidtopics.net/tozvV_vNAikq4bDNJCyOWQ "Crie um controle de resposta personalizado que os autores do tópico possam usar em tópicos ou blocos de tópicos. Em conversas Virtual Agent, um controle de entrada coleta informações dos usuários finais, enquanto um controle de resposta exibe informações para os usuários finais.").
* Crie um tópico de chamada ou bloco de tópicos no qual o controle personalizado será incorporado.
{#embed-custom-control__ul_pdg_xq2_dmb}

Função necessária: virtual_agent_admin ou admin

## Procedimento

1. Navegar até TodosInterfaces conversacionaisVirtual AgentDesigner.
2. Na página Tópicos, clique no tópico ou no bloco de tópicos ao qual você adicionará o controle personalizado.
3. Na guia Fluxo, arraste o ícone Controle Personalizado da seção Utilitários da paleta para a posição apropriada no fluxo do tópico.  
   Nota:  
   Se você selecionou Disponível na paleta na página Propriedades do controle personalizado, o Controle personalizado é exibido como seu próprio ícone na seção Utilitários da paleta.
4. Clique no nó de controle personalizado.
5. No formulário, preencha os campos.  
   {#embed-custom-control__id_dst_y5v_1tb__entry__2}

   | Propriedade | Descrição |
   |-|-|
   | Controle personalizado | O nome de um objeto de controle personalizado que foi publicado em Designer do Virtual Agent. |
   | Nome do nó | O nome do controle personalizado que você selecionou. |
   | Mapeamento de entrada | As variáveis a serem usadas como entrada no controle personalizado. Por exemplo, a imagem a seguir tem exemplo de variáveis: O conteúdo desta área muda de acordo com o controle personalizado selecionado. As opções podem incluir entrada de cadeia de caracteres, registros referenciados, scripts e assim por diante. |
   | Mapeamento de saída | As variáveis a serem usadas como saída no controle personalizado. Por exemplo, a imagem a seguir tem exemplo de variáveis habilitadas: O conteúdo desta área muda de acordo com o controle personalizado selecionado. |
   | Avançado ||
   | Ocultar este nó ||
   | Usar este nó condicionalmente se | Uma declaração de condição sem código ou script de baixo código que especifica uma condição para apresentar este nó na conversa. A condição deve ser avaliada como verdadeira. |
   [Tabela 1. Planilha de propriedades do utilitário Controle personalizado]

   {#embed-custom-control__id_dst_y5v_1tb}
6. Clique em Salvar.
7. Para ver como seu controle personalizado funciona no tópico, clique em Teste na barra de cabeçalho.  
   Seu tópico é executado em uma janela de teste de bate-papo.
8. Se nenhuma mudança for necessária, clique em Publicar na barra de cabeçalho Designer do Virtual Agent.
{#embed-custom-control__steps_pvw_zlv_2mb}

## Resultado

O tópico está ativo. Você pode implantá-lo em seus clientes Virtual Agent.