Ferramenta Hash Value

Quando uma API, plataforma de anúncios ou webhook exige um identificador com hash, a ferramenta Hash Value 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 Hash Value 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

Algorithm

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.

Value

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.

Salt before value

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.

Salt after value

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.

Key

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 Hash Value.

Configuração da ferramenta:

• Algorithm = md5
• Value = stringToHash da etapa JavaScript
• Salt before value = vazio
• Salt after value = vazio
• Key = vazio

O hash gerado é então mapeado para a solicitação de webhook de saída.

Como resultado:

1. O Bitrix24 fornece os dados do lead.
2. O JavaScript prepara a string de validação.
3. Hash Value gera o hash.
4. 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:

1. O BotHelp fornece os dados do assinante e do evento.
2. Phone number formatting converte o telefone de origem para o formato consistente esperado pelo destino.
3. Hash Value aplica o algoritmo SHA-256 ao número normalizado.
4. 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 Hash Value:

• Algorithm = sha256
• Value = Formatted number da etapa de formatação do telefone
• Salt before value = vazio
• Salt after value = vazio
• Key = vazio

Por fim, mapeie o Hash result de Hash Value para o campo Phone number 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

Hash Value 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.