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


---

# Adicione um controle personalizado a um Virtual Agentbloco de tópico ou tópico

# Adicione um controle personalizado a um Virtual Agentbloco de tópico ou tópico {#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

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

## Antes de Iniciar

Antes de iniciar esta tarefa:

* [Crie e publique a entrada personalizada ou o controle de resposta](https://servicenow-prod.fluidtopics.net/Wml31LfFeSdCtURG2wZYdw "Crie uma entrada personalizada ou um controle de resposta que os autores de tópicos possam usar em tópicos ou blocos de tópicos. Em Virtual Agentconversations, um controle de entrada reúne 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é TudoInterfaces conversacionaisVirtual AgentDesigner.
2. Na página inicial, selecione o tópico ao qual você adicionará o controle personalizado.
3. Em Fluxo Arraste o ícone Controle personalizado da seção Utilitários da paleta para a posição apropriada no fluxo de tópicos.  
   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. Selecione o 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 ativo de controle personalizado que foi publicado no 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. Selecione Salvar.
7. Para ver como o controle personalizado funciona no tópico, selecione Teste na barra de cabeçalho.  
   Seu tópico é executado em uma janela de teste de bate-papo.
8. Se nenhuma mudança adicional for necessária, selecione Publicar em Designer do Virtual Agentbarra de cabeçalho.
{#embed-custom-control__steps_pvw_zlv_2mb}

## Resultado

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