---
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/help/integrations/bloomreach
language: es
---

1. [Centro de ayuda](https://scratcher.io/es/help)
2. [Integraciones](https://scratcher.io/es/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 se actualiza como cliente en tu proyecto de Bloomreach Engagement, identificada por su dirección de correo. También puedes darle un consentimiento de Bloomreach, para poder enviarle marketing.

## Lo que 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 grupo nuevo con **Private access** y ponle un nombre, por ejemplo «Scratcher».
4. Crea una clave de API nueva en el grupo. Copia el **API key ID** y el **API secret**. El secreto solo se muestra una vez.
5. Da al grupo los permisos de abajo y guarda.

## Permisos que necesita la clave

En los permisos del grupo, permite:

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

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

## Paso 2: conecta Bloomreach a 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 comprueba 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 has conectado más de un proyecto, elígelo en **Seleccionar cuenta**.
3. En **Asignaciones de campos**, haz clic en **Añadir asignación de campos** y empareja 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 debe recibir la gente, por ejemplo «newsletter», o ninguna.
5. En **Filtrar por consentimientos (opcional)**, elige tu casilla de consentimiento de marketing, para que solo se envíe a quienes la marcaron.
6. Haz clic en **Guardar** y luego en **Probar**.

> Conviene saber: Bloomreach no tiene listas. Todo el mundo entra en el 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 publicar la campaña, o configúrala enseguida.

## Asignación de campos

- La dirección de correo siempre se envía y se usa para encontrar al cliente. No hace falta asignarla.
- La lista **Campo de destino** muestra las propiedades de cliente de tu proyecto. Si falta una propiedad, créala antes en Bloomreach.
- Para marcar de dónde vienen los clientes, asigna 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 consentimientos** para que solo reciban el consentimiento quienes marcaron tu casilla de marketing.

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

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

## Solución de problemas

- «Algunos o todos los campos no son válidos...» al instalar: revisa la API base URL y el project token, y vuelve a copiar el key ID y el secreto.
- Los envíos fallan con un error de acceso: al grupo de API le falta uno de los permisos de arriba. Edítalo en Bloomreach.
- El consentimiento no aparece en el cliente: la categoría de consentimiento no existe en Bloomreach o se escribe de otra forma.
- Bloomreach tiene sus propias guías sobre las claves de API. Busca "API access management" en la documentación de Bloomreach si los menús son distintos.

Integraciones

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

Sigue aprendiendo

## Artículos relacionados

- [Cómo funcionan las integraciones](https://scratcher.io/es/help/integrations/how-integrations-work): Conecta una vez tu herramienta de email o tu CRM, actívala en cada campaña, elige una lista, asigna tus campos y envía solo a quienes han dado su consentimiento.
- [Consulta el estado de la entrega y reenvía leads](https://scratcher.io/es/help/integrations/delivery-status): Mira qué leads se han enviado a tus herramientas, entiende los mensajes de error, corrige el problema y vuelve a enviarlos.
- [Pedir el consentimiento y añadir términos y condiciones](https://scratcher.io/es/help/forms/consent-and-permissions): Añade casillas de consentimiento para la newsletter, enlaza tus condiciones, elige qué casilla suscribe a la gente 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/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.
- **[Reserva una reunión](https://scratcher.io/es/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.
