---
title: "Ligue o Iterable"
description: "Crie uma chave da API do lado do servidor no Iterable, ligue-a e adicione os novos registos como utilizadores a uma lista do Iterable."
url: https://scratcher.io/pt/help/integrations/iterable
language: pt
---

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

# Ligue o Iterable

Crie uma chave da API do lado do servidor no Iterable, ligue-a e adicione os novos registos como utilizadores a uma lista do Iterable.

Com a integração do Iterable, todas as pessoas que se registam são criadas ou atualizadas como utilizador (user) no Iterable, identificadas pelo endereço de e-mail, e subscritas na lista do Iterable que escolher.

## O que precisa

- Um projeto do Iterable que use o e-mail como identificador de utilizador e um utilizador com permissão para gerir chaves da API (normalmente um org admin ou project admin).
- Saber se o seu projeto do Iterable está no centro de dados dos EUA ou da UE.

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

1. No Iterable, vá a **Integrations** > **API Keys**.
2. Clique em **New API Key**.
3. Dê-lhe um nome, por exemplo "Scratcher", e escolha o tipo **Standard** (server-side).
4. Clique para criar a chave e copie-a. O Iterable só mostra a chave completa uma vez.

## Para que serve a chave

Uma chave standard (do lado do servidor) consegue fazer o que o Scratcher precisa:

- ler as suas listas e campos de utilizador, para que os possa escolher na campanha;
- criar e atualizar utilizadores;
- subscrever utilizadores em listas.

Não use uma chave JavaScript, mobile ou só de leitura: não conseguem adicionar utilizadores a partir de um servidor.

## Passo 2: ligar o Iterable ao Scratcher

1. No Scratcher, vá a **Definições** > **Integrações** e clique em **Iterable**.
2. Escolha o centro de dados (EUA ou UE) e cole a chave da API.
3. Clique em **Instalar integração**. O Scratcher verifica se consegue ler as suas listas.

## Passo 3: ativar numa campanha

1. No editor, vá a **Ligar** > **Integrações** > **Iterable** e clique em **Ativar**.
2. Se tiver ligado mais do que um projeto, escolha-o em **Selecionar conta**.
3. Em **Lista externa**, escolha a lista do Iterable. Só podem ser escolhidas listas estáticas.
4. Em **Mapeamentos de campos**, clique em **Adicionar mapeamento de campos** e associe cada **Campo do Scratcher** a um campo de utilizador do Iterable, por exemplo "Lead - Nome próprio" a **firstName**.
5. Em **Filtrar por consentimentos (opcional)**, escolha a sua caixa de consentimento de marketing.
6. Clique em **Guardar** e depois em **Testar**.

## Mapeamento de campos

- O endereço de e-mail é sempre enviado e identifica o utilizador. Não precisa de o associar.
- A lista **Campo de destino** mostra os campos de utilizador do seu projeto. Se um campo ainda não existir, crie-o primeiro no Iterable, para que fique com o tipo certo.
- Nos números de telefone, use **Formato** com + e indicativo do país, que é o que o Iterable espera para SMS.

## Consentimento

Estar numa lista não subscreve, por si só, as pessoas nos seus tipos de mensagem: o Iterable usa as suas próprias definições de subscrição para isso. Envie só as pessoas que disseram que sim, escolhendo a sua caixa de marketing em **Filtrar por consentimentos (opcional)**. Também pode associar os campos **Aceite** e **Data** de um consentimento a campos de utilizador, para ter prova do consentimento no Iterable.

## O que é enviado e quando

Os novos registos são enviados em um ou dois minutos, e os leads existentes da campanha são enviados quando ativa a integração. Quando alguém volta a participar, o utilizador é atualizado. Use a lista como início de uma jornada no Iterable para enviar uma mensagem de boas-vindas. Todas as entregas aparecem em **Definições** > **Integrações** > **Estado da entrega**.

## Resolução de problemas

- "Alguns ou todos os campos são inválidos..." ao instalar: a chave está errada ou não é uma chave standard, ou escolheu o centro de dados errado.
- Um campo é rejeitado: o valor não corresponde ao tipo do campo de utilizador no Iterable, por exemplo texto num campo de data. Verifique o mapeamento.
- A lista não aparece: as listas dinâmicas não podem receber utilizadores. Crie uma lista estática no Iterable.

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.
