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.
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.
Última Atualização: 04.09.2025
ou