Variáveis de pagamento direto nas mensagens

Para que servem

Variáveis são trechos que você escreve na mensagem e que o sistema substitui pelos dados reais na hora do envio. Assim você escreve uma mensagem e ela sai personalizada em todas as reservas.

As variáveis abaixo trazem os dados de recebimento cadastrados na propriedade da reserva.

As oito variáveis de recebimento

{{beneficiaryName}} — o nome de quem vai receber o pagamento.

{{pixKey}} — a chave Pix cadastrada.

{{pixKeyType}} — o tipo da chave (CPF, CNPJ, e-mail, telefone ou chave aleatória).

{{bankName}} — o banco.

{{bankAgency}} — a agência.

{{bankAccount}} — a conta.

{{bankAccountType}} — o tipo da conta (corrente ou poupança).

{{paymentInstructions}} — o texto livre que você escreveu em "Instruções adicionais" na propriedade.

Elas aparecem na lista de variáveis do editor somente na seção Pagamento direto ao proprietário, em Automações → Pós-reserva.

Gestor e beneficiário não são a mesma coisa

Esta é a confusão mais cara de todas, e vale a pena guardar:

{{ownerName}} é o responsável pelo seu negócio — o gestor da conta. É o mesmo significado que essa variável já tem nas mensagens de check-in e de equipe. Sirva-se dela para assinar a mensagem.

{{beneficiaryName}} é quem receberá o pagamento daquela propriedade — o titular da chave Pix.

Nas operações que administram imóveis de terceiros, essas duas pessoas quase nunca são a mesma. Usar {{ownerName}} para dizer para quem transferir o dinheiro colocaria o nome errado ao lado da chave Pix.

Quando elas são preenchidas

As variáveis de recebimento só trazem valores na situação Pagamento direto ao proprietário.

Nas demais situações — Pix pelo Asaas, Cartão pelo Asaas, Pagar depois e Mensagem padrão — elas saem vazias de propósito. É uma proteção: o hóspede que já pagou pelo pagamento online não pode receber uma chave Pix na mesma mensagem e acabar pagando duas vezes.

Se você pré-visualizar uma dessas situações usando essas variáveis, a tela avisa que elas saem vazias.

Variável sem dado vira linha vazia

Se um campo não estiver cadastrado na propriedade, a variável correspondente é substituída por nada — não aparece a palavra "undefined" nem o nome da variável entre chaves.

Na prática, isso significa escrever a mensagem de um jeito que continue fazendo sentido se a conta bancária, por exemplo, não estiver preenchida.

Exemplo de mensagem

Olá {{guestFirstName}}, sua reserva em {{propertyName}} está confirmada!

Entrada: {{checkInDate}}

Saída: {{checkOutDate}}

Valor: {{totalAmount}}

Para concluir, faça o Pix para:

Favorecido: {{beneficiaryName}}

Chave ({{pixKeyType}}): {{pixKey}}

{{paymentInstructions}}

Qualquer dúvida, é só responder.

{{ownerName}}

Erros comuns

Usar {{ownerName}} onde se queria {{beneficiaryName}}.

Usar as variáveis de recebimento na mensagem padrão e estranhar as linhas em branco.

Escrever "Banco: {{bankName}}" numa propriedade que só tem Pix cadastrado — a linha fica pela metade.

Perguntas frequentes

Preciso digitar a chave Pix na mensagem?

Não, e é melhor não digitar. Usando {{pixKey}}, cada propriedade envia a sua própria chave, e uma correção no cadastro vale para todas as mensagens seguintes.

Essas variáveis funcionam nos templates do Pipeline?

Não. No envio manual do Pipeline elas sairiam vazias, por isso não são oferecidas naquela tela. Veja a diferença entre as duas áreas.