Variáveis de texto

Variáveis de texto são trechos no formato {{ nome }} que o plugin substitui pelo valor real no momento do envio.

Escrevendo:

Olá {{ first_name }}, recebemos suas informações! Em breve um atendente retornará o contato.

O cliente recebe:

Olá João, recebemos suas informações! Em breve um atendente retornará o contato.

Dentro do construtor, as variáveis aparecem destacadas e clicáveis no campo de mensagem, com um aviso quando a variável escolhida não existe no gatilho do fluxo.

A variável precisa combinar com o gatilho

Cada variável declara em quais gatilhos ela funciona. Desde a versão 2.1.0 isso vale também no envio, não só na pré-visualização: uma variável fora do contexto do gatilho é deixada como está, em vez de virar um valor errado. Variáveis marcadas como globais funcionam em qualquer gatilho.

WordPress

Variável	Gatilhos	Descrição
{{ first_name }}	todos	Primeiro nome do usuário
{{ last_name }}	todos	Sobrenome do usuário
{{ email }}	todos	E-mail do usuário
{{ site_url }}	todos	URL do site
{{ site_name }}	todos	Nome do site
{{ current_date }}	todos	Data atual
{{ user_meta[META_KEY] }}	todos	Meta dado do usuário. Troque META_KEY pela chave desejada, por exemplo billing_phone
{{ post_title }}	status do post alterado	Título do post
{{ post_date }}	status do post alterado	Data de publicação
{{ post_content }}	status do post alterado	Conteúdo do post, só texto
{{ post_link }}	status do post alterado	Link do post
{{ post_tags }}	status do post alterado	Tags do post, separadas por vírgula
{{ post_categories }}	status do post alterado	Categorias do post, separadas por vírgula
{{ post_featured_image }}	status do post alterado	URL da imagem destacada
{{ reset_password_link }}	solicitação de redefinição de senha	Link de redefinição de senha

WooCommerce

Na maioria dos casos o objeto processado é o pedido.

Variável	Descrição
{{ wc_billing_first_name }}	Primeiro nome de faturamento do cliente
{{ wc_billing_last_name }}	Sobrenome de faturamento do cliente
{{ wc_billing_email }}	E-mail de faturamento
{{ wc_billing_phone }}	Telefone de faturamento
{{ wc_shipping_phone }}	Telefone de entrega
{{ wc_order_number }}	Número do pedido
{{ wc_order_status }}	Status atual do pedido
{{ wc_order_date }}	Data do pedido
{{ wc_order_total }}	Valor total do pedido
{{ wc_currency_symbol }}	Símbolo da moeda do pedido
{{ wc_total_discount }}	Total de desconto aplicado
{{ wc_total_tax }}	Total de impostos
{{ wc_total_refunded }}	Total reembolsado
{{ wc_coupon_codes }}	Códigos de cupom usados no pedido
{{ wc_payment_method_title }}	Título do método de pagamento
{{ wc_payment_url }}	URL de pagamento do pedido
{{ wc_billing_full_address }}	Endereço completo de faturamento (formato configurável nas opções)
{{ wc_shipping_full_address }}	Endereço completo de entrega (formato configurável nas opções)
{{ wc_shipping_address }}	Endereço de entrega em formato legível
{{ wc_purchased_items }}	Produtos comprados, com nome e quantidade, um por linha
{{ wc_review_links }}	Link de avaliação de cada produto comprado, um por linha
{{ wc_checkout_field=[FIELD_ID] }}	Valor de um campo do checkout. Troque FIELD_ID pelo ID do campo, por exemplo billing_email

Produtos digitais

Disponíveis a partir da versão 2.1.0, e resolvidas só depois que o acesso ao download foi liberado.

Variável	Descrição
{{ wc_downloadable_items }}	Nome de cada produto digital do pedido, um por linha
{{ wc_download_links }}	Nome e link de cada arquivo digital, um por linha
{{ wc_download_urls }}	Só os links de download, sem o nome do arquivo, um por linha
{{ wc_downloads_expiry }}	Data de expiração do acesso. Retorna a data mais próxima quando os arquivos expiram em datas diferentes
{{ wc_downloads_remaining }}	Quantos downloads o cliente ainda tem. Retorna o menor valor quando os arquivos têm limites diferentes
{{ wc_account_downloads_url }}	Link para a área de downloads na conta do cliente
{{ wc_download_link=[PRODUCT_ID] }}	Links de download de um produto específico. Troque PRODUCT_ID pelo ID do produto, por exemplo 128

Cupons gerados pelo fluxo

Disponíveis depois da ação Criar cupom no mesmo fluxo.

Variável	Descrição
{{ joinotify_coupon_code }}	Código do cupom
{{ joinotify_coupon_description }}	Descrição do cupom
{{ joinotify_coupon_discount_type }}	Tipo de desconto — percentual ou valor fixo
{{ joinotify_coupon_discount_value }}	Valor do desconto
{{ joinotify_coupon_discount_formatted }}	Valor formatado com símbolo ou percentual, por exemplo 10%
{{ joinotify_coupon_expires }}	Expiração do cupom, por exemplo "Expira em 1 hora"

Laços (loop)

Disponíveis dentro do corpo da ação Loop, a partir da versão 2.2.0. Elas valem em qualquer campo da ação — legenda, URL de mídia, URL de anexo e destinatário.

Variável	Descrição
{{ loop_value }}	Valor do item da iteração atual
{{ loop_index }}	Índice do item, começando em zero
{{ loop_number }}	Número do item, começando em um
{{ loop_count }}	Total de itens da coleção
{{ loop_file_name }}	Nome do arquivo do item
{{ loop_download_url }}	Link de download do item
{{ loop_product_name }}	Nome do produto do item
{{ loop_product_id }}	ID do produto do item
{{ loop_item_name }}	Nome do item
{{ loop_item_quantity }}	Quantidade do item

Formulários

Elementor e WPForms expõem a mesma variável, que recupera o valor de qualquer campo do formulário enviado.

Variável	Descrição
{{ field_id=[FIELD_ID] }}	Valor de um campo do formulário

Troque FIELD_ID pelo ID do campo. No exemplo do Elementor abaixo ficaria {{ field_id=[field_3cf5068] }}; no do WPForms, {{ field_id=[1] }}.

Variáveis personalizadas

A partir da versão 2.0.0 dá para criar variáveis próprias direto no construtor, a partir de tipos de conteúdo e campos do site — incluindo pedidos do WooCommerce — sem escrever código. Elas aparecem na mesma lista das nativas.

Para variáveis que exigem lógica, o caminho é o filtro Joinotify/Builder/Placeholders_List ou o helper joinotify_register_placeholders(); veja Recursos para desenvolvedores.

Formatação do WhatsApp

O editor de mensagens já converte a formatação visual (negrito, itálico, emoji) para o padrão do WhatsApp. Se preferir escrever direto, a sintaxe é a do próprio WhatsApp — ela é processada no servidor da Meta e não pode ser desligada.

Efeito	Sintaxe
Itálico	_texto_
Negrito	*texto*
Rasurado	~texto~
Monoespaçado	três crases antes e depois
Lista com marcas	* texto ou - texto por linha
Lista numerada	1. texto por linha