Pular para o conteúdo principal

Output

Descrição

A função Output retorna o resultado de uma função AMPscript e insere esse resultado diretamente no conteúdo renderizado. Ela é essencial quando você está dentro de um bloco %%[...]%% e precisa imprimir algo no HTML - já que, dentro desses blocos, o conteúdo não é exibido automaticamente. A função só aceita outra função AMPscript como parâmetro; se você passar uma string literal ou qualquer outro valor direto, ela não produz nenhuma saída.

Sintaxe

Output(value)

Parâmetros

ParâmetroTipoObrigatórioDescrição
valueFunção AMPscriptSimA função cujo resultado será exibido no conteúdo renderizado. Deve ser uma função AMPscript (como Concat() ou v()), não um valor literal.

Exemplo básico

Exibindo o nome de um cliente dentro de um bloco de código AMPscript em um e-mail da Lojas Vitória:

%%[
SET @nome = "Maria Santos"
Output(v(@nome))
]%%

Saída:

Maria Santos

Exemplo avançado

Montando uma mensagem personalizada para uma régua de boas-vindas, combinando Output com Concat e v para exibir diferentes trechos dinâmicos dentro de um único bloco de código:

%%[
SET @primeiroNome = "João"
SET @valorCredito = "R$ 150,00"
SET @loja = "MegaStore"

Output(Concat("Olá, ", v(@primeiroNome), "! Você ganhou um crédito de ", v(@valorCredito), " para usar na ", v(@loja), "."))
Output(Concat(" Aproveite essa oferta até 31/12/2025."))
]%%

Saída:

Olá, João! Você ganhou um crédito de R$ 150,00 para usar na MegaStore. Aproveite essa oferta até 31/12/2025.

Observações

⚠️ Atenção: A função Output só funciona com funções AMPscript aninhadas como parâmetro. Se você passar uma string literal diretamente - por exemplo, Output("texto qualquer") - nada será exibido. Para imprimir o valor de uma variável, envolva-a com v(): use Output(v(@variavel)) e não Output(@variavel).

  • Fora de um bloco %%[...]%%, você pode exibir valores simplesmente usando a sintaxe inline %%=v(@variavel)=%%. A função Output é necessária justamente quando você está dentro de um bloco de código e precisa inserir conteúdo no HTML renderizado sem sair do bloco.

  • Se você precisa que cada saída apareça em uma nova linha, considere usar OutputLine, que adiciona automaticamente uma quebra de linha após o conteúdo.

Funções relacionadas

  • V - retorna o valor de uma variável; par natural do Output para exibir variáveis
  • OutputLine - semelhante ao Output, mas adiciona quebra de linha ao final
  • Concat - concatena strings; frequentemente usada dentro do Output para montar textos dinâmicos
  • TreatAsContent - processa uma string como se fosse conteúdo AMPscript renderizável