---
sourceDocument: Yokohama Administração da Now Platform
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-administration

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Administração da Now Platform

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# Integre com um provedor de serviços de tradução

# Integre com um provedor de serviços de tradução {#ariaid-title1}

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

Integre com um provedor de tradução terceirizado de sua escolha para tradução automática de texto gerado pelo usuário.

## Antes de Iniciar

Crie uma conexão e credenciais para integração com seu provedor de serviços de tradução terceirizado.

Função necessária: administrador

## Procedimento

1. Navegar até TudoAutomação de ProcessoWorkflow Studio, em seguida, selecione Novo para criar subfluxos para detectar o idioma do texto de entrada e traduzir o texto de entrada, bem como ações, usando a orientação a seguir.  
   Para obter informações, consulte [Estúdio de fluxo de trabalho](https://www.servicenow.com/docs/access?context=workflow-studio&version=yokohama&pubname=yokohama-build-workflows&ft:locale=en-US).
   1. Mapeie códigos de erro do seu provedor de tradução automática para os códigos de erro e mensagens de erro padronizadas compatíveis com ServiceNow.  
      {#integrate-translation-service-provider__table_h11_vkk_33b__entry__2}

      | Código de erro | Mensagem de erro |
      |-|-|
      | 40050 | Código de erro para preencher mensagens de erro do provedor de tradução automática em vez de mensagens de erro padronizadas. |
      | 40051 | Ocorreu um erro desconhecido. |
      | 40052 | O texto (campo "texto") excedeu o tamanho máximo. |
      | 40053 | O idioma de origem é inválido. |
      | 40054 | O idioma de destino é inválido. |
      | 40055 | A solicitação não está autorizada porque as credenciais estão ausentes ou são inválidas. |
      | 40056 | O texto não pode ser traduzido para os idiomas de destino. |
      [Tabela 1. Códigos de erro padrão e mensagem]

      {#integrate-translation-service-provider__table_h11_vkk_33b}
   2. Certifique-se de que os campos de entrada e saída estejam no seguinte formato para subfluxos.  
      Nota:  
      Ao criar subfluxos, você pode consultar os subfluxos que estão disponíveis por padrão, se necessário. Por exemplo: Detectar idioma \[detect_language_v4\] e Traduzir texto \[translate_text_v3\]. Para obter mais informações, consulte [Migre configurações personalizadas do tradutor para fluxos v4](https://servicenow-prod.fluidtopics.net/IzfetYqeJlt6NCQvjF8Tjw "Migre suas configurações de tradutor personalizadas para fluxos v4. A versão 4 flui para Tradução dinâmicaestão disponíveis no XanaduVersão do patch 3.").
      {#integrate-translation-service-provider__table_z5q_q5t_23b__entry__3}

      | Nome do campo | Descrição | Tipo |
      |-|-|-|
      | Entradas |||
      | textos | Textos de entrada cujo idioma deve ser detectado. A versão v3 oferece suporte à deteção em massa (deteção de entrada de vários textos em uma única cadeia de caracteres). Com o. XanaduVersão do patch 3, compatível com a versão v4 [Estrutura de exclusão](https://servicenow-prod.fluidtopics.net/DEIXxcCyzCDbVGK5fl6haw "Preserve texto, como nomes de produtos ou termos técnicos, durante a tradução automática. Com Estrutura de exclusãoem Tradução dinâmica, você pode especificar palavras e padrões que não devem ser traduzidos.")e detecção em massa. | Array.String |
      | Saídas |||
      | detecções | Informações sobre o código e a confiança dos idiomas detectados pelo tradutor e suas respetivas alternativas, códigos de erro e mensagens de erro. * Código: Código do idioma detectado conforme especificado pelo provedor de serviços de tradução. * Confiança: Valor que indica a confiança no resultado. O valor está entre zero e um. Um valor baixo indica uma confiança baixa. {#integrate-translation-service-provider__ul_glg_kh3_h3b} Por exemplo, texto em francês com confiança de 0,93 { 'code' : 'fr',  'confidence' : '0.93'  } Para obter mais informações, consulte a seção getDetectedLanguages de [DynamicTranslation - com escopo](https://www.servicenow.com/docs/access?context=DynamicTranslation&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US). | Objeto.Matriz. Cada elemento do objeto é um valor de cadeia de caracteres. |
      [ ]

      {#integrate-translation-service-provider__table_z5q_q5t_23b}  
      {#integrate-translation-service-provider__table_cgx_ntt_23b__entry__3}

      | Nome do campo | Descrição | Tipo |
      |-|-|-|
      | Entradas |||
      | textos | Textos a serem traduzidos. A versão v3 e superior suporta tradução em massa (tradução de entrada de vários textos em uma única cadeia de caracteres). | Array.String |
      | target_languages | Matriz de códigos de idioma para os quais o texto precisa ser traduzido. Por exemplo, ['fr','it'] | Cadeia de caracteres da matriz. Cada elemento da matriz é um valor de cadeia de caracteres. |
      | source_language | Código do idioma do texto de origem. Por exemplo, en | Cadeia de caracteres |
      | additional_parameters | Matriz de parâmetros adicionais. Por exemplo, [{'parameter_name': 'textType', 'parameter_value': 'html'}] | Objeto.Matriz. Cada elemento da matriz é um objeto com valores de cadeia de caracteres. |
      | Saídas |||
      | traduções | Textos traduzidos nos idiomas de destino especificados. Cada elemento da matriz é um objeto que contém o idioma de destino e o texto traduzido. Por exemplo, [ {'target_language':'fr', 'translated_text':'Bonjour'}, {'target_language':'it', 'translated_text':'ciao'} ] Para obter mais informações, consulte a seção getTranslations de [DynamicTranslation - com escopo](https://www.servicenow.com/docs/access?context=DynamicTranslation&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US). | Objeto.Matriz. Cada elemento da matriz é um objeto com valores de cadeia de caracteres. |
      | status | Status da solicitação. | Escolha |
      [Tabela 2. Traduza subfluxo]

      {#integrate-translation-service-provider__table_cgx_ntt_23b}  
      Nota:  
      Certifique-se de que Executar como o campo está definido como Usuário que inicia a sessão nas propriedades de fluxo.
   {#integrate-translation-service-provider__substeps_fpk_1lk_33b}
2. [Crie uma configuração de tradutor personalizada](https://servicenow-prod.fluidtopics.net/m~1PHIfKpO0nw276he7F3g "Configurar Tradução dinâmicapara um provedor de tradução automática terceirizado de sua escolha.")Para o provedor de serviços na tabela Configurações do tradutor e defina o registro como ativo.  
   Ao criar o registro na tabela Configurações do tradutor, pesquise os subfluxos criados na etapa anterior. .
3. **Opcional:** Se sua instância estiver ativada XanaduPatch 3 ou superior, e você pretende usar Estrutura de exclusão, Insira os marcadores de exclusão do provedor de tradução na tabela de padrões do provedor de exclusão.  
   Consulte a documentação do seu provedor para obter esses marcadores. Para obter mais informações sobre como inserir marcadores, consulte [Adicione um padrão de provedor de exclusão](https://servicenow-prod.fluidtopics.net/_yI9BTjoSb8VBZrtuvpNRA "Como parte da configuração de Estrutura de exclusãoem Tradução dinâmica, insira os marcadores usados pelo provedor de tradução para marcar o texto que não deve ser traduzido automaticamente.").
4. **Opcional:** Crie um mapeamento de código de idioma para associar os códigos de idioma do seu provedor ServiceNowcódigos de idioma.  
   Para obter mais informações, consulte [Crie um mapeamento de código de idioma](https://servicenow-prod.fluidtopics.net/C7bjXIPRoVvO93IVeUXrxA "Crie um mapeamento de código de idioma para mapear o. ServiceNowcódigos de idioma com os códigos de idioma dos provedores de serviços de tradução.").

## O que Fazer Depois

Para obter informações sobre APIs, consulte [API DynamicTranslation](https://servicenow-prod.fluidtopics.net/6LmdK1lT9eLLa4a8Um2F5w "Você pode usar o. Tradução dinâmica API para traduzir texto em tempo real em vários idiomas usando provedores de serviços de tradução.").
* **[Crie uma configuração de tradutor personalizada](https://servicenow-prod.fluidtopics.net/m~1PHIfKpO0nw276he7F3g)**   
  Configurar Tradução dinâmicapara um provedor de tradução automática terceirizado de sua escolha.

