Onboarding em inglês, espanhol e português
Resumo: a página pública do Embedded Signup agora fala inglês, espanhol e português do Brasil. Você pode travar o idioma na hora de criar o link. Se o cliente reabrir o mesmo link depois para terminar uma etapa pendente, a página continua no idioma que você escolheu.
O problema
Muitos clientes do PipesBot cadastram números para times na América Latina. O produto que eles já usam está em português ou espanhol. A página pública em /apps/$slug era só em inglês, então a primeira coisa que essas pessoas viam — antes do diálogo da Meta, antes do PIN, antes de o número ficar pronto — era uma página no idioma errado. Os integradores também não tinham como escolher o idioma.
Como o idioma é escolhido
A página escolhe o idioma nesta ordem:
- O
localeque você envia ao criar o token de cadastro, se enviar um. Os valores aceitos sãoen,esept-BR. - Os idiomas do navegador do cliente, na ordem. Variantes regionais entram pelo idioma:
pt-PTmostra português do Brasil,es-419mostra espanhol. - Inglês, se nada mais servir.
Passe locale quando você já souber o idioma do cliente — por exemplo, a partir da conta dele no seu produto:
{
"redirectUrl": "https://yourapp.com/onboarding/complete",
"locale": "pt-BR"
}
Isso vai no POST /v1/apps/token, a mesma chamada que você já usa para criar o link. Qualquer outro valor retorna 400 com locale must be one of: en, es, pt-BR.
O idioma fica no link
O locale é guardado no token que você coloca na URL de cadastro. Quando o onboarding continua, ele é copiado para o ticket de registro, então um cliente que recarrega a página ou volta dias depois para terminar uma etapa pendente ainda vê o idioma que você forçou.
Se você não passar locale, a página segue o navegador — inclusive tickets mais antigos, criados antes desta mudança, que continuam válidos.
As mensagens de erro da página pública seguem o mesmo idioma. O servidor mantém um código de erro estável ao lado da string error em inglês; a página traduz por esse código, para o cliente não ser pedido para “tentar de novo” num link que já expirou.
O que isso não muda
Algumas coisas no caminho ficam de fora dessa configuração, e é melhor saber disso de antemão:
- O popup de cadastro da Meta usa o idioma da conta do Facebook do cliente. A página do PipesBot e o popup podem não coincidir.
- O nome, o logo e o tagline do seu App permanecem exatamente como você escreveu.
- O dashboard do PipesBot continua em inglês. Números que você conecta pelo dashboard não são afetados.
Experimente
Crie um token com locale definido como en, es ou pt-BR e envie o cliente para a URL de cadastro de sempre:
https://app.pipes.bot/apps/{your-app-slug}?token={token}
A documentação do Embedded Signup cobre o campo locale e o restante da API de token. Se você quiser o quadro completo do que acontece depois que o cliente termina o diálogo da Meta — registro, PIN, Coexistence — leia Cloud API numbers now register themselves after Embedded Signup.