Aviso de fim do suporte: em 30 de outubro de 2026, AWS encerrará o suporte para o Amazon Pinpoint. Após 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint nem seus recursos (endpoints, segmentos, campanhas, jornadas e analytics). Para obter mais informações, consulte Fim do suporte do Amazon Pinpoint. Observação: APIs relacionados a SMS, voz, push móvel, OTP e validação de número de telefone não são afetados por essa alteração e são compatíveis com o AWS End User Messaging.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Usar assistentes de modelos de mensagens
Com os modelos do Amazon Pinpoint, os clientes podem criar modelos de mensagens reutilizáveis com base na linguagem Handlebars.js. Os assistentes fornecem uma variedade de recursos, como formatar um preço para a moeda de uma Região específica ou adicionar um local com base no fuso horário. Um assistente pode usar uma cadeia de caracteres ou número inteiro específico para o valor ou para uma variável de mensagem específica do Amazon Pinpoint.
As categorias de assistentes estão descritas nas seções a seguir:
Esta seção descreve os assistentes integrados fornecidos pelo Handlebars. Para obter a lista completa, consulte Built-in Helpers
-
each: itera uma lista.nota
O tamanho máximo da lista é de 15 itens.
-
if: avalia uma declaração.
- cada
-
Itera uma lista. Esse assistente usa somente uma declaração de bloco. Você pode, opcionalmente:
-
Passar
@indexna solicitação para fazer referência ao índice de loop atual. -
Usar o assistente
thispara referenciar o elemento atual que está sendo iterado. -
Retornar a resposta do assistente em uma lista, usando a tag
<li>.
Uso
{{#eachvalue}}O valor na posição
{{@index}}é{{this}}.{{else}}A condição é falsa.
{{/each}}eachdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/each}}na declaração de bloco.Exemplo
Neste exemplo,
eaché usado para retornar uma lista das cores favoritas de um usuário. Parafalse, uma declaraçãoelseé retornada. Se a solicitação for essa:{{#each User.UserAttributes.FavoriteColors}}<li>{{this}}</li>{{else}}Você não tem cores favoritas.{{/each}}retorna-
red -
azul -
amarelo
para uma declaração verdadeira.
-
- se
-
Avalia se algo é verdadeiro e retorna uma resposta com base na avaliação.
Uso
{{#ifvalue}}O valor é indefinido
{{else}}O valor é indefinido
{{/if}}ifdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/if}}na declaração de bloco.Exemplo
Neste exemplo, o assistente
ifé usado para avaliar o primeiro nome de um usuário. Se o nome for encontrado, será retornada uma saudação que passa o primeiro nome do usuário na resposta. Caso contrário, a declaraçãoelseretornará uma saudação alternativa.{{#if User.UserAttributes.FirstName.[0]}}Hello{{User.UserAttributes.FirstName.[0]}},{{else}}Olá,{{/if}}retorna
Hello, Janese o assistenteiffor verdadeiro.
Esta seção descreve os assistentes condicionais.
Os assistentes condicionais podem ser usados em uma única linha ou em uma declaração de bloco. Você pode personalizar a resposta independentemente do método assistente usado. Você pode passar assistentes condicionais adicionais em declarações de linha única e de bloco. Os seguintes assistentes condicionais mostram, primeiramente, o uso de uma única linha e, depois, de uma declaração de bloco usando uma cláusula opcional else. Os assistentes condicionais são os seguintes:
-
and: compara se todos os elementos passados são iguais. -
eq: testa se dois elementos são iguais. -
gt: testa se um elemento é maior que outro. -
gte: testa se um elemento é maior ou igual a outro. -
if: avalia se algo é verdadeiro. -
lt: testa se um elemento é menor que outro. -
lte: testa se um elemento é menor ou igual a outro. -
neq: avalia se dois elementos não são iguais. -
not: inverte a resposta de uma operação booleana. -
or: compara se algum dos elementos do argumento é igual.
- e
-
Compara se todos os elementos passados em um argumento são iguais e retorna a resposta com base no resultado. Esse assistente pode ser usado para valores não booleanos. Você deve passar pelo menos dois elementos para a condição.
Uso
-
{{andvalueavaluebvaluecvaluedyes='y' no='n'}}Você pode substituir
yenpor outros valores, comosimenão, ou por qualquer outra cadeia de caracteres que você queira retornar, dependendo da condição. -
{{#andvalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/and}}anddeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/and}}na declaração de bloco.
Exemplo
Neste exemplo,
eqé usado na declaração de blocoandpara determinar se ambas as cadeias de caracteres passadas para os atributosLocation.CityeLocation.Countrysão verdadeiras. Se as duas condições forem iguais, uma declaração verdadeira será retornada. Se algum desses atributos for falso, uma declaraçãoelseserá retornada.{{#and (eq Location.City "Los Angeles") (eq Location.Country "US")}}Você mora em Los Angeles e nos EUA.{{else}}Você não mora em Los Angeles e nos EUA.{{/and}} -
- eq
-
Testa se dois elementos são iguais ou se o valor de um elemento é igual a uma cadeia de caracteres passada.
Uso
-
{{eqvalueavaluebyes='y' no='n'}}Você pode substituir
yenpor outros valores, comosimenão, ou por qualquer outra cadeia de caracteres que você queira retornar, dependendo da condição. -
{{#eqvalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/eq}}eqdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/eq}}na declaração de bloco.
Exemplo
Neste exemplo,
eqé usado para avaliar se o valor deUser.UserAttributes.FavoriteColors.[0]évermelho. Se a resposta fortrue, uma declaração verdadeira será retornada. Se a resposta forfalse, uma declaraçãoelseserá retornada.{{#eq User.UserAttributes.FavoriteColors.[0] "red"}}Sua cor favorita é vermelho.{{else}}Você não gosta de vermelho.{{/eq}} -
- gt
-
Testa se o valor de um elemento é maior que o de outro.
Uso
-
{{gtvalueavaluebyes='y' no='n'}}Você pode substituir
yenpor outros valores, comosimenão, ou por qualquer outra cadeia de caracteres que você queira retornar, dependendo da condição. -
{{#gtvalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/gt}}gtdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/gt}}na declaração de bloco.
Exemplo
Neste exemplo, o assistente compara o valor do atributo
User.UserAttributes.UserAge.[0]com uma cadeia de caracteres,17, para verificar se a idade do usuário é maior que 17. Se a resposta fortrue, uma declaração verdadeira será retornada. Se a resposta forfalse, uma declaraçãoelseserá retornada.{{#gt User.UserAttributes.UserAge.[0] "17"}}Você tem idade suficiente para alugar um carro.{{else}}Você não tem idade suficiente para alugar um carro.{{/gt}} -
- gte
-
Testa se o valor de um elemento é maior ou igual a outro.
Usage-
{{gtevalueavaluebyes='y' no='n'}}Você pode substituir
yenpor outros valores, comosimenão, ou por qualquer outra cadeia de caracteres que você queira retornar, dependendo da condição. -
{{#gtevalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/gte}}getdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/gte}}na declaração de bloco.
Exemplo
Neste exemplo, o assistente compara o atributo
User.UserAttributes.UserAge.[0]com uma cadeia de caracteres,18, para verificar se a idade do usuário é maior que 18. Se a resposta fortrue, uma declaração verdadeira será retornada. Se a resposta forfalse, uma declaraçãoelseserá retornada.{{#gte User.UserAttributes.UserAge.[0] "18"}}Você tem idade suficiente para alugar um carro.{{else}}Você não tem idade suficiente para alugar um carro.{{/gte}} -
- se
-
Avalia se algo é verdadeiro e retorna uma resposta com base na avaliação.
Uso
-
{{#ifvalue}}Você pode substituir
yenpor outros valores, comosimenão, ou por qualquer outra cadeia de caracteres que você queira retornar, dependendo da condição. -
{{#if}}valueA condição é verdadeira.
{{else}}A condição é falsa.
{{/if}}ifdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/if}}na declaração de bloco.
Exemplo
Neste exemplo, o assistente é usado para avaliar o primeiro nome de um usuário. Se o nome for encontrado, será retornada uma saudação que passa o primeiro nome do usuário na resposta. Caso contrário, a declaração else retornará uma saudação alternativa.
{{#if User.UserAttributes.FirstName.[0]}}Olá{{User.UserAttributes.FirstName.[0]}},{{else}}Olá,{{/if}}retorna
Hello, Janese o assistente for verdadeiro. -
- lt
-
Testa se o valor de um elemento é menor que o valor de outro.
Uso
-
{{ltvalueavaluebyes='y' no='n'}}Você pode substituir
yenpor outros valores, comosimenão, ou por qualquer outra cadeia de caracteres que você queira retornar, dependendo da condição. -
{{#ltvalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/lt}}ltdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/lt}}na declaração de bloco.
Exemplo
Neste exemplo, o assistente compara o atributo
User.UserAttributes.UserAge.[0]com uma cadeia de caracteres,18, para verificar se a idade do usuário é menor que 18. Se a resposta fortrue, uma declaração verdadeira será retornada. Se a resposta forfalse, uma declaraçãoelseserá retornada.{{#lt User.UserAttributes.UserAge.[0] "18"}}Você não tem idade suficiente para alugar um carro.{{else}}Você tem idade suficiente para alugar um carro.{{/lt}} -
- lte
-
Testa se o valor de um elemento é menor ou igual a outro.
Uso
-
{{ltevalueavaluebyes='y' no='n'}}Você pode substituir
yenpor outros valores, comosimenão, ou por qualquer outra cadeia de caracteres que você queira retornar, dependendo da condição. -
{{#ltevalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/lte}}ltedeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/lte}}na declaração de bloco.
Exemplo
Nessa declaração de bloco, o assistente compara o atributo
User.UserAttributes.UserAge.[0]com uma cadeia de caracteres,17, para verificar se a idade do usuário é igual ou menor a 17. Se a resposta fortrue, uma declaração verdadeira será retornada. Se a resposta forfalse, uma declaraçãoelseserá retornada.{{#lte User.UserAttributes.Age.[0] "17"}}Você não tem idade suficiente para alugar um carro.{{else}}Você tem idade suficiente para alugar um carro.{{/lte}} -
- neq
-
Teste se dois elementos não são iguais.
Uso
-
{{neqvalueavaluebyes='y' no='n'}}Você pode substituir
yenpor outros valores, comosimenão, ou por qualquer outra cadeia de caracteres que você queira retornar, dependendo da condição. -
{{#neqvalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/neq}}neqdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/neq}}na declaração de bloco.
Exemplo
Nessa declaração de bloco, o atributo
User.UserAttributes.FavoriteColors.[0]é verificado em relação a uma cadeia de caracteres,. Se a resposta forRedtrue, uma declaração verdadeira será retornada. Se a resposta forfalse, uma declaraçãoelseserá retornada.{{#neq User.UserAttributes.Favorite.Colors.[0] "red"}}Você não gosta de vermelho.{{else}}Você gosta de vermelho.{{/neq}} -
- not
-
Inverte a resposta de uma operação booleana, de forma que, se
notfor uma comparação positiva, uma declaraçãotrueserá retornada. Se a resposta for falsa, uma declaração else será retornada.Uso
-
{{notvalueyes='y' no='n'}}Você pode substituir
yenpor outros valores, comosimenão, ou por qualquer outra cadeia de caracteres que você queira retornar, dependendo da condição. -
{{#not}}valueA condição é verdadeira.
{{else}}A condição é falsa.
{{/not}}notdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/not}}na declaração de bloco.
Exemplo
Nessa declaração de bloco, o atributo
User.UerAttributes.FavoriteColors.[0]é verificado em relação a uma cadeia de caracteres,vermelho, usando o assistenteeq. O assistentenotentão retorna o oposto do assistenteeq. Se a resposta retornar qualquer cor diferente dovermelho, uma declaraçãotrueserá retornada. Se a resposta retornar emvermelho, uma declaraçãoelseserá retornada, indicando uma declaração falsa.{{#not (eq User.UserAttributes.Favorite.Colors.[0] "red")}}Você não gosta de vermelho.{{else}}Você gosta de vermelho.{{/not}}Exemplo
Neste exemplo,
{{not (eq User.UserAttributes.FavoriteColors.[0] "red")}}retorna falso se
User.UserAttributes.FavoriteColors.[0]forvermelho. -
- ou
-
Compara se algum dos elementos no argumento é igual e retorna uma resposta com base no resultado. Esse assistente pode ser usado para valores não booleanos.
Uso
-
{{orvalueavaluebvaluecvaluedyes='y' no='n'}}Você pode substituir
yenpor outros valores, comosimenão, ou por qualquer outra cadeia de caracteres que você queira retornar, dependendo da condição. Você deve passar pelo menos dois elementos para a condição. -
{{#orvalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/or}}ordeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/or}}na declaração de bloco.
Exemplo
Nessa declaração de bloco
or, duas cadeias de caracteres do atributoLocation.Citysão comparadas, adicionalmente, usando o assistenteeq. Se algum dos atributos fortrue, uma declaração verdadeira será retornada. Se uma ou mais das respostas foremfalse, uma declaraçãoelseserá retornada.{{#or (eq Location.City "Los Angeles") (eq Location.City "Seattle")}}Você mora na costa oeste dos Estados Unidos.{{else}}Você não mora na costa oeste dos Estados Unidos.{{/or}} -
Esta seção descreve os seguintes assistentes de cadeia de caracteres:
-
abbreviate: trunca um valor. -
capitalize: coloca cada palavra entre espaços em branco. -
capitalizeFirst: capitaliza o primeiro caractere de um valor. -
center: centraliza um valor. -
cut: corta um valor. -
dateFormat: define o estilo da data. -
inflect: retorna uma cadeia de caracteres singular ou plural com base na contagem. -
join: une uma matriz, iterador ou objeto iterável. -
ljust: justifica um valor na margem esquerda. -
lower: converte um valor em letras minúsculas. -
now: imprime a data atual. -
ordinalize: transforma um valor numérico em número decimal. -
replace: substitui uma cadeia de caracteres por outra. -
rjust: justifica um valor na margem direita. -
slugify: converte um valor em letras minúsculas e remove caracteres que não sejam palavras, converte espaços em hifens e remove o espaço em branco à direita. -
stripTags: retira as tags [X]HTML de um valor. -
substring: retorna uma nova cadeia de caracteres como sub-cadeia de um valor passado. -
upper: converte o valor passado em letras maiúsculas.
-
yesno: substitui verdadeiro, falso e não por Sim, Não e Talvez.
- abreviar
-
Trunca um valor se este exceder o número especificado. Os espaços em branco estão incluídos na contagem de comprimento. Reticências são exibidas na resposta para indicar um valor truncado. As reticências contam para o valor truncado na resposta. Esse tipo de assistente é útil se você tiver uma mesa grande e espaço mínimo. Truncar valores em uma célula permite que você tenha uma aparência mais uniforme da tabela.
Uso
{{abbreviate, substituindovalueX}}Xpor um valor numérico indicando o número de caracteres a serem mantidos. Não há suporte para números negativos.Exemplo
Neste exemplo,
abbreviateé usado para truncarUser.UserAttributes.LastName.[0]para seis (6) caracteres. A resposta inclui reticências, cujos pontos contam para o total de seis caracteres.{{abbreviateretornaUser.UserAttributes.LastName.[0]6}}Ale...seAlejandrofor o valor de[0]. - capitalize
-
Capitaliza cada palavra entre espaços em branco.
Uso
{{capitalizevalue}}Exemplo
Neste exemplo, a capitalização inicial é aplicada a cada palavra da entrada
Attributes.description.[0].{{capitalizeAttributes.description.[0]}}Se
Attributes.description.[0]retornarMinha primeira postagem, se o valor deAttributes.description.[0]forminha primeira postagem. - capitalizeFirst
-
Capitaliza o primeiro caractere de um valor.
Uso
{{capitalizeFirstvalue}}Exemplo
Neste exemplo, a capitalização é aplicada ao primeiro caractere da primeira palavra da entrada
Attributes.description.[0].{{capitalizeFirstretornaAttributes.description.[0]}}Minha primeira postagem, se o valor deforAttributes.description.[0]minha primeira postagem.Exemplo
- center
-
Centraliza o valor em um campo de uma determinada largura pelo número especificado. Opcionalmente, você pode passar um caractere para exibir no preenchimento ou deixar o campo em branco. Se nenhum caractere for passado, um espaço em branco será usado.
Uso
{{center, substituindovaluesize=X[pad=" "}}Xpor um valor numérico.Se
padfor mantido em branco, o espaço em branco será usado como preenchimento na resposta. Se você passar um caractere, esse caractere será exibido em cada espaço do preenchimento. Não há suporte para números negativos.Exemplo
Neste exemplo, o valor de
Location.Cityé centralizado com um tamanho de19.{{centerretornaLocation.Citysize=19}}" Los Angeles "seLocation.CityforLos Angeles. Observe que as aspas exibidas no exemplo são fornecidas apenas para dar ênfase. - cut
-
Remove o valor especificado de uma cadeia de caracteres.
Uso
{{cut, substituindo o espaço dentro do parâmetro de aspas pelo valor a ser cortado. Se nenhum valor de parâmetro for passado, um espaço em branco será usado.value[" "]}}Exemplo
Este exemplo remove a letra
edo atributoLocation.City.{{cutretornaLocation.City"e"}}Los Anglsse[Location.CityforLos Angeles. - dateFormat
-
Define o estilo de data padrão para a data em qualquer resposta. Para obter uma lista dos IDs de fuso horário, consulte https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
. Uso
{{dateFormat date [inputFormat="format1"] [outputFormat="format2"] [tz=timeZoneId] [locale=localeID]}}O parâmetro
formatdeve ser:-
“
full“: formato de data completo. Por exemplo:terça-feira, 19 de setembro de 2020 -
“
long“: formato de data longo. Por exemplo:19 de setembro de 2020 -
“
medium“: formato de data médio. Por exemplo:19 de set de 2020 -
“
short“: formato de data abreviada. Por exemplo:19/09/20 -
“
pattern“: usa um formato de padrão de data personalizado. Para obter mais informações sobre padrões de datas, consulte https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html.
“
locale“: usa um formato de data baseado em uma determinada localidade. Para mais informações sobre esses locais, consulte https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-. Se um formato não for passado,
mediumserá usado por padrão.Exemplo
Neste exemplo, a entrada
[0]paraéUser.UserAttributes.StartDate.[0]09/19/2020e uma mensagem é enviada a um usuário usando o formato de datafullcom base no fuso horárioAmerica/Los_Angeles.We can meet with you any time on{{dateFormat User.UserAttributes.StartDate.[0] inputFormat="MM/dd/yyyy" outputFormat="full" tz=America/Los_Angeles}}.retornaPodemos nos encontrar com você a qualquer momento na terça-feira, 19 de setembro de 2020. -
- inflect
-
Retorna uma cadeia de caracteres singular ou plural com base no valor de contagem.
Uso
{{inflectcountsingularplural[includeCount=false]}}-
Insira as formas singular e plural da cadeia de caracteres que você deseja passar no argumento.
-
Se
includeCountestiver definido comofalse, nenhuma contagem será retornada na resposta. Se definido comotrue, ocounté incluído na resposta.
Exemplo
Os exemplos a seguir mostram a inflexão de uma compra de maçãs, com e sem
includeCount.Thank you for your purchase of {{inflectretorna:3appleapplesincludeCount=false}}.Agradecemos pela compra de maçãs.Se
includeCountestiver definido comotrue, a resposta seráAgradecemos pela compra de três maçãs. -
- ingressar
-
Une uma matriz, um iterador ou um objeto iterável. A resposta retorna uma lista, com cada valor na lista concatenado pelo caractere que você passa no
join. Por exemplo, você pode separar valores usando uma vírgula (,). O valor nesse assistente deve ser uma lista sem um índice de posição do atributo. Por exemplo, pode serAttributes.custom_attribute.Uso
{{joinvalue" // " [prefix=""] [suffix=""]}}Exemplo
Neste exemplo, uma lista de cores é retornada, com a lista separada por uma vírgula e um espaço (
", "):{{joinretornaAttributes.favorite_colors","}}azul, vermelho, verdeseAttributes.favorite_colorsfor a listaazul, vermelho, verde. - ljust
-
Justifica o valor na margem esquerda e adiciona espaço à direita, para que o comprimento do valor corresponda ao número. Não há suporte para números negativos.
Opcionalmente, você pode passar um caractere para exibir no
padou deixar o campo em branco. Se você deixar o valorpadem branco, o valor padrão será um espaço em branco.Uso
{{ljust, ondevaluesize=X[pad=" "]}}Xé o comprimento total do valor, incluindo espaço em branco.Exemplo
Neste exemplo, um valor de justificação à esquerda de
15é aplicado a Location.City.{{ljustretornaLocation.Citysize=15}}"Los Angeles "se o valor deLocation.CityforLos Angeles. Observe que as aspas exibidas no exemplo são fornecidas apenas para dar ênfase. - lower
-
Converte um valor em todas as letras minúsculas.
Uso
{{lowervalue}}Exemplo
Neste exemplo, a entrada
[0]paraUser.UserAttributes.LastName.[0]é alterada para minúscula.{{lowerretornaUser.UserAttributes.LastName.[0]}}santosseSantosfor o valor de[0]. - agora
-
Imprime a data atual com base no ID de fuso horário aprovado. Para obter uma lista dos IDs de fuso horário, consulte https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
. Uso
{{now [format="format"] [tz=timeZoneId] [locale=localeID]}}O parâmetro
formatdeve ser:-
“
full“: formato de data completo. Por exemplo:terça-feira, 19 de setembro de 2020 -
“
long“: formato de data longo. Por exemplo:19 de setembro de 2020 -
“
medium“: formato de data médio. Por exemplo: 19 de set de 2020 -
“
short“: formato de data abreviada. Por exemplo: 19/09/20 -
“
pattern“: um padrão de data. Para obter mais informações sobre padrões de datas, consulte https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html.
“
locale“: usa um formato de data baseado em uma determinada localidade. Para mais informações sobre esses locais, consulte https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-. Se um formato não for passado,
mediumserá usado por padrão.Exemplo
Neste exemplo, a data atual em Los Angeles é retornada com um formato
medium.{{now "medium" tz=retornaAmerica/Los_Angeles}}19 de setembro de 2020 -
- ordinalize
-
Ordena o valor numérico passado no argumento. Por exemplo,
1é passado como1ºe2como2º. Somente valores numéricos são compatíveis.Uso
{{ordinalize [number]}}Exemplo
Neste exemplo, a entrada
[0]deUser.UserAttributes.UserAgeé transformada em número ordinal e retornada junto com uma mensagem.Congratulations on your {{ordinalize User.UserAttributes.UserAge.[0]}} birthday!retorna22, transformado em número ordinal como22º.Parabéns pelo seu 22º aniversário! - subtituir
-
Substitui uma cadeia de caracteres por outra. Uma cadeia de caracteres ou um valor numérico deve ser literal. Caracteres curinga não são compatíveis.
Uso
{{replacestringToReplacereplacementValue}}Exemplo
Neste exemplo, um sublinhado (_) substitui um espaço em branco.
{{replaceretornaLocation.City" " "_"}}Los_AngelesseLocation.CityforLos Angeles. - rjust
-
Justifica o valor na margem esquerda e adiciona espaço à esquerda, para que o comprimento do valor corresponda ao número. Não há suporte para números negativos.
Opcionalmente, você pode passar um caractere para exibir no
padou manter o campo em branco. Se você deixar o valorpadem branco, o valor padrão será um espaço em branco.Uso
{{rjust, ondevaluesize=X[pad=" "]}}Xé o comprimento total do valor, incluindo espaço em branco.Exemplo
Neste exemplo, um valor de justificação correta de
15é aplicado ao atributoLocation.City.{{rjustretornaLocation.Citysize=15}}" Los Angeles". seLocation.CityforLos Angeles. Observe que as aspas exibidas no resultado são fornecidas apenas para dar ênfase. - slugify
-
Converte o valor passado em letras minúsculas, remove caracteres que não são palavras (alfanuméricos ou sublinhados), converte espaços em hifens e remove espaços em branco à direita e à esquerda.
Uso
{{slugifyvalue}}Exemplo
Neste exemplo, o slugify é executado para o atributo
Location.City.{{slugifyretornaLocation.City}}los-angelesseLocation.CityforLos Angeles. - stripTags
-
Retira as tags [X]HTML de um valor.
Uso
{{stripTagsvalue}}Exemplo
Neste exemplo, as tags HTML do User.UserAttributes.interest.[0] são removidas.
{{stripTagsretornaUser.UserAttributes.interests.[0]}}Arte, seUser.UserAttributes.interests.[0]for<h1>Art</h1>. - substring
-
Retorna uma nova cadeia de caracteres como sub-cadeia do valor passado. O comprimento e a posição são determinados pelos parâmetros
startOffseteendOffset, que devem ser números inteiros. Não há suporte para números negativos. Se umendOffsetnão for passado, a sub-cadeia usará o valor final original da cadeia de caracteres.Uso
{{substringvaluestartOffset[endOffset]}}Exemplo
Neste exemplo, um offset de 4 e endOffset de 9 são aplicados ao atributo Location.City.
{{substringretornaLocation.City 4 9}}se Los Angeles for o valor deAngelLocation.Citye forLos Angeles. - upper
-
Converte o valor passado em letras maiúsculas.
Uso
{{uppervalue}}Exemplo
Neste exemplo, todas as letras da entrada
[0]do atributoUser.UserAttributes.LastNamesão convertidas em maiúsculas.{{upper User.UserAttributes.LastName.[0]}}retornaROEse o valorUser.UserAttributes.LastName.[0]forRoe. - yesno
-
Substitui
true,falseeNULLporYes,NoeMaybe.Uso
{{yesno value [yes="yes"] [no="no"] maybe=["maybe"]}}Exemplo
Neste exemplo, o atributo
IsUserSubscribedretorna se um usuário está inscrito em uma lista específica.{{yesno Attributes.IsUserSubscribed}}retornasimseAttributes.IsUserSubscribedforverdadeiro.
Esta seção descreve os assistentes de matemática e codificação.
-
add: retorna a soma de dois números. -
ceiling: arredonda um número inteiro até seu teto matemático. -
decode64: decodifica um valor codificado em base64 em uma cadeia de caracteres. -
divide: retorna o quociente de dois números. -
encode64: codifica uma cadeia de caracteres usando base64. -
floor: arredonda um número inteiro até seu piso matemático. -
md5: faz o hash de uma cadeia de caracteres passada usando o algoritmo MD5. -
modulo: retorna o resto de dois números usando pontos flutuantes. -
multiply: retorna o produto de dois números. -
round: arredonda um decimal para o número inteiro mais próximo. -
sha256: faz o hash de uma cadeia de caracteres passada usando SHA-256. -
sha512: faz o hash de uma cadeia de caracteres passada usando SHA-512. -
subtract: retorna a diferença de dois números. -
uuid: gera aleatoriamente um UUID em um formato de 128 bits.
- add
-
Retorna a soma de dois números junto com vírgulas flutuantes.
Uso
{{addarg1arg2}}Exemplo
{{addretorna5 2.3}}7.3 - ceiling
-
Arredonda um inteiro até seu teto matemático, que é o maior número inteiro mais próximo do valor passado.
Uso
{{ceilingvalue}}Exemplo
{{ceilingretorna5.23}}6 - decode64
-
Decodifica um valor codificado em base64 em uma cadeia de caracteres.
Uso
{{decode64 "string"}}Exemplo
{{decode64 "retornaSGVsbG8gd29ybGQ="}}Hello World - divide
-
Retorna o quociente de dois números, incluindo vírgulas flutuantes.
Uso
{{dividearg1arg2}}Exemplo
{{divideretorna5 2.3}}2.17391304 - encode64
-
Codifica a cadeia de caracteres passada no argumento usando base64.
Uso
{{encode64 "string"}}Exemplo
{{encode64 "Hello World"}}SGVsbG8gd29ybGQ= - floor
-
Arredonda um número inteiro para seu piso matemático, que é o menor número inteiro mais próximo do valor passado.
Uso
{{floorvalue}}Exemplo
{{floorretorna5.23}}5 - md5
-
Faz o hash de uma cadeia de caracteres passada usando o algoritmo MD5.
Uso
{{md5 "string"}}Exemplo
{{md5 "Hello World"}}3e25960a79dbc69b674cd4ec67a72c62 - modulo
-
Retorna o resto de dois números usando vírgulas flutuantes.
Uso
{{moduloarg1arg2}}Exemplo
{{moduloretorna7 2}}1 - multiply
-
Retorna o produto de dois números junto com vírgulas flutuantes.
Uso
{{multiplyarg1arg2}}Exemplo
{{multiplyretorna5 2.3}}11.5 - round
-
Arredonda uma casa decimal para cima ou para baixo para o número inteiro mais próximo.
Uso
{{roundvalue}}Exemplo
You spent an average of {{roundretorna:19.21}} minutes on our website each day.Você passou uma média de 19 minutos em nosso site todos os dias. - sha256
-
Faz o hash de uma cadeia de caracteres passada usando a segurança criptográfica SHA-256.
Uso
{{sha256 "string"}}Exemplo
{{sha256 "retornaHello World"}}a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e - sha512
-
Faz o hash de uma cadeia de caracteres passada usando a segurança criptográfica SHA-512.
Uso
{{sha512 "string"}}Exemplo
{{sha512 "retornaHello World"}}2c74fd17edafd80e8447b0d46741ee243b7eb74dd2149a0ab1b9246fb30382f27e853d8585719e0e67cbda0daa8f51671064615d645ae27acb15bfb1447f459b - subtract
-
Retorna a diferença de dois números junto com vírgulas flutuantes.
Uso
{{subtractarg1arg2}}Exemplo
retorna{{subtract5 2.3}}2.7 - uuid
-
Gera aleatoriamente um UUID em um formato padrão de 128 bits. Nenhum valor precisa ser passado no argumento.
Uso
{{uuid}}Exemplo
retorna{{uuid}}95f36680-152c-4052-99ec-cc3cdf7ca594
Embora tecnicamente não sejam assistentes, as parciais em linha são uma forma do Handlebar de simplificar modelos que incluem cadeias de caracteres repetidas, facilitando a reutilização. Para obter mais informações, consulte Inline partials
Uso
{{#* inline "inlineName"}}Content to reuse{{/inline}}
Para referenciar o conteúdo da parcial em linha em outro lugar, use:
{{> inlineName}}
Exemplo
O seguinte exemplo cria uma parcial em linha que inclui o nome do destinatário e, se disponível, o sobrenome, adicionando o seguinte código no início do modelo:
{{#* inline "fullName"}}
{{User.UserAttributes.FirstName.[0]}} {{#if
User.UserAttributes.LastName.[0]}} {{User.UserAttributes.LastName.[0]}} {{/if}}
{{/inline}}
Depois de criar a parcial fullName, você pode incluí-la em qualquer lugar em seu modelo colocando antes do nome da parcial um sinal de > (maior que), seguido por um espaço, como no exemplo a seguir: {{>
fullName}}.
Hello {{> fullName}}
retorna o nome e o sobrenome do usuário, se verdadeiros: por exemplo, Hello Jane Doe. Caso contrário, se nenhum sobrenome for encontrado, Hello Jane será retornado.
O Handlebars inclui atributos adicionais além dos documentados aqui. Para obter mais informações, consulte handlebarsjs.com
Usar variáveis com assistentes de modelo de mensagem
Os atributos personalizados do Amazon Pinpoint, como User.UserAttributes.LastName, são armazenados como uma lista, independentemente de haver um único item ou vários. Ao passar uma lista em um assistente que espera uma cadeia de caracteres, especifique o valor do índice do atributo junto com o nome do atributo. Esse valor de índice de atributo indica a posição de um valor na lista de atributos: .[0] para a primeira entrada na lista, .[1] para a segunda, .[2] para a terceira e assim por diante. Por exemplo, digamos que você esteja usando o assistente upper para converter a primeira entrada ([0]) de User.UserAttributes.LastName em maiúsculas. O uso do assistente é{{upper , e o atributo está formatado como value}}User.UserAttributes.LastName. Substitua value pelo nome do atributo e pelo valor do índice do atributo , da seguinte forma: .[0]{{upper
User.UserAttributes.LastName.[0]}}. Em seguida, a resposta retorna a entrada [0] da lista, formatada em letras maiúsculas. Por exemplo, se o valor de [0] for Santos, a resposta retornará SANTOS.
Os nomes de atributos personalizados do Amazon Pinpoint oferecem suporte a espaços. Para ter um atributo personalizado chamado "Last Name", você precisa formatar o atributo como User.UserAttributes.[Last Name]. Para acessar a primeira entrada na lista de índices de atributos, o formato é User.UserAttributes.[Last
Name].[0].
Um nome de atributo personalizado pode conter até 50 caracteres. Um valor de atributo pode conter até 100 caracteres. Ao definir o nome de um atributo personalizado, evite usar os seguintes caracteres: sinal numérico (#), dois pontos (:), ponto de interrogação (?) , barra invertida (\) e barra (/). O console do Amazon Pinpoint não pode exibir nomes de atributos que contenham esses caracteres. Essa restrição não se aplica aos valores dos atributos.
Usar assistentes aninhados
Você pode agrupar vários assistentes de modelos de mensagens dentro uns dos outros. O exemplo a seguir mostra como formatar dois assistentes: {{ first helper (second helper)}}. O segundo assistente é processado primeiro, seguido pelo primeiro. Lembre-se de que o primeiro assistente sempre determina a saída. Os assistentes subsequentes devem estar aninhados no assistente anterior da seguinte forma: {{ first helper (second helper (third helper)
)}}.
O exemplo a seguir mostra como reunir dois assistentes para alterar JANE para Jane:{{capitalizeFirst
(lower ". JANE")}}lower primeiro converte JANE em jane. Em seguida, capitalizeFirst converte jane em Jane.