Com a integração do Agillic, todas as pessoas que se cadastram são criadas ou atualizadas como destinatários no Agillic. Aqui, o Agillic não usa listas: os destinatários são adicionados aos seus dados no Agillic, e você monta seus grupos-alvo no próprio Agillic.
O que você precisa
- Uma conta do Agillic na plataforma europeia do Agillic e um usuário que possa criar chaves de API (geralmente um administrador).
Passo 1: Crie uma chave de API no Agillic
- No Agillic, abra Settings e localize as chaves de API (API credentials).
- Crie uma nova chave e dê a ela um nome fácil de reconhecer, por exemplo, “Scratcher”.
- Copie a Developer key (também chamada de chave de API) e o Secret. O secret é exibido apenas uma vez.
Permissões necessárias para a chave
O Scratcher usa a chave para ler seus campos de dados pessoais, encontrar destinatários por e-mail e criar e atualizar destinatários. Se o Agillic permitir limitar a chave, ela precisa de acesso de leitura e gravação aos destinatários e de acesso de leitura aos dados pessoais. Nenhum outro acesso é necessário.
Passo 2: Conecte o Agillic ao Scratcher
- No Scratcher, acesse Configurações > Integrações e clique em Agillic.
- Cole a Developer key e o Secret.
- Clique em Instalar integração. O Scratcher faz login no Agillic para verificá-los.
Passo 3: Ative na campanha
- No editor, acesse Conectar > Integrações > Agillic e clique em Ativar.
- Se você conectou mais de uma conta, escolha a desejada em Selecionar conta.
- Em Mapeamento 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 você usa para e-mail: “Escolha o campo no Agillic que você usa para e-mail (certifique-se de que ele também seja único no Agillic)”. Apenas campos de texto únicos são listados. Se você deixar em branco, o Scratcher usa o campo EMAIL.
- Em Filtrar por permissões (opcional), escolha sua caixa de seleção de consentimento de marketing, para que sejam enviadas apenas as pessoas que aceitaram.
- Clique em Salvar e depois em Testar.
Bom saber: o Agillic não tem lista para escolher, então o Scratcher começa a enviar assim que você clica em Ativar. Ative antes de a campanha entrar no ar ou configure tudo de uma vez.
Mapeamento de campos
- O endereço de e-mail é sempre enviado para o campo de e-mail único. Não é preciso mapeá-lo.
- A lista de campos mostra seus dados pessoais do Agillic, com os respectivos tipos. As datas são enviadas no formato do Agillic, por exemplo, 31.12.2025.
- Se você tiver um campo de dados pessoais para opt-in, mapeie para ele o campo Aceito de um consentimento.
O que é enviado e quando
O Scratcher procura o destinatário pelo e-mail. Se ele não existir, é criado; caso contrário, é atualizado. Novos cadastros são enviados em um ou dois minutos, e os leads já existentes são enviados quando você ativa a integração. Em Configurações > Integrações > Status de entrega, você vê se cada lead era novo ou já existia no Agillic.
Solução de problemas
- “Agillic API request failed with status code ...”: o Agillic não aceitou a solicitação. 401 ou 403 significa que a chave foi excluída ou não tem acesso; conecte 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.