> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modelos de email localizados

> Crie modelos de email do PlayFab com várias versões traduzidas em uma única ID de modelo para que os jogadores recebam emails de conta no idioma de preferência.

O PlayFab está introduzindo o suporte ao armazenamento de cadeias de caracteres localizadas em nome dos desenvolvedores de jogos. Além disso, estamos adicionando a lógica necessária para fornecer aos seus jogadores as cadeias de caracteres corretas para o idioma de preferência deles.

Este tutorial mostra como usar modelos de email localizados. Com os modelos de email localizados, você pode criar várias versões traduzidas de um email e associar *todas* elas a uma única ID de modelo.

<Note>
  Todos os modelos criados antes do lançamento deste recurso manterão seu comportamento. No entanto, você pode atualizá-los facilmente para usar o novo formato localizado usado pelos novos modelos de email.
</Note>

## Requisitos

Este é um tutorial *avançado*. Verifique se todos os requisitos foram atendidos; caso contrário, você *não* conseguirá concluir este tutorial.

* Para obter uma introdução aos modelos de email, consulte o tutorial [Usar modelos de email para enviar um email de recuperação de conta](/pt-BR/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email).
* Revise as informações sobre como trabalhar com idiomas padrão no seu título e com os idiomas preferenciais dos seus jogadores no tutorial [Definir idiomas padrão](/pt-BR/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages). Você precisa ter um idioma padrão de título definido para continuar com os modelos de email localizados.

## Atualizar um modelo de email existente

A primeira coisa que faremos é atualizar o modelo de email de recuperação de conta existente que criamos no tutorial [Usar modelos de email para enviar um email de recuperação de conta](/pt-BR/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email) mencionado acima.

1. Selecione **Content** no menu à esquerda.
2. Acesse a guia **Email Templates**.
3. Vá para o campo **Template name** e selecione o modelo **Account Recovery**.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/game-manager-content-edit-email-template.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=3ceed3a457f45f85944bb701147296a8" alt="Game Manager: Content: Email Templates: editar modelo de email" width="1366" height="1256" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/game-manager-content-edit-email-template.png" />

Para os fins deste tutorial, vamos supor que o idioma padrão do seu título seja o inglês. Você verá que a versão existente do modelo aparece como a versão no idioma padrão.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-default-language.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=73a86502d9ea115d84cc067bc0de8eff" alt="Editar modelo de email: assunto e corpo: idioma padrão" width="989" height="1128" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-default-language.png" />

Adicionar mais idiomas é tão simples quanto selecionar o link **+ ADD LANGUAGE** fornecido, escolher o idioma que você deseja adicionar ao modelo e digitar as cadeias de caracteres localizadas.

Neste exemplo, vamos adicionar as seguintes cadeias de caracteres em francês ao nosso modelo existente.

Assunto do email em francês:

```html theme={null}
Réinitialisation du mot de passe demandée
```

Corpo do email em francês:

```html theme={null}
<head></head>
<body><p>Vous avez récemment demandé un mot de passe avec nous. </p>
<p>Cliquez <a href="$ConfirmationUrl$">ici</a> s'il vous plaît pour être dirigé vers une page pour réinitialiser votre mot de passe.
```

Veja como deve ficar:

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-french-language.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=dfb61a203ed9ae23c1392bfb93c6247f" alt="Editar modelo de email: assunto e corpo: idioma francês" width="981" height="1759" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-french-language.png" />

Ao selecionar o botão **SAVE EMAIL TEMPLATE**, você será redirecionado de volta à página que contém a lista dos seus modelos de email.

Como você pode ver, uma nova versão de idioma foi adicionada, mas um novo modelo *não* foi adicionado, pois todas as versões de idioma são armazenadas na mesma ID de modelo.

## Enviar emails localizados

Em seguida, enviaremos nossa nova versão localizada do email. Conforme mencionado no tutorial [Definir idiomas padrão](/pt-BR/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages), o PlayFab faz o trabalho pesado de corresponder os idiomas compatíveis do seu título ao idioma preferencial dos seus jogadores. Tudo o que você precisa fazer é nos dizer para enviar o email.

Para verificar esse comportamento, crie dois jogadores de teste.

Deixe um dos novos jogadores sem idioma preferencial. Isso demonstrará como o PlayFab recorre ao idioma padrão do título se não houver idioma especificado ou se não houver correspondência entre o idioma do título e o idioma do jogador.

Defina o idioma do *outro* novo jogador usando o Game Manager ou a API [SetProfileLanguage](xref:titleid.playfabapi.com.profiles.accountmanagement.setprofilelanguage). Usamos o francês neste exemplo.

<Note>
  Ao usar a API `SetProfileLanguage`, a cadeia de caracteres de idioma deve ser especificada no formato ISO 639-1 (por exemplo, "en", "es" ou "ja"). No momento, o código "zh" não tem suporte.
</Note>

Antes de continuar para a próxima etapa, verifique se você definiu o email de contato nos dois jogadores, conforme explicado na [Etapa 2 do tutorial Usar modelos de email para enviar um email de recuperação de conta](/pt-BR/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email#step-2---add-username-password-login-email-and-contact-email-to-a-player).

Use a API [SendCustomAccountRecoveryEmail](xref:titleid.playfabapi.com.server.accountmanagement.sendcustomaccountrecoveryemail) uma vez por jogador para enviar este modelo:

* Uma vez em francês para o jogador cujo idioma preferencial é o francês.
* Uma vez no idioma padrão para um jogador sem idioma preferencial definido.

Um exemplo de email para o jogador *sem idioma preferencial* é mostrado abaixo.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-default-language.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=bb1e0e6cf1614c5e1cf0255ef60fea0e" alt="Email: redefinição de senha: idioma padrão" width="1180" height="388" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-default-language.png" />

Um exemplo de email para o jogador cujo *idioma preferencial é o francês* é mostrado abaixo.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-french-language.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=ce1d58bc1351db185ae7aaae37deba3c" alt="Email: redefinição de senha: idioma francês" width="1185" height="390" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-french-language.png" />

## Conclusão

Como você pode ver, o PlayFab percebeu que havia uma correspondência entre o suporte do seu modelo ao francês e a preferência de idioma do jogador.

Onde *não* havia correspondência ou *não* havia preferência, o jogador recebeu as cadeias de caracteres no idioma padrão do seu título.

Se você tiver dúvidas ou comentários sobre este tutorial, entre em contato conosco pelos nossos [fóruns](https://community.playfab.com/questions/ask.html) ou pelo canal do Slack.


## Related topics

- [Enviar email a partir de modelo](/pt-BR/services/playfab/api-references/rest/server/account-management/send-email-from-template.md)
- [Usar modelos de email para enviar um email de recuperação de conta](/pt-BR/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email.md)
- [Usar uma regra para verificar um endereço de email de contato](/pt-BR/services/playfab/live-service-management/game-configuration/title-communications/emails/using-a-rule-to-verify-a-contact-email-address.md)
- [Emails](/pt-BR/services/playfab/live-service-management/game-configuration/title-communications/emails/index.md)
- [email_sent](/pt-BR/services/playfab/api-references/events/TitleCommunications/email-sent.md)
