Uma integração envia as pessoas que se cadastram nas suas campanhas para outra ferramenta, como seu sistema de newsletter ou CRM. Funciona em duas etapas: primeiro você conecta a ferramenta à sua conta Scratcher e, depois, ativa a integração em cada campanha em que quiser usá-la.
Cada ferramenta tem sua própria página com o passo a passo exato, incluindo onde encontrar a chave de API nessa ferramenta e quais permissões são necessárias. Veja Todas as integrações.
Etapa 1: Conecte a ferramenta à sua conta
- Acesse Settings > Integrations (em Developers). Pesquise a ferramenta ou use By type para exibir apenas Newsletter systems, E-commerce ou CRM tools.
- Clique na ferramenta. A janela tem as abas Installation e Features (o que a integração pode fazer).
- Preencha o que a ferramenta solicitar. Há dois tipos de ferramenta:
- Ferramentas em que você faz login, como Mailchimp, HubSpot e Drip. A janela exibe "You will be redirected securely to ... to authorize access. No API keys or manual credentials required."
- Ferramentas que exigem uma chave de API ou outras credenciais, como Klaviyo ou ActiveCampaign. Cole-as nos campos. O quadro Setup guide na janela indica onde encontrá-las, quando a ferramenta oferece esse guia.
- Clique em Install integration. O Scratcher verifica as credenciais na hora. Se não funcionarem, você verá "All or some of the fields are invalid. The integration failed to validate the fields."
Se der certo, você verá "The integration has been installed." Conectar a ferramenta ainda não envia nenhum lead.
Você também pode instalar uma ferramenta de dentro de uma campanha (Etapa 2). Nesse caso, ela já fica ativada para essa campanha ao mesmo tempo.
Etapa 2: Ative em uma campanha
- Abra a campanha no editor e acesse Connect > Integrations. Digite na caixa de busca (Type to search…) para encontrar a ferramenta. As ferramentas ativas nesta campanha exibem o selo Active.
- Clique na ferramenta e depois em Activate. O painel exibe "Integration is active."
- Se você tiver conectado mais de uma conta da ferramenta, escolha-a em Select account. Clique em (+ add new) para conectar outra conta.
- Em External list, escolha a lista ou o público ao qual as pessoas devem ser adicionadas. Algumas ferramentas não têm listas; nesse caso, esse campo não aparece.
- Em Field mappings, clique em Add field mapping para cada dado que quiser enviar. Veja "Mapeie seus campos" abaixo.
- Em Filter by permissions (optional), escolha sua caixa de consentimento de marketing, para que sejam enviadas apenas as pessoas que a marcaram. Veja "Envie apenas quem disse sim" abaixo.
- Preencha as configurações extras que a ferramenta tiver, como Tags.
- Clique em Save. Você verá "The integration has been updated."
- Clique em Test para enviar um lead de teste. Veja "Teste a integração" abaixo.
Mapeie seus campos
O mapeamento de campos define quais dados do Scratcher vão para qual campo na outra ferramenta. O cabeçalho mostra quantos campos estão mapeados, por exemplo, "3 mapped".
- Clique em Add field mapping. Uma nova linha aparece, com um Scratcher field à esquerda e um Destination field à direita.
- Em Choose a field, escolha o dado do Scratcher a ser enviado. Os campos são agrupados:
- Lead: os campos do seu formulário (por exemplo, "Lead - First name"), ID, Phone number, Created at e Participated at. Para cada caixa de consentimento, você também tem Accepted, Content (o texto com o qual a pessoa concordou), Date e IP address.
- Campaign: ID e Name.
- Participant: Channel (de onde a pessoa veio).
- Quiz: as respostas às perguntas nomeadas do quiz, se a campanha tiver um quiz.
- Prize: ID, Name, Value, Coupon code e Won at, para os ganhadores.
- Para enviar o mesmo texto fixo para todos, escolha Use custom value e digite o texto, por exemplo, o nome da campanha ou "Scratcher". Clique em Use Scratcher field para voltar a usar um campo.
- Em Destination field, escolha o campo na outra ferramenta. A lista vem da sua própria conta nessa ferramenta, então seus campos personalizados também aparecem. Em algumas ferramentas, você digita o nome (External field name).
- Clique na engrenagem (Show settings) para ver mais opções:
- Skip field if empty: "This ensures that the field is not sent to the integration if the data you are trying to send is empty." Use essa opção para que respostas vazias não sobrescrevam dados que a ferramenta já tem.
- Format (apenas para números de telefone): Include + and country code (e.g. +4512345678), Include country code (e.g. 4512345678) ou Exclude country code (e.g. 12345678). Escolha o formato que a outra ferramenta espera.
- Clique na lixeira (Delete mapping) para remover uma linha.
Bom saber: o endereço de e-mail é sempre enviado, e a maioria das ferramentas também recebe o número de telefone automaticamente. A página de cada ferramenta informa quais campos são preenchidos para você.
Envie apenas quem disse sim
Filter by permissions (optional) lista as caixas de consentimento da sua campanha. "Select the permissions that should be used to filter the leads. If the lead has not accepted all of the selected permissions, it will not be sent to the integration."
- Deixe em branco ("Leave empty to send all leads") para enviar todo mundo.
- Escolha sua caixa de consentimento de marketing para enviar apenas quem a marcou. Se você escolher várias, as pessoas precisam ter marcado todas elas.
As pessoas filtradas não são enviadas e não aparecem em Delivery status. Muitas ferramentas adicionam as pessoas enviadas como assinantes, por isso use sempre o filtro se a sua caixa de marketing for opcional. Veja Consentimento e permissões.
Teste a integração
- Salve a integração antes, para que todos os campos fiquem disponíveis no teste.
- Clique em Test. O painel Test your integration é aberto.
- Escolha a lista em Select list (para ferramentas com listas), digite um Email e preencha um valor para cada campo mapeado.
- Clique em Send test. Você verá "The data has been sent over successfully" ou a mensagem de erro da outra ferramenta.
- Confira se a pessoa de teste chegou à outra ferramenta e, depois, exclua-a por lá.
O teste é enviado para a outra ferramenta mesmo que você use Filter by permissions. Se aparecer "You must enter a value into all the fields", preencha todos os campos.
Quando os leads são enviados?
- O Scratcher verifica novos cadastros a cada minuto e os envia em segundo plano, então os novos leads chegam em um ou dois minutos.
- Quando você ativa uma integração em uma campanha que já tem leads, esses leads também são enviados.
- Quando alguém participa novamente, seus dados são enviados de novo, para que a ferramenta seja atualizada com as respostas mais recentes.
- Em ferramentas com lista, nada é enviado até que você escolha uma lista. Ferramentas sem lista começam a enviar assim que você clica em Activate.
Bom saber: configure os mapeamentos de campos e o filtro de consentimento antes de a campanha entrar no ar. Leads já enviados não são reenviados quando você altera os mapeamentos depois. Você pode reenviá-los em Delivery status.
Verifique se está funcionando
Settings > Integrations > Delivery status mostra cada lead enviado às suas ferramentas, se era um contato novo ou existente e o erro, caso o envio tenha falhado. Veja Verifique o status de entrega e reenvie leads.
Gerencie as contas conectadas
Clique em uma ferramenta instalada em Settings > Integrations. A aba Overview lembra você de ativá-la nas suas campanhas. A aba Accounts ("Your connected accounts") lista as contas que você conectou:
- Use o menu Actions (...) e Rename para dar à conta um nome fácil de reconhecer, por exemplo, "Newsletter DK". Digite-o em Name na janela Rename account e clique em Save.
- Delete desconecta a conta: "This will disable any running integrations that use this account".
- Add new account conecta mais uma conta da mesma ferramenta, por exemplo, uma segunda conta do Mailchimp.
Desative a integração
- Na campanha, abra a integração e clique em Deactivate. Nada mais será enviado a partir dessa campanha.
- Para remover a ferramenta da sua conta e de todas as campanhas, abra-a em Settings > Integrations e clique em Uninstall. "Are you sure you want to uninstall this integration? This will also remove the integration from all campaigns."
Quem pode usar integrações?
- As integrações fazem parte dos planos pagos. HubSpot e Salesforce Marketing Cloud exigem um plano que inclua todas as integrações nativas. Se uma ferramenta estiver bloqueada, veja Seu teste, os planos e o que acontece quando o teste termina.
- Usuários com a função Owner, Admin ou Manager podem instalar e configurar integrações. Usuários Analyst não podem.