Internacionalização — Localização da Action

Você desenvolveu uma Action que proporciona uma experiência incrível para os usuários. O único problema é que ela está disponível apenas para quem fala o idioma em que foi escrita. Isso impede que muitos outros usuários possam aproveitar tudo o que você desenvolveu. Então, como você pode fazer para que sua Action esteja acessível a todos? Localizando-a!
O que é localização?
Localização é onde as experiências da sua Action são personalizadas para idiomas e localidades diferentes. Veja exemplos de uma frase de boas-vindas de uma Action do GDG São Francisco em idiomas diferentes:
“Bem-vindo ao GDG São Francisco. Posso falar sobre...”
“Benvenuto a GDG San Francisco. Posso darti informazioni…”
“Bienvenidos a GDG San Francisco. Puedo contarte sobre…”
“Willkommen bei der GDG San Francisco. Ich kann dir mehr über unsere…”
Confira os idiomas e as localidades compatíveis com o Actions on Google atualmente.
Motivos para localizar
  • Disponibiliza sua Action para mais usuários!
  • Personalize e mude totalmente a experiência do usuário com base no idioma usado.


  • Por meio do Programa da comunidade de desenvolvedores do Google Assistente, você pode conquistar o marco Taking your Action Global (Globalize sua Action). Para isso, sua Action precisa estar disponível em pelo menos dois idiomas (um deles deve ser uma variante diferente do inglês) e ter uma quantidade mínima de usuários envolvidos nos dois idiomas.
Como localizar sua Action
Consulte a documentação para saber como localizar sua Action. Também incluí essas informações abaixo como um guia para Actions que usam o Dialogflow e um webhook (confira este exemplo de código para ver o tipo de projeto a que me refiro).
  1. Você precisa começar com uma Action ativa e robusta que esteja pronta para ser localizada. O ideal é que a Action já tenha sido implantada, porque isso garante que ela seja aprovada pelo processo de revisão.
  2. Traduza o texto todo da Action para estes idiomas:
  • Respostas das Actions
  • Frases de treinamento para cada intent
  • Entidades personalizadas
  • Informações do diretório da Action
  • Seção de descrição (curta e completa)
  • Exemplos de invocações
  • Política de Privacidade
  • Termos de Serviço (opcional)
Esta é a parte mais demorada, porém a mais importante. O ideal é que falantes nativos traduzam o texto e façam testes para saber como é a persona da Action.
3. Atualize seu código de atendimento para dar suporte a vários idiomas. Use uma biblioteca de cliente que seja compatível com o i18n (internacionalização). Para estruturas diversas, existem muitas bibliotecas diferentes que são compatíveis com ele, escolha uma que funcione para você.
4. Adicione novos idiomas aos agentes do Dialogflow por meio do console do Dialogflow.
  • Adicione idiomas ao seu agente. Isso copiará seus intents para cada idioma novo.
  • Adicione frases de treinamento, respostas e entradas de entidade traduzidas para cada novo idioma.
5. Adicione idiomas ao console do Actions on Google
  • Adicione idiomas à Action, acessando a página Configuração do projeto por meio do ícone de engrenagem ao lado da seção Visão geral. Clique em Idiomas, onde você poderá adicionar todos os idiomas.


6. Teste a Action no console do Actions.
7. Atualize a Action no console do Actions on Google adicionando as informações do diretório traduzidas para cada idioma:
  • Descrição (curta e completa)
  • Exemplos de invocações
  • Política de Privacidade
  • Termos de Serviço (opcional)
8. Enviar para lançamento!
  • É recomendável usar a versão Beta porque ela passa pelo mesmo processo de revisão de lançamento. Depois de aprovado, você poderá liberar o projeto para lançamento quando quiser.
Pode parecer muito trabalho, mas assim que você traduzir sua Action para outro idioma, as outras serão superfáceis! Reserve um tempo para expandir sua Action em vários idiomas para que mais usuários a usem.
Quer mais? Entre na comunidade do Actions on Google para conversar sobre Actions com outros desenvolvedores. Participe do programa da comunidade de desenvolvedores do Actions on Google e concorra a US$ 200 mensais em créditos do Google Cloud e uma camiseta do Assistente ao publicar seu primeiro app.