Com a integração do Agillic, todas as pessoas que se registam são criadas ou atualizadas como destinatário (recipient) no Agillic. O Agillic não usa listas aqui: os destinatários são adicionados aos seus dados no Agillic, e é no Agillic que cria os seus grupos-alvo.
O que precisa
- Uma conta do Agillic na plataforma europeia do Agillic e um utilizador que possa criar chaves da API (normalmente um administrador).
Passo 1: criar uma chave da API no Agillic
- No Agillic, abra Settings e encontre as chaves da API (API credentials).
- Crie uma nova chave e dê-lhe um nome que reconheça, por exemplo "Scratcher".
- Copie a Developer key (também chamada API key) e o Secret. O secret só é mostrado uma vez.
Permissões de que a chave precisa
O Scratcher usa a chave para ler os seus campos de dados pessoais (person data), encontrar destinatários pelo e-mail e criar e atualizar destinatários. Se o Agillic permitir limitar a chave, esta precisa de acesso de leitura e escrita aos destinatários e de acesso de leitura aos dados pessoais. Não é necessário nenhum outro acesso.
Passo 2: ligar o Agillic ao Scratcher
- No Scratcher, vá a Definições > Integrações e clique em Agillic.
- Cole a Developer key e o Secret.
- Clique em Instalar integração. O Scratcher inicia sessão no Agillic para os verificar.
Passo 3: ativar numa campanha
- No editor, vá a Ligar > Integrações > Agillic e clique em Ativar.
- Se tiver ligado mais do que uma conta, escolha-a em Selecionar conta.
- Em Mapeamentos de campos, associe cada Campo do Scratcher a um campo de dados pessoais do Agillic.
- Em Campo de e-mail único, escolha o campo do Agillic que usa para o e-mail: "Escolha o campo no Agillic que utiliza para o e-mail (certifique-se de que também é único no Agillic)". Só aparecem os campos de texto únicos. Se o deixar vazio, o Scratcher usa o campo EMAIL.
- Em Filtrar por consentimentos (opcional), escolha a sua caixa de consentimento de marketing, para que só sejam enviadas as pessoas que disseram que sim.
- Clique em Guardar e depois em Testar.
É bom saber: o Agillic não tem lista para escolher, 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 para o campo de e-mail único. Não precisa de o associar.
- A lista de campos mostra os seus dados pessoais do Agillic, com os respetivos tipos. As datas são enviadas no formato do Agillic, por exemplo 31.12.2025.
- Se tiver um campo de dados pessoais para o opt-in, associe-lhe o campo Aceite de um consentimento.
O que é enviado e quando
O Scratcher procura o destinatário pelo e-mail. Se não existir, é criado; caso contrário, é atualizado. Os novos registos são enviados em um ou dois minutos, e os leads existentes são enviados quando ativa a integração. Em Definições > Integrações > Estado da entrega pode ver se cada lead era novo ou já existia no Agillic.
Resolução de problemas
- "Agillic API request failed with status code ...": o Agillic não aceitou o pedido. 401 ou 403 significa que a chave foi eliminada ou não tem acesso; ligue uma nova chave.
- Uma mensagem do Agillic sobre um campo: um valor não corresponde ao tipo do campo, ou falta um campo obrigatório. Verifique os mapeamentos.