Como mapear variáveis de eventos
Caso o webhook envie variáveis com nomes personalizados ou estruturas aninhadas, é possível inserir um exemplo em JSON e mapear manualmente os campos do webhook para as variáveis do evento. Por exemplo, para enviar um e-mail, o sistema precisa saber qual campo contém o endereço de e-mail, mesmo que ele tenha um nome diferente ou esteja aninhado dentro de um objeto.
Neste artigo, explicaremos como mapear variáveis em um evento personalizado.
Como criar um evento e selecionar uma estrutura de dados
Acesse Automação > Gerenciador de eventos e clique em Adicionar novo evento. Selecione um tipo de evento.
Saiba mais: Como criar eventos.
Em Estrutura de dados, selecione Personalizado como o tipo de estrutura.

Insira uma estrutura de dados de entrada
Para mapear variáveis, comece adicionando uma amostra dos dados que seu webhook irá enviar. Isso permitirá que o sistema leia as variáveis disponíveis e as sugira para o mapeamento.
Clique em Fazer upload dos dados e escolha como inserir os dados:
| Inserir código | Insira manualmente ou cole o JSON no campo de entrada. Clique em Fazer upload. |
| Importar da URL | Insira um link para um arquivo ou solicitação para que o sistema possa recuperar automaticamente os dados em JSON. Clique em Obter e visualize a estrutura no campo abaixo. |
Depois de adicionar os dados, você verá o rótulo Dados recebidos ao lado do botão Fazer upload.

Como mapear variáveis
Vincule os campos do webhook às variáveis da Automação nas seguintes colunas:
| Campo de webhook | Escolha um campo da estrutura do evento que você fez upload. Se o campo fizer parte de um objeto aninhado, você pode expandir a estrutura de dados para encontrá-lo. Clique na seta e selecione um valor. |
| Variável de evento | Insira o nome de uma variável Automação. A lista de variáveis disponíveis varia de acordo com o tipo de evento. |
| Tipos de dados |
|
Para identificar os contatos que passam pelo seu fluxo, mapeie as variáveis de e-mail ou telefone. Lembre-se de mapear quaisquer outras variáveis de fluxo relevantes, como as condições do Filtro.

Se um valor não corresponder ao tipo de variável, o sistema não o salvará nem exibirá uma mensagem de erro. A variável ficará vazia no e-mail, o valor não será salvo na lista de endereçamento nem enviado aos webhooks. Isso ajuda o sistema a processar grandes volumes de dados de contato recebidos.
Para visualizar as variáveis do contato recebidas pelo evento, abra o registro de eventos.
Se você não puder alterar o formato dos dados no seu sistema, exclua a variável nas configurações do evento e crie outra variável do tipo Texto com o mesmo nome.
Se o fluxo copiar contatos para uma lista de endereçamento, exclua essa variável também da lista. Caso contrário, o valor não será salvo nela. Seus modelos continuarão funcionando sem alterações, pois o nome da variável permanecerá o mesmo.
Verifique os nomes das variáveis
Os nomes das variáveis no modelo e no evento precisam ser exatamente iguais. Caso contrário, o valor não aparecerá no e-mail:
- Use apenas letras latinas básicas (a–z). Letras acentuadas, como é ou ü, e letras de outros alfabetos parecidas com as latinas criam uma variável diferente, mesmo que o nome pareça correto.
- Use sublinhados em vez de pontos. O sistema interpreta
data.pricecomo a variávelpricedo conjuntodata. - Respeite o uso de maiúsculas e minúsculas.
Productseproductssão duas variáveis diferentes. - Mantenha as tags HTML fora das chaves duplas
{{ }}. Por exemplo, use<b>{{name}}</b>, e não{{<b>name</b>}}.
Saiba mais: Como enviar conjuntos de dados com a Automação 360.
Como usar variáveis não mapeadas
Mesmo que você não faça o mapeamento de certas variáveis, elas ainda estarão disponíveis na Automação. Essas variáveis não mapeadas:
- ficam disponíveis em elementos com campos de conteúdo (mensagens, títulos e nomes);
- são adicionadas automaticamente a partir da estrutura de dados;
- são transmitidas como referências JSONPath;
- são reconhecidas como
Stringpor padrão.
Para usar variáveis JSONPath no seu fluxo, marque a opção Transferir dados adicionais para o fluxo nas configurações do evento.

Você pode adicionar variáveis aos fluxos acionados pelo evento criado.
É possível inserir variáveis JSONPath nos seguintes elementos:
| Elemento* | Onde inserir a variável |
| Assunto, pré-cabeçalho e corpo do e-mail. | |
| SMS, aplicativo de mensagens, WhatsApp, Viber | Texto da mensagem. |
| Ação | Qualquer campo que aceite variáveis, incluindo nomes de negócios, de contatos, de tarefas e outros. |
*As variáveis mapeadas na estrutura do evento são compatíveis com todos os elementos do seu fluxo automatizado.
Use a sintaxe {{$[path]}}, onde [path] é o JSONPath da sua variável. Por exemplo, se a matriz for assim:
{
"data": {
"user": {
"name": "Alex",
"contact_info": {
"email": "alex@example.com",
"phone": "(601) 484-5378"
}
},
"order": {
"number": "WORD-20250730",
"items_count": 2,
"total_price": 1899
}
}
}
A sua mensagem pode ficar assim:
Olá, {{$['data']['user']['name']}}!
Seu pedido nº {{$['data']['order']['number']}} está em processamento.
Entraremos em contato caso seja necessário. Agradecemos a preferência!
Nesse caso, as variáveis name e number podem não estar mapeadas na estrutura do seu evento.

Para visualizar os dados de cada evento executado, vá para Gerenciador de eventos > Log.
ou