---
title: "Conecta Bloomreach"
description: "Crea una clave de API en Bloomreach Engagement, conéctala y crea o actualiza clientes con sus consentimientos."
url: https://scratcher.io/es-419/help/integrations/bloomreach
language: es-419
---

1. [Centro de ayuda](https://scratcher.io/es-419/help)
2. [Integraciones](https://scratcher.io/es-419/help/integrations)
3. Conecta Bloomreach

# Conecta Bloomreach

Crea una clave de API en Bloomreach Engagement, conéctala y crea o actualiza clientes con sus consentimientos.

Con la integración de Bloomreach, cada persona que se registra se crea o actualiza como cliente en tu proyecto de Bloomreach Engagement, identificada por su dirección de correo electrónico. También puedes asignarle un consentimiento de Bloomreach para poder enviarle comunicaciones de marketing.

## Qué necesitas

- Un proyecto de Bloomreach Engagement y un usuario que pueda gestionar el acceso a la API en la configuración del proyecto (normalmente, un administrador del proyecto).

## Paso 1: Crea una clave de API en Bloomreach

1. En Bloomreach Engagement, abre el proyecto y ve a **Project settings** > **Access management** > **API**.
2. Copia el **Project token** y la **API base URL** que aparecen en la página.
3. En los grupos de API, crea un nuevo grupo con **Private access** y ponle un nombre, por ejemplo, "Scratcher".
4. Crea una nueva clave de API en el grupo. Copia el **API key ID** y el **API secret**. El secreto solo se muestra una vez.
5. Asigna al grupo los permisos que se indican a continuación y guarda.

## Permisos que necesita la clave

En los permisos del grupo, habilita:

- **Customer properties**: get y set, para buscar clientes, crearlos o actualizarlos, y mostrar tus propiedades de cliente en el mapeo de campos.
- **Events**: set, para el evento `consent`, de modo que Scratcher pueda registrar los consentimientos.

No se necesita nada más. Sin los permisos de set, los envíos fallan con el error de acceso propio de Bloomreach.

## Paso 2: Conecta Bloomreach con Scratcher

1. En Scratcher, ve a **Configuración** > **Integraciones** y haz clic en **Bloomreach**.
2. Pega la API base URL, el project token, el API key ID y el API secret en los campos correspondientes.
3. Haz clic en **Instalar integración**. Scratcher verifica los datos con Bloomreach.

## Paso 3: Actívala en una campaña

1. En el editor, ve a **Conectar** > **Integraciones** > **Bloomreach** y haz clic en **Activar**.
2. Si conectaste más de un proyecto, elígelo en **Seleccionar cuenta**.
3. En **Mapeo de campos**, haz clic en **Añadir mapeo de campo** y asocia cada **Campo de Scratcher** con una propiedad de cliente de Bloomreach; por ejemplo, "Lead - Nombre" con **first\_name**.
4. Elige la categoría de consentimiento que deben recibir las personas, por ejemplo "newsletter", o ninguna.
5. En **Filtrar por permisos (opcional)**, elige tu casilla de consentimiento de marketing para que solo se envíen las personas que la marcaron.
6. Haz clic en **Guardar** y luego en **Probar**.

> Bueno saberlo: Bloomreach no tiene listas. Todos entran al proyecto y tú los agrupas con segmentos en Bloomreach. Por eso, Scratcher empieza a enviar en cuanto haces clic en **Activar**. Actívala antes de que la campaña esté en vivo o configúrala de inmediato.

## Mapeo de campos

- La dirección de correo electrónico siempre se envía y se usa para encontrar al cliente. No necesitas mapearla.
- La lista **Campo de destino** muestra las propiedades de cliente de tu proyecto. Si falta alguna, créala primero en Bloomreach.
- Para indicar de dónde vienen los clientes, mapea un **Usar valor personalizado**, como "Juego de verano de Scratcher", a una propiedad que uses para el origen.

## Consentimiento

Si eliges una categoría de consentimiento, Scratcher registra un evento `consent` con la acción accept y el nombre de la campaña como origen. La categoría debe existir en Bloomreach (en la configuración de consentimientos de **Project settings**). Usa **Filtrar por permisos** para que solo reciban el consentimiento las personas que marcaron tu casilla de marketing.

## Qué se envía y cuándo

Los nuevos registros se envían en uno o dos minutos. Al activar la integración, también se envían los leads existentes de la campaña. Cuando alguien vuelve a participar, el cliente se actualiza. Revisa cada envío en **Configuración** > **Integraciones** > **Estado de envío**. Consulta [Revisar el estado de envío y reenviar leads](https://scratcher.io/es-419/help/integrations/delivery-status).

## Solución de problemas

- "All or some of the fields are invalid..." al instalar: revisa la API base URL y el project token, y vuelve a copiar el ID de la clave y el secreto.
- Los envíos fallan con un error de acceso: al grupo de API le falta alguno de los permisos indicados arriba. Edítalo en Bloomreach.
- El consentimiento no aparece en el cliente: la categoría de consentimiento no existe en Bloomreach o está escrita de otra forma.
- Bloomreach tiene sus propias guías sobre claves de API. Busca "API access management" en la documentación de Bloomreach si los menús se ven diferentes.

Integraciones

- [Cómo funcionan las integraciones](https://scratcher.io/es-419/help/integrations/how-integrations-work)
- [Todas las integraciones](https://scratcher.io/es-419/help/integrations/other-integrations)
- [Revisa el estado de envío y reenvía leads](https://scratcher.io/es-419/help/integrations/delivery-status)
- [Conecta HubSpot](https://scratcher.io/es-419/help/integrations/hubspot)
- [Conecta Salesforce Marketing Cloud](https://scratcher.io/es-419/help/integrations/salesforce-marketing-cloud)
- [Conecta Microsoft Dynamics 365 con Zapier](https://scratcher.io/es-419/help/integrations/microsoft-dynamics-365)
- [Conecta Emarsys](https://scratcher.io/es-419/help/integrations/emarsys)
- [Conecta Klaviyo](https://scratcher.io/es-419/help/integrations/klaviyo)
- [Conecta Mailchimp](https://scratcher.io/es-419/help/integrations/mailchimp)
- [Conecta ActiveCampaign](https://scratcher.io/es-419/help/integrations/activecampaign)
- [Conecta Apsis One](https://scratcher.io/es-419/help/integrations/apsis-one)
- [Conecta Drip](https://scratcher.io/es-419/help/integrations/drip)
- [Conecta HeyLoyalty](https://scratcher.io/es-419/help/integrations/heyloyalty)
- [Conecta Peytz](https://scratcher.io/es-419/help/integrations/peytz)
- [Conecta Marketingplatform](https://scratcher.io/es-419/help/integrations/marketingplatform)
- [Conecta Campaign Monitor con Zapier](https://scratcher.io/es-419/help/integrations/campaign-monitor)
- [Conecta ActiveTrail con Zapier](https://scratcher.io/es-419/help/integrations/activetrail)
- [Conecta Bloomreach](https://scratcher.io/es-419/help/integrations/bloomreach)
- [Conecta Iterable](https://scratcher.io/es-419/help/integrations/iterable)
- [Conectar Mapp](https://scratcher.io/es-419/help/integrations/mapp)
- [Conecta Agillic](https://scratcher.io/es-419/help/integrations/agillic)
- [Conecta Ortto](https://scratcher.io/es-419/help/integrations/ortto)
- [Conecta Emarketeer](https://scratcher.io/es-419/help/integrations/emarketeer)
- [Conecta Shopify](https://scratcher.io/es-419/help/integrations/shopify)
- [Conecta Hello Retail](https://scratcher.io/es-419/help/integrations/hello-retail)
- [Conecta más de 8.000 apps con Zapier](https://scratcher.io/es-419/help/integrations/zapier)
- [Conecta monday.com con Zapier](https://scratcher.io/es-419/help/integrations/monday-com)
- [Conecta Asana con Zapier](https://scratcher.io/es-419/help/integrations/asana)
- [Conecta Podio con Zapier](https://scratcher.io/es-419/help/integrations/podio)
- [Conecta Intercom con Zapier](https://scratcher.io/es-419/help/integrations/intercom)

Sigue aprendiendo

## Artículos relacionados

- [Cómo funcionan las integraciones](https://scratcher.io/es-419/help/integrations/how-integrations-work): Conecta tu herramienta de email o CRM una sola vez, actívala en cada campaña, elige una lista, asigna tus campos y envía solo a las personas que dieron su consentimiento.
- [Revisa el estado de envío y reenvía leads](https://scratcher.io/es-419/help/integrations/delivery-status): Consulta qué leads se enviaron a tus herramientas, entiende los mensajes de error, soluciona el problema y vuelve a enviarlos.
- [Solicita el consentimiento y agrega términos y condiciones](https://scratcher.io/es-419/help/forms/consent-and-permissions): Agrega casillas de consentimiento para newsletters, enlaza tus términos, elige qué casilla suscribe a las personas y envía a tu herramienta de email solo a quienes dijeron que sí.

¿Necesitas ayuda?

## ¿Sigues necesitando ayuda?

Hay personas reales para ayudarte. Si ya usas Scratcher, lo más rápido es el chat dentro de la plataforma.

- **[Chatea con nosotros](https://platform.scratcher.io/es-419/login)**

    Inicia sesión y haz clic en el botón del chat, abajo a la derecha. Rex responde al instante y nuestro equipo está a un clic.
- **[Agenda una reunión](https://scratcher.io/es-419/book-a-meeting)**

    Una videollamada gratuita de 30 minutos con nuestro equipo: una demostración, ideas para campañas o ayuda con tu configuración.
- **[Escríbenos](mailto:contact@scratcher.io)**

    Escribe a contact@scratcher.io y te responderemos.
