Mapear Usuário
Mapear Usuário é um node de webhook. Sua função principal é: resolve um usuário a partir de um valor do webhook, por e-mail ou de/para. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma.
Quando usar
Use quando o evento recebido por webhook precisar ser interpretado, enriquecido ou convertido em ação na Agilize.
Impacto operacional
- Lê ou grava variáveis de contexto que podem ser usadas pelos próximos nodes.
Entradas e saídas
Este node recebe 1 entrada e possui 2 saídas. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo.
Campos de configuração
| Campo | Como preencher |
|---|---|
| Valor de origem | identifica a origem operacional do registro para relatórios e segmentação. |
| Estratégia de mapeamento | campo de configuração do node. Preencha apenas quando ele for necessário para o comportamento desejado. |
| Variável de destino no contexto | texto enviado, registrado ou usado como base da ação. Quando aceitar variáveis, valide se elas estarão preenchidas no momento da execução. |
| Value Mappings | lê ou grava valores no contexto para reaproveitamento em nodes posteriores. |
Orientações do node
O que faz
- Lê um valor do payload/contexto e tenta encontrar um usuário correspondente.
- Pode buscar automaticamente por e-mail ou usar regras de de/para.
- Salva o resultado em context.userMapping para uso por nós seguintes.
Entradas configuráveis
- Valor de origem: texto literal ou variável do evento.
- Estratégia de mapeamento: por e-mail, de/para ou combinações com fallback.
- Regras de de/para: opcional, quando a estratégia usar tabela de valores.
Saídas
- Usuário encontrado: quando o mapeamento resolve um usuário.
- Sem correspondência: quando não há match.
Boas práticas
- Teste o node em um fluxo controlado e confira o histórico gerado antes de usar em uma automação crítica.
- Em webhooks, confirme se os campos do payload existem em todos os cenários do sistema de origem.
Como validar
- Configure o node em um fluxo de teste antes de publicar.
- Execute com um registro, conversa ou payload controlado.
- Confira se o caminho seguido, os dados criados e as mensagens enviadas correspondem ao resultado esperado.
- Revise o histórico da entidade, conversa ou execução para confirmar o impacto real.
Próximos passos
Volte para a referência de Nodes de webhooks ou combine este node com outros nodes do mesmo fluxo para completar a jornada.