---
title: "Ligue o Bloomreach"
description: "Crie uma chave da API no Bloomreach Engagement, ligue-a e crie ou atualize clientes com os respetivos consentimentos."
url: https://scratcher.io/pt/help/integrations/bloomreach
language: pt
---

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

# Ligue o Bloomreach

Crie uma chave da API no Bloomreach Engagement, ligue-a e crie ou atualize clientes com os respetivos consentimentos.

Com a integração do Bloomreach, todas as pessoas que se registam são criadas ou atualizadas como cliente (customer) no seu projeto do Bloomreach Engagement, identificadas pelo endereço de e-mail. Também lhes pode dar um consentimento do Bloomreach, para lhes poder enviar marketing.

## O que precisa

- Um projeto do Bloomreach Engagement e um utilizador que possa gerir o acesso à API nas definições do projeto (normalmente um administrador do projeto).

## Passo 1: criar uma chave da API no Bloomreach

1. No Bloomreach Engagement, abra o projeto e vá a **Project settings** > **Access management** > **API**.
2. Copie o **Project token** e o **API base URL** que aparecem na página.
3. Nos grupos de API, crie um novo grupo com **Private access** e dê-lhe um nome, por exemplo "Scratcher".
4. Crie uma nova chave da API no grupo. Copie o **API key ID** e o **API secret**. O secret só é mostrado uma vez.
5. Dê ao grupo as permissões indicadas abaixo e guarde.

## Permissões de que a chave precisa

Nas permissões do grupo, permita:

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

Não é necessário mais nada. Sem as permissões set, as entregas falham com o erro de acesso do próprio Bloomreach.

## Passo 2: ligar o Bloomreach ao Scratcher

1. No Scratcher, vá a **Definições** > **Integrações** e clique em **Bloomreach**.
2. Cole o 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.

## Passo 3: ativar numa campanha

1. No editor, vá a **Ligar** > **Integrações** > **Bloomreach** e clique em **Ativar**.
2. Se tiver ligado mais do que um projeto, escolha-o em **Selecionar conta**.
3. Em **Mapeamentos de campos**, clique em **Adicionar mapeamento de campos** e associe cada **Campo do Scratcher** a uma propriedade de cliente do Bloomreach, por exemplo "Lead - Nome próprio" a **first\_name**.
4. Escolha a categoria de consentimento que as pessoas devem receber, por exemplo "newsletter", ou nenhuma.
5. Em **Filtrar por consentimentos (opcional)**, escolha a sua caixa de consentimento de marketing, para que só sejam enviadas as pessoas que a assinalaram.
6. Clique em **Guardar** e depois em **Testar**.

> É bom saber: o Bloomreach não tem listas. Todas as pessoas vão para o projeto, e é no Bloomreach que as agrupa com segmentos. Por isso, o Scratcher começa a enviar assim que clica em **Ativar**. Ative-o antes de a campanha ficar online, ou configure-o de imediato.

## Mapeamento de campos

- O endereço de e-mail é sempre enviado e é usado para encontrar o cliente. Não precisa de o associar.
- A lista **Campo de destino** mostra as propriedades de cliente do seu projeto. Se faltar uma propriedade, crie-a primeiro no Bloomreach.
- Para marcar de onde vieram os clientes, associe um **Usar valor personalizado** como "Jogo de verão Scratcher" a uma propriedade que use para a origem.

## Consentimento

Se escolher uma categoria de consentimento, o Scratcher regista um evento `consent` com a ação accept e o nome da campanha como origem. A categoria tem de existir no Bloomreach (nas definições de consentimento em **Project settings**). Use **Filtrar por consentimentos** para que só as pessoas que assinalaram a sua caixa de marketing recebam o consentimento.

## O que é enviado e quando

Os novos registos são enviados em um ou dois minutos. Quando ativa a integração, os leads existentes da campanha também são enviados. Quando alguém volta a participar, o cliente é atualizado. Verifique cada entrega em **Definições** > **Integrações** > **Estado da entrega**. Consulte [Verifique o estado da entrega e reenvie leads](https://scratcher.io/pt/help/integrations/delivery-status).

## Resolução de problemas

- "Alguns ou todos os campos são inválidos..." ao instalar: verifique o API base URL e o project token, e copie novamente o key ID e o secret.
- As entregas falham com um erro de acesso: falta ao grupo de API uma das permissões acima. 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 os seus próprios guias para as chaves da API. Pesquise "API access management" na documentação do Bloomreach se os menus tiverem outro aspeto.

Integrações

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

Continue a aprender

## Artigos relacionados

- [Como funcionam as integrações](https://scratcher.io/pt/help/integrations/how-integrations-work): Ligue a sua ferramenta de e-mail ou CRM uma vez, ative-a em cada campanha, escolha uma lista, associe os campos e envie apenas quem deu consentimento.
- [Verifique o estado da entrega e reenvie leads](https://scratcher.io/pt/help/integrations/delivery-status): Veja que leads foram enviados para as suas ferramentas, perceba as mensagens de erro, resolva o problema e envie-os novamente.
- [Peça consentimento e adicione termos e condições](https://scratcher.io/pt/help/forms/consent-and-permissions): Adicione caixas de consentimento para newsletters, ligue os seus termos, escolha que caixa subscreve as pessoas e envie para a sua ferramenta de e-mail apenas quem disse que sim.

Precisa de ajuda?

## Ainda precisa de ajuda?

Há pessoas reais prontas para ajudar. Se já usa o Scratcher, o mais rápido é o chat dentro da plataforma.

- **[Fale connosco no chat](https://platform.scratcher.io/pt/login)**

    Inicie sessão e clique no botão de chat no canto inferior direito. O Rex responde de imediato e a nossa equipa está à distância de um clique.
- **[Marque uma reunião](https://scratcher.io/pt/book-a-meeting)**

    Uma videochamada gratuita de 30 minutos com a nossa equipa: uma demonstração, ideias de campanhas ou ajuda com a sua configuração.
- **[Envie-nos um e-mail](mailto:contact@scratcher.io)**

    Escreva para contact@scratcher.io e entraremos em contacto consigo.
