---
title: "Conecte o Bloomreach"
description: "Crie uma chave de API no Bloomreach Engagement, conecte-a e crie ou atualize clientes com seus consentimentos."
url: https://scratcher.io/pt-br/help/integrations/bloomreach
language: pt-BR
---

1. [Central de ajuda](https://scratcher.io/pt-br/help)
2. [Integrações](https://scratcher.io/pt-br/help/integrations)
3. Conecte o Bloomreach

# Conecte o Bloomreach

Crie uma chave de API no Bloomreach Engagement, conecte-a e crie ou atualize clientes com seus consentimentos.

Com a integração do Bloomreach, todos que se cadastram são criados ou atualizados como clientes no seu projeto do Bloomreach Engagement, identificados pelo endereço de e-mail. Você também pode atribuir a eles um consentimento do Bloomreach, para poder enviar comunicações de marketing.

## O que você precisa

- Um projeto no Bloomreach Engagement e um usuário que possa gerenciar o acesso à API nas configurações do projeto (normalmente um administrador do projeto).

## Etapa 1: Crie uma chave de API no Bloomreach

1. No Bloomreach Engagement, abra o projeto e acesse **Project settings** > **Access management** > **API**.
2. Copie o **Project token** e a **API base URL** exibidos na página.
3. Em API groups, crie um novo grupo com **Private access** e dê um nome a ele, por exemplo, “Scratcher”.
4. Crie uma nova chave de API no grupo. Copie o **API key ID** e o **API secret**. O secret é exibido apenas uma vez.
5. Conceda ao grupo as permissões abaixo e salve.

## Permissões necessárias para a chave

Nas permissões do grupo, permita:

- **Customer properties**: get e set, para localizar clientes, criá-los ou atualizá-los e exibir as propriedades de cliente no mapeamento de campos.
- **Events**: set, para o evento `consent`, para que o Scratcher possa registrar consentimentos.

Nada mais é necessário. Sem as permissões de set, os envios falham com o erro de acesso do próprio Bloomreach.

## Etapa 2: Conecte o Bloomreach ao Scratcher

1. No Scratcher, acesse **Configurações** > **Integrações** e clique em **Bloomreach**.
2. Cole a API base URL, o project token, o API key ID e o API secret nos campos correspondentes.
3. Clique em **Instalar integração**. O Scratcher verifica os dados com o Bloomreach.

## Etapa 3: Ative na campanha

1. No editor, acesse **Conectar** > **Integrações** > **Bloomreach** e clique em **Ativar**.
2. Se você conectou mais de um projeto, escolha-o em **Selecionar conta**.
3. Em **Mapeamento de campos**, clique em **Adicionar mapeamento de campo** e associe cada **Campo do Scratcher** a uma propriedade de cliente do Bloomreach, por exemplo, “Lead - Nome” a **first\_name**.
4. Escolha a categoria de consentimento que as pessoas devem receber, por exemplo, “newsletter”, ou nenhuma.
5. Em **Filtrar por permissões (opcional)**, escolha sua caixa de seleção de consentimento de marketing, para que apenas quem a marcou seja enviado.
6. Clique em **Salvar** e depois em **Testar**.

> Bom saber: o Bloomreach não tem listas. Todos entram no projeto, e você os agrupa com segmentos no Bloomreach. Por isso, o Scratcher começa a enviar assim que você clica em **Ativar**. Ative antes de a campanha entrar no ar ou configure tudo imediatamente.

## Mapeamento de campos

- O endereço de e-mail é sempre enviado e usado para localizar o cliente. Não é preciso mapeá-lo.
- A lista **Campo de destino** mostra as propriedades de cliente do seu projeto. Se faltar alguma, crie a propriedade no Bloomreach primeiro.
- Para indicar a origem dos clientes, mapeie um **Usar valor personalizado**, como “Jogo de verão Scratcher”, para uma propriedade que você usa como origem.

## Consentimento

Se você escolher uma categoria de consentimento, o Scratcher registra um evento `consent` com a ação accept e o nome da campanha como origem. A categoria precisa existir no Bloomreach (nas configurações de consentimento em **Project settings**). Use **Filtrar por permissões** para que apenas quem marcou sua caixa de marketing receba o consentimento.

## O que é enviado e quando

Novos cadastros são enviados em um ou dois minutos. Ao ativar a integração, os leads já existentes da campanha também são enviados. Quando alguém participa novamente, o cliente é atualizado. Confira cada envio em **Configurações** > **Integrações** > **Status de envio**. Veja [Verifique o status de envio e reenvie leads](https://scratcher.io/pt-br/help/integrations/delivery-status).

## Solução de problemas

- “All or some of the fields are invalid...” ao instalar: verifique a API base URL e o project token e copie novamente o key ID e o secret.
- Os envios falham com um erro de acesso: falta alguma das permissões acima no grupo de API. Edite-o no Bloomreach.
- O consentimento não aparece no cliente: a categoria de consentimento não existe no Bloomreach ou está escrita de outra forma.
- O Bloomreach tem seus próprios guias sobre chaves de API. Pesquise “API access management” na documentação do Bloomreach se os menus estiverem diferentes.

Integrações

- [Como funcionam as integrações](https://scratcher.io/pt-br/help/integrations/how-integrations-work)
- [Todas as integrações](https://scratcher.io/pt-br/help/integrations/other-integrations)
- [Verifique o status de envio e reenvie leads](https://scratcher.io/pt-br/help/integrations/delivery-status)
- [Conecte o HubSpot](https://scratcher.io/pt-br/help/integrations/hubspot)
- [Conecte o Salesforce Marketing Cloud](https://scratcher.io/pt-br/help/integrations/salesforce-marketing-cloud)
- [Conecte o Microsoft Dynamics 365 com o Zapier](https://scratcher.io/pt-br/help/integrations/microsoft-dynamics-365)
- [Conecte o Emarsys](https://scratcher.io/pt-br/help/integrations/emarsys)
- [Conectar Klaviyo](https://scratcher.io/pt-br/help/integrations/klaviyo)
- [Conecte o Mailchimp](https://scratcher.io/pt-br/help/integrations/mailchimp)
- [Conecte o ActiveCampaign](https://scratcher.io/pt-br/help/integrations/activecampaign)
- [Conecte o Apsis One](https://scratcher.io/pt-br/help/integrations/apsis-one)
- [Conecte o Drip](https://scratcher.io/pt-br/help/integrations/drip)
- [Conecte o HeyLoyalty](https://scratcher.io/pt-br/help/integrations/heyloyalty)
- [Conectar Peytz](https://scratcher.io/pt-br/help/integrations/peytz)
- [Conecte o Marketingplatform](https://scratcher.io/pt-br/help/integrations/marketingplatform)
- [Conecte o Campaign Monitor com o Zapier](https://scratcher.io/pt-br/help/integrations/campaign-monitor)
- [Conecte o ActiveTrail com o Zapier](https://scratcher.io/pt-br/help/integrations/activetrail)
- [Conecte o Bloomreach](https://scratcher.io/pt-br/help/integrations/bloomreach)
- [Conecte o Iterable](https://scratcher.io/pt-br/help/integrations/iterable)
- [Conecte o Mapp](https://scratcher.io/pt-br/help/integrations/mapp)
- [Conectar o Agillic](https://scratcher.io/pt-br/help/integrations/agillic)
- [Conectar Ortto](https://scratcher.io/pt-br/help/integrations/ortto)
- [Conecte o Emarketeer](https://scratcher.io/pt-br/help/integrations/emarketeer)
- [Conectar Shopify](https://scratcher.io/pt-br/help/integrations/shopify)
- [Conecte o Hello Retail](https://scratcher.io/pt-br/help/integrations/hello-retail)
- [Conecte mais de 8.000 apps com o Zapier](https://scratcher.io/pt-br/help/integrations/zapier)
- [Conecte o monday.com ao Zapier](https://scratcher.io/pt-br/help/integrations/monday-com)
- [Conecte o Asana com o Zapier](https://scratcher.io/pt-br/help/integrations/asana)
- [Conecte o Podio com o Zapier](https://scratcher.io/pt-br/help/integrations/podio)
- [Conecte o Intercom com o Zapier](https://scratcher.io/pt-br/help/integrations/intercom)

Continue aprendendo

## Artigos relacionados

- [Como funcionam as integrações](https://scratcher.io/pt-br/help/integrations/how-integrations-work): Conecte sua ferramenta de e-mail ou CRM uma única vez, ative-a em cada campanha, escolha uma lista, mapeie seus campos e envie apenas quem deu consentimento.
- [Verifique o status de envio e reenvie leads](https://scratcher.io/pt-br/help/integrations/delivery-status): Veja quais leads foram enviados para suas ferramentas, entenda as mensagens de erro, corrija o problema e envie-os novamente.
- [Peça consentimento e adicione termos e condições](https://scratcher.io/pt-br/help/forms/consent-and-permissions): Adicione caixas de seleção de consentimento para newsletters, vincule seus termos, escolha qual caixa inscreve as pessoas e envie à sua ferramenta de e-mail apenas quem disse sim.

Precisa de ajuda?

## Ainda precisa de ajuda?

Pessoas de verdade estão aqui para ajudar. Se você já usa o Scratcher, o jeito mais rápido é o chat dentro da plataforma.

- **[Converse com a gente](https://platform.scratcher.io/pt-BR/login)**

    Entre na sua conta e clique no botão de chat no canto inferior direito. O Rex responde na hora, e nossa equipe está a um clique.
- **[Agende uma reunião](https://scratcher.io/pt-br/book-a-meeting)**

    Uma videochamada gratuita de 30 minutos com nossa equipe: um tour, ideias de campanhas ou ajuda com a configuração.
- **[Mande um e-mail](mailto:contact@scratcher.io)**

    Escreva para contact@scratcher.io e retornaremos o contato.
