Uma mensagem às 9:00 de cada cliente, no idioma dele

A Ana mora na Cidade do México e fala espanhol. O Lucas está em São Paulo e fala português. A Emily está em Miami e prefere inglês. Os três estão na mesma campanha, e a mensagem deveria chegar às 9:00 da manhã de cada um, não da sua, e no idioma de cada um.

Não precisa de uma jornada por país. Uma só jornada com dois nós Casos resolve: um separa por fuso horário e o outro por idioma.

Antes de começar: dois atributos em cada pessoa

A jornada decide com o que você já sabe de cada cliente, então cada pessoa precisa de dois atributos no CDP:

• language: por exemplo es, pt, en.
• timezone: o nome do fuso horário, por exemplo America/Mexico_City, America/Bogota, America/Sao_Paulo.

Você pode carregá-los por CSV, pela API ou pela sua integração. Antes de montar qualquer coisa, confira quais valores você tem de fato, porque um nó Casos compara o valor exato. Ele ignora maiúsculas e espaços (ES e es caem no caso es), mas nada além disso: es-MX não cai em es. Se os seus dados misturam formatos, normalize-os ou adicione um caso para cada forma.

Para o fuso horário, use os nomes padrão como America/Sao_Paulo em vez de abreviações como BRT ou deslocamentos como -03:00. São os mesmos nomes que você vai escolher nas esperas, e eles já levam em conta o horário de verão de cada país.

Passo 1: separe por fuso horário

Depois do disparador, adicione um nó Casos:

1. Em Atributo, escolha timezone.
2. Com Adicionar caso, crie um por fuso: valor America/Mexico_City com rótulo CDMX, valor America/Sao_Paulo com rótulo São Paulo, e assim por diante. Cabem até 10.
3. A saída Padrão recebe quem não tem fuso horário ou tem um que você não listou. Não a deixe solta: a jornada não pode ser publicada sem ela.

Passo 2: uma espera em cada ramo

Em cada ramo, adicione um nó Aguardar:

1. Escolha o modo Janela.
2. Marque os dias (por exemplo, de segunda a sexta) e a janela de envio, De 9:00 Até 10:00.
3. Em Fuso horário, escolha o fuso desse ramo: America/Sao_Paulo no ramo de São Paulo, America/Bogota no de Bogotá.

No ramo Padrão, deixe o fuso em Padrão da organização.

Se a pessoa chega dentro da janela, segue na hora. Se chega fora, espera até o próximo dia marcado às 9:00 do fuso dela.

Use Janela, não os outros dois modos. Data exata aponta para um instante fixo, o mesmo para todos: o fuso horário só muda como você o vê no editor. Duração não usa fuso horário.

Passo 3: junte os ramos e escolha o idioma

Conecte todas as esperas a um mesmo nó Casos, desta vez com o Atributo language:

1. Um caso por idioma: es, pt, en.
2. Cada caso vai para um nó de envio com o template aprovado nesse idioma.
3. Padrão vai para o template no seu idioma principal.

Faça a separação por idioma depois das esperas, não antes. Assim você a monta uma vez só em vez de repeti-la em cada fuso horário. Além disso, o atributo é lido no momento em que a pessoa chega ao nó, então se alguém corrigiu o idioma enquanto esperava, recebe a mensagem no idioma corrigido.

A jornada completa

1. Disparador: o segmento ou evento da sua campanha.
2. Casos por timezone: um ramo por fuso, mais Padrão.
3. Aguardar, em cada ramo: Janela de segunda a sexta, das 9:00 às 10:00, no fuso desse ramo.
4. Casos por language, onde todos os ramos se juntam.
5. Enviar mensagem com o template de cada idioma.
6. Fim.

Se você monta a jornada pelo MCP ou pela API, a espera do ramo de São Paulo fica assim. Os minutos contam a partir da meia-noite (540 são as 9:00):

{
  "mode": "until_weekday",
  "weekdays": [1, 2, 3, 4, 5],
  "windowStartMinutes": 540,
  "windowEndMinutes": 600,
  "timezone": "America/Sao_Paulo"
}

Três detalhes que evitam surpresas

• Não ative a janela de horário herdada nos envios. Essa opção calcula o horário com o fuso da sua organização, não o do ramo, e poderia segurar até as 9:00 da Cidade do México uma mensagem que já ia sair às 9:00 de São Paulo. A espera de cada ramo já cuida do horário.
• Confira quem cai em Padrão. A linha do tempo de cada inscrição mostra por qual ramo a pessoa saiu. Se muitas saem pelo ramo padrão, faltam casos ou há valores em outro formato.
• Teste com uma pessoa por fuso. Inscreva uma pessoa de teste em cada ramo, principalmente no fuso mais distante do seu, e confira na linha do tempo dela quando a espera é retomada antes de lançar a campanha completa.

O nó Casos serve para qualquer atributo com poucos valores, não só idioma e fuso horário: plano, país, etapa do cliente. A referência completa dos nós está na nossa documentação.