Ferramenta Valor Hash
NESTE ARTIGO
Quando uma API, plataforma de anúncios ou webhook exige um identificador com hash, a ferramenta Valor hash prepara esse valor diretamente na sua automação. Ela transforma os dados de origem em um hash consistente que o sistema de destino pode usar para correspondência ou validação sem receber o valor original nesse campo.
Assim, você atende aos requisitos técnicos da plataforma de destino sem precisar gerar hashes manualmente nem adicionar código personalizado a cada automação.
O uso de hash é comum em plataformas de anúncios, APIs, webhooks e sistemas que processam informações sensíveis. Um hash não é criptografia e não deve ser tratado como anonimização completa. Por isso, siga sempre os requisitos da plataforma de destino para o tratamento de dados.
Quando usar
Use Valor hash sempre que um serviço externo solicitar um valor com hash em vez do valor original. A ferramenta é especialmente útil quando você precisa padronizar essa transformação em todas as execuções da automação.
Exemplos comuns:
- enviar um endereço de e-mail, número de telefone ou identificador de cliente em formato de hash;
- preparar dados de usuários para plataformas como Facebook Conversions API;
- gerar valores de verificação para webhooks;
- criar assinaturas ou tokens que outro sistema possa validar.
Se a plataforma de destino espera receber o valor original, não use hash.
Como funciona
A ferramenta recebe um valor de uma etapa anterior e aplica o algoritmo de hash selecionado. Em seguida, o resultado gerado pode ser mapeado diretamente para uma solicitação de API, um webhook ou uma ação em outro app.
O processo é simples:
valor de entrada -> algoritmo de hash -> resultado do hash
É importante lembrar que o hash é previsível. A mesma entrada sempre gera o mesmo hash. Isso permite que outro sistema compare registros sem receber o valor original nesse campo.
Ao mesmo tempo, qualquer pequena alteração no valor de origem — um espaço adicional, um caractere diferente ou uma mudança no número de telefone — gera um resultado completamente diferente. Normalize os dados antes de aplicar o hash sempre que a plataforma de destino exigir um formato específico.
Campos da ferramenta
Algoritmo
Selecione o algoritmo de hash exigido pelo sistema de destino.
As opções mais comuns são:
- sha256 — o algoritmo de hash moderno mais utilizado e a opção padrão para muitas plataformas de anúncios e análise;
- md5 — ainda utilizado em alguns sistemas legados, webhooks e integrações personalizadas;
- algoritmos hmac-* — utilizados quando o hash também deve incluir uma chave secreta.
Sempre que possível, consulte a documentação do serviço que você está conectando. Se ela indicar um algoritmo específico, use essa opção.
Valor
O valor ao qual o hash será aplicado.
Pode ser:
- um dado recebido de um gatilho;
- a saída de outra ferramenta;
- uma string preparada anteriormente na automação.
Sal antes do valor
Um texto opcional adicionado antes do valor principal antes da geração do hash.
Fórmula:
hash(salt_before + value)
Use essa configuração somente quando o sistema de destino exigir isso explicitamente.
Sal depois do valor
Um texto opcional adicionado depois do valor principal antes da geração do hash.
Fórmula:
hash(value + salt_after)
A maioria das integrações não utiliza essa opção, mas alguns mecanismos personalizados de validação podem exigi-la.
Chave
Usado somente com algoritmos HMAC.
Para algoritmos comuns, como sha256 ou md5, deixe esse campo vazio.
Exemplo 1. Criar um valor de validação para um webhook
Neste exemplo, o hash é usado para verificar se uma solicitação foi gerada por uma fonte confiável.
A automação é iniciada quando um novo lead aparece no Bitrix24.
Em seguida, uma etapa JavaScript prepara uma string que combina vários valores em um único texto.
Antes de gerar o hash, o script:
- remove espaços desnecessários do nome do cliente;
- remove caracteres não numéricos do telefone;
- combina todos os valores necessários em uma única string.
A string resultante é enviada para Valor hash.
Configuração da ferramenta:
- Algoritmo = md5
- Valor = stringToHash da etapa JavaScript
- Sal antes do valor = vazio
- Sal depois do valor = vazio
- Chave = vazio
O hash gerado é então mapeado para a solicitação de webhook de saída.
Como resultado:
- O Bitrix24 fornece os dados do lead.
- O JavaScript prepara a string de validação.
- Valor hash gera o hash.
- O webhook envia o hash para o sistema de destino.
Essa abordagem permite que o sistema de destino verifique a solicitação sem expor o valor secreto original.
Exemplo 2. Enviar um número de telefone com hash para o Facebook Conversions API
Neste exemplo, um assinante novo ou atualizado no BotHelp inicia a automação. O telefone do assinante é preparado e enviado ao Facebook Conversions API como um hash SHA-256 junto com os dados do evento.
O Facebook pode comparar o hash com identificadores processados da mesma maneira em seu próprio sistema. Quando há uma correspondência, o identificador pode ajudar a associar o evento enviado pelo servidor ao registro de cliente relevante. Isso pode melhorar a correspondência de eventos e fornecer dados mais completos para a medição e atribuição de campanhas, sem enviar o número de telefone original nesse campo da API.
A automação usa quatro etapas:
- O BotHelp fornece os dados do assinante e do evento.
- Formatação de número de telefone converte o telefone de origem para o formato consistente esperado pelo destino.
- Valor hash aplica o algoritmo SHA-256 ao número normalizado.
- Facebook Conversions API recebe os detalhes do evento e o hash gerado.
O fluxo completo é este:
Primeiro, configure a etapa de formatação. Ela recebe o telefone do BotHelp e retorna um valor normalizado. A formatação antes da geração do hash é essencial: dois números visualmente semelhantes, mas escritos em formatos diferentes, geram hashes diferentes e podem não corresponder no sistema de destino.
Em seguida, configure Valor hash:
- Algoritmo = sha256
- Valor = Número formatado da etapa de formatação do telefone
- Sal antes do valor = vazio
- Sal depois do valor = vazio
- Chave = vazio
Por fim, mapeie o Resultado de Valor hash para o campo Número de telefone na ação do Facebook Conversions API. Preencha os outros campos do evento com dados do BotHelp ou de outras etapas anteriores.
Como resultado, cada evento qualificado do BotHelp é enviado automaticamente com um identificador de telefone formatado de maneira consistente e convertido em hash. Sua equipe não precisa mais normalizar e gerar o hash de cada valor manualmente, e o Facebook recebe o identificador no formato necessário para correspondência.
O uso de hash não elimina sua responsabilidade de coletar e processar os dados dos clientes de forma legal. Use esse fluxo somente quando tiver as permissões necessárias e quando ele estiver de acordo com as políticas da plataforma de destino.
Resumo
Valor hash ajuda você a atender aos requisitos das integrações sem transformar cada valor manualmente nem manter um código personalizado para geração de hashes.
Os cenários mais comuns incluem a preparação de identificadores de clientes para plataformas de anúncios e a geração de valores consistentes de verificação para webhooks ou solicitações de API.
Antes de configurar a ferramenta, consulte a documentação da plataforma de destino. Na maioria dos casos, ela especificará exatamente qual algoritmo e quais regras de formatação devem ser usados.
Isso respondeu à sua pergunta?