--- 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 --- # Integre controles personalizados # Integre controles personalizados {#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 Implemente e aproveite controles personalizados criados usando a estrutura de controle personalizada em sua integração. ## Antes de Iniciar Função necessária: virtual_agent_admin ou admin ## Por Que e Quando Desempenhar Esta Tarefa Mapeie controles personalizados para um canal do provedor. Implementar controles personalizados criados em Workflow Studio : Use o script de exemplo para implementar controles personalizados criados em Workflow Studio. Exemplo: Suporte a controles personalizados { uiType: "CustomControl", group: "DefaultCustomControl", name: "The name of the Custom Control (sys_cs_custom_control.name)", required: true/false, uxComponentDefinitionSysId: "seismicComponentId" // or null if not isInput: true/false, // whether to wait for a response value or if just output serializedControlData: "User defined JSON from generateControlData function"; } Exemplo: Script de controles personalizados (function execute(inputs, outputs) { var rich_controls = inputs.rich_control; //this is the data returned from the 'serialized control data function' defind in designer var serializedControlData = rich_control['serializedControlData']; // if this rich control will require a response to move forward in topic flow var isInput = rich_control['isInput']; // if the component is suggesting using a Seismic control (web) that handles this var uxComponentDefinitionId = rich_control['uxComponentDefinitionSysId']; // the name of the custom control var name - rich_control['name']; // 1) now perform some logic to transform this data into a custom ui (slack/facebook/sms ascii art/html/etc) // 2) attach to outputs, i.e. outputs.text_message='foo :)'; for sms twillio // basic flow is to take the serializedControlData/Name/compId(optional) and create a custom UI component here // that your client understands (i.e. a slack rich form payload) })(inputs, outputs); Implemente uma transformação específica do provedor de um controle personalizado : Você pode implementar uma transformação específica do provedor para cada controle personalizado usando Subtipo Na tabela Configuração do adaptador personalizado \[sys_cs_custom_adapter_config\]. Você pode publicar uma versão mais recente de um controle personalizado ou um controle pré-criado, ServiceNowcontrole personalizado, também conhecido como controle personalizado padrão, se necessário. Isso envolve a publicação da Entrada e Saída apropriada Workflow StudioScripts de ação e atualização da configuração na tabela Configuração do adaptador personalizado \[sys_cs_custom_adapter_config\]. * Se você estiver publicando sua própria versão de um ServiceNowControle personalizado, substitua o registro de controle personalizado na tabela Configuração do adaptador personalizado com seus próprios nomes de script de ação de entrada e saída. * Apenas um registro com o mesmo Subtipo é permitido. Se o mesmo controle personalizado for implementado por duas partes diferentes, somente um poderá atualizar o registro existente com novos transformadores de entrada e saída. {#ccif-integrate-custom-controls__ul_z22_lcx_fqb} Nota: Depois de substituir um registro de controle personalizado existente, o sistema usará a nova versão do controle personalizado. Por exemplo, os scripts de transformação podem transformar vários controles personalizados, como Seletor de tempo e Autenticação. Se você adicionar um controle Seletor de horas com diferentes transformações de entrada e saída, o controle Seletor de horas mais recente será usado. Não é possível reverter para a versão original do controle personalizado. ## Procedimento 1. Navegue até Todos e, em seguida, insira sys_cs_custom_adapter_config.list no filtro. 2. Selecione Novo. 3. No formulário, preencha os campos. {#ccif-integrate-custom-controls__table_zbd_nsp_b4b__entry__2} | Campo | Descrição | |-|-| | Provedor | O nome do identificador de canal da sua integração de bate-papo personalizada. Para obter detalhes, consulte [Crie um identificador de canal para sua integração de bate-papo personalizada](https://servicenow-prod.fluidtopics.net/IL9hHqk8OOC9R5mC76ynyQ "Crie um identificador de canal para sua integração de bate-papo personalizada na tabela Identidades de canal do provedor [sys_cs_provider_application]."). | | Tipo de controle | Selecione o controle personalizado que você projetou. Para controles personalizados, o tipo é sempre DefaultCustomControl. Para saber mais sobre controles personalizados, consulte [Personalizando Virtual Agentcom controles personalizados](https://servicenow-prod.fluidtopics.net/pKlF_ciFq0WEdKD~KXbiBA "Os controles personalizados são componentes que ServiceNowos desenvolvedores podem criar para uso em Virtual Agentblocos de tópicos ou tópicos. Esses controles incluem controles deslizantes ou players de vídeo. Os controles personalizados complementam os controles fornecidos em Designer do Virtual Agent."). | | Subtipo | Nome do controle personalizado. | | Ação do transformador de entrada | Nome do script de ação do transformador de entrada para este controle avançado, como sn_va_sms_twilio.va_sms_twilio_adapter_input_text_inbound_transformer. | | Ação de transformação de saída | Nome do script de ação do transformador de saída para este controle avançado, como sn_va_sms_twilio.va_sms_twilio_adapter_input_text_outbound_transformer. | [Tabela 1. Formulário Configurações do adaptador personalizado] {#ccif-integrate-custom-controls__table_zbd_nsp_b4b} 4. Selecione Enviar.