Alterar Campo Adicional
Alterar Campo Adicional é um node de webhook. Sua função principal é: atualiza campos adicionais de lead, contato ou empresa usando uma entidade salva no contexto. 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
- Cria, busca ou atualiza entidades como lead, contato ou empresa.
- Executa chamada externa ou webhook; tenha rota de contingência para erro ou timeout.
- 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 |
|---|---|
| Tipo de entidade | define qual registro de negócio será criado, atualizado, buscado ou salvo no contexto. |
| Origem da entidade no contexto | identifica a origem operacional do registro para relatórios e segmentação. |
| Field Updates | controla a prevenção de duplicidade, geralmente por telefone ou e-mail. |
Orientações do node
O que faz
- Lê uma entidade do contexto do webhook.
- Atualiza um ou mais campos adicionais dessa entidade com valores do payload/contexto.
- Salva a entidade atualizada novamente no slot padrão do contexto.
Entradas configuráveis
- Tipo de entidade.
- Origem da entidade no contexto.
- Lista de campos adicionais e novos valores com suporte a variáveis.
Saídas
- Campo atualizado.
- Entidade ou campo indisponível.
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.