# Ferramenta Valor Hash — Central de Ajuda da Albato Source: https://albato.com/br/wiki/articles/hash-value-tool Bem-vindo ao Central de Ajuda da Albato Buscar artigos # Ferramenta Valor Hash Última atualização: 23/6/2026 · 6 min de leitura * * * 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: 1. O Bitrix24 fornece os dados do lead. 2. O JavaScript prepara a string de validação. 3. Valor hash 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. Formatação de número de telefone converte o telefone de origem para o formato consistente esperado pelo destino. 3. Valor hash 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: Fluxo com BotHelp, formatação do telefone, Valor hash e Facebook Conversions API 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. Normalização do telefone do assinante do BotHelp 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 Configuração do hash SHA-256 para o telefone formatado 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. Mapeamento do resultado do hash para o Facebook Conversions API 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. ## Artigos relacionados - [Como Enviar Dados de um Pagamento Bem-Sucedido no Stripe Para o Meta Conversions API (CAPI)](https://albato.com/br/wiki/articles/how-to-send-data-from-a-successful-stripe-payment-to-the-meta-conversions-api-capi) Isso respondeu à sua pergunta?