Herramienta Valor Hash

Cuando una API, una plataforma publicitaria o un webhook requiere un identificador con hash, la herramienta Valor hash prepara ese valor directamente dentro de tu automatización. Transforma los datos de origen en un hash consistente que el sistema de destino puede utilizar para la coincidencia o validación sin recibir el valor original en ese campo.

Esto te permite cumplir los requisitos técnicos de la plataforma de destino sin generar hashes manualmente ni añadir código personalizado a cada automatización.

El uso de hashes es habitual al trabajar con plataformas publicitarias, APIs, webhooks y sistemas que procesan información sensible. Un hash no es cifrado y no debe considerarse una anonimización completa. Sigue siempre los requisitos de tratamiento de datos de la plataforma de destino.

Cuándo usarla

Utiliza Valor hash cuando un servicio externo solicite un valor con hash en lugar del valor original. La herramienta resulta especialmente útil cuando necesitas estandarizar esta transformación en cada ejecución de la automatización.

Algunos ejemplos habituales:

• enviar una dirección de correo electrónico, un número de teléfono o un identificador de cliente en formato de hash;
• preparar datos de usuarios para plataformas como Facebook Conversions API;
• generar valores de verificación para webhooks;
• crear firmas o tokens que otro sistema pueda validar.

Si la plataforma de destino espera el valor original, no debes aplicar un hash.

Cómo funciona

La herramienta recibe un valor de un paso anterior y aplica el algoritmo de hash que selecciones. Después, el resultado generado puede asignarse directamente a una solicitud de API, un webhook o una acción en otra aplicación.

El proceso es sencillo:

valor de entrada -> algoritmo de hash -> resultado del hash

Es importante recordar que el hash es predecible. La misma entrada siempre genera el mismo hash. Esto permite que otro sistema compare registros sin recibir el valor original en ese campo.

Al mismo tiempo, cualquier cambio mínimo en el valor de origen — un espacio adicional, un carácter diferente o una modificación del número de teléfono — genera un resultado completamente distinto. Normaliza los datos antes de aplicar el hash cuando la plataforma de destino requiera un formato específico.

Campos de la herramienta

Algoritmo

Selecciona el algoritmo de hash requerido por el sistema de destino.

Las opciones más comunes son:

• sha256 — el algoritmo de hash moderno más utilizado y la opción estándar para muchas plataformas publicitarias y de analítica;
• md5 — todavía se utiliza en algunos sistemas heredados, webhooks e integraciones personalizadas;
• algoritmos hmac-* — se utilizan cuando el hash también debe incluir una clave secreta.

Siempre que sea posible, consulta la documentación del servicio que estás conectando. Si indica un algoritmo específico, utiliza esa opción.

Valor

El valor al que se aplicará el hash.

Puede ser:

• un dato recibido de un disparador;
• la salida de otra herramienta;
• una cadena preparada anteriormente en la automatización.

Sal antes del valor

Un texto opcional que se añade antes del valor principal antes de generar el hash.

Fórmula:

hash(salt_before + value)

Utiliza esta configuración únicamente cuando el sistema de destino la requiera expresamente.

Sal después del valor

Un texto opcional que se añade después del valor principal antes de generar el hash.

Fórmula:

hash(value + salt_after)

La mayoría de las integraciones no utilizan esta opción, pero algunos mecanismos de validación personalizados pueden requerirla.

Clave

Se utiliza únicamente con algoritmos HMAC.

Para algoritmos de hash comunes, como sha256 o md5, deja este campo vacío.

Ejemplo 1. Crear un valor de validación para un webhook

En este ejemplo, el hash se utiliza para verificar que una solicitud se ha generado desde una fuente de confianza.

La automatización se inicia cuando aparece un nuevo lead en Bitrix24.

A continuación, un paso de JavaScript prepara una cadena que combina varios valores en un único texto.

Antes de crear el hash, el script:

• elimina los espacios innecesarios del nombre del cliente;
• elimina los caracteres no numéricos del número de teléfono;
• combina todos los valores necesarios en una sola cadena.

La cadena resultante se envía a Valor hash.

Configuración de la herramienta:

• Algoritmo = md5
• Valor = stringToHash del paso de JavaScript
• Sal antes del valor = vacío
• Sal después del valor = vacío
• Clave = vacío

El hash generado se asigna a la solicitud de webhook de salida.

Como resultado:

1. Bitrix24 proporciona los datos del lead.
2. JavaScript prepara la cadena de validación.
3. Valor hash genera el hash.
4. El webhook envía el hash al sistema de destino.

Este enfoque permite que el sistema de destino verifique la solicitud sin exponer el valor secreto original.

Ejemplo 2. Enviar un número de teléfono con hash a Facebook Conversions API

En este ejemplo, un suscriptor nuevo o actualizado en BotHelp inicia la automatización. El número de teléfono del suscriptor se prepara y se envía a Facebook Conversions API como un hash SHA-256 junto con los datos del evento.

Facebook puede comparar el hash con identificadores procesados de la misma forma en su propio sistema. Cuando existe una coincidencia, el identificador puede ayudar a asociar el evento enviado desde el servidor con el registro de cliente correspondiente. Esto puede mejorar la coincidencia de eventos y proporcionar a tu equipo datos más completos para la medición y atribución de campañas, sin enviar el número de teléfono original en ese campo de la API.

La automatización utiliza cuatro pasos:

1. BotHelp proporciona los datos del suscriptor y del evento.
2. Formato de número de teléfono convierte el teléfono de origen al formato consistente que espera el destino.
3. Valor hash aplica el algoritmo SHA-256 al número normalizado.
4. Facebook Conversions API recibe los detalles del evento y el hash generado.

El flujo completo es el siguiente:

Primero, configura el paso de formato. Recibe el número de teléfono de BotHelp y devuelve un valor normalizado. Dar formato antes de generar el hash es esencial: dos números visualmente similares escritos en formatos diferentes generan hashes distintos y podrían no coincidir en el sistema de destino.

A continuación, configura Valor hash:

• Algoritmo = sha256
• Valor = Número formateado del paso de formato del teléfono
• Sal antes del valor = vacío
• Sal después del valor = vacío
• Clave = vacío

Por último, asigna el Resultado de Valor hash al campo Número de teléfono de la acción de Facebook Conversions API. Completa los demás campos del evento con datos de BotHelp o de otros pasos anteriores.

Como resultado, cada evento de BotHelp que cumple las condiciones se envía automáticamente con un identificador telefónico formateado de manera consistente y convertido en hash. Tu equipo ya no necesita normalizar ni generar manualmente el hash de cada valor, y Facebook recibe el identificador en el formato requerido para la coincidencia.

El uso de hashes no elimina tu responsabilidad de recopilar y procesar los datos de los clientes de forma legal. Utiliza este flujo únicamente cuando tengas los permisos necesarios y cumpla las políticas de la plataforma de destino.

Resumen

Valor hash te ayuda a cumplir los requisitos de las integraciones sin transformar manualmente cada valor ni mantener código personalizado para generar hashes.

Los escenarios habituales incluyen preparar identificadores de clientes para plataformas publicitarias y generar valores de verificación consistentes para webhooks o solicitudes de API.

Antes de configurar la herramienta, consulta la documentación de la plataforma de destino. En la mayoría de los casos, especificará exactamente qué algoritmo y qué reglas de formato deben utilizarse.