Visão geral
Se você usa o Apollo para dados, mas usa o Marketo para engajamento, pode enriquecer seus contatos existentes no Marketo com informações atualizadas do Apollo.
Os benefícios do enriquecimento instantâneo incluem:
- Precisão: Garanta que os dados coletados nos formulários de captura de lead no Marketo estejam corretos e atualizados.
- Workflow simplificado: Remova etapas desnecessárias ao trabalhar entre o Apollo e o Marketo.
- Especificidade: Garanta que os leads mais alinhados ao seu perfil de cliente ideal incluam todos os pontos de dados de que você precisa para executar sua estratégia de engajamento com eficiência.
- Preenchimento instantâneo de dados: Os dados enriquecidos do Apollo para o Marketo são enviados instantaneamente.
O Apollo enriquece seus registros com um limite de 100 registros por minuto e 300 registros por hora. Cada enriquecimento bem-sucedido custa 0.01 créditos.
Confira as seções a seguir para conectar a integração e configurar o mapeamento de campos de enriquecimento para enriquecer seus contatos existentes do Marketo com o Apollo.
Conectar a integração
Para conectar a integração, primeiro gere uma chave de API do Apollo, depois crie um webhook no Marketo.
Se você já tem sua chave de API do Apollo, pode pular esta etapa.
Gerar uma chave de API
Para gerar uma chave de API no Apollo:
- Abra o Apollo e clique em Configurações > Integrações.
- Clique em Conectar ao lado de API.
- Clique em Solicitar chave de API.
- O Apollo gera uma chave de API. Copie sua chave de API (
CTRL + Cno PC ouCMD + Cno Mac). Considere colar a chave de API em um local seguro para usá-la em uma etapa posterior.
Mantenha sua chave de API em um local seguro. Qualquer pessoa com acesso à chave pode realizar ações na sua conta do Apollo.
Em seguida, crie um webhook no Marketo.
Criar um webhook no Marketo
Para criar um webhook no Marketo:
- Faça login no Marketo e clique em Admin > Webhooks.
- Clique em Novo webhook.
- Dê um nome ao seu webhook.
- Copie e cole o link a seguir no campo URL, substituindo
YOUR_API_KEYpela sua chave de API real do Apollo:
https://api.apollo.io/v1/people/match?api_key=YOUR_API_KEY&first_name={{lead.First Name:default=}}&last_name={{lead.Last ame:default=}}&email={{lead.Email Address:default=}}&website_url={{company.Website:default=}}&organization_name={{company.Company Name:default=}}
Lembre-se de substituir YOUR_API_KEY na URL pela sua chave de API real do Apollo.
- Para o tipo de solicitação, selecione POST.
- Para o tipo de resposta, selecione JSON.
- Quando terminar, clique em Salvar.
Em seguida, configure o mapeamento de campos de enriquecimento.
Confira Criar um webhook no Suporte do Marketo para saber mais sobre a configuração do webhook.
Configurar o mapeamento de campos de enriquecimento
O mapeamento de campos de enriquecimento ajuda a garantir que seus contatos sejam mapeados corretamente entre as duas plataformas.
Para configurar o mapeamento de campos de enriquecimento:
- No Marketo, clique em Editar o mapeamento de resposta do seu webhook.
- Clique em Adicionar.
- Selecione o atributo do Apollo que você deseja usar.
Se você tiver qualquer problema com os atributos, verifique novamente se não há espaços extras antes ou depois de cada atributo de resposta. Confirme isso antes de clicar em Salvar no Marketo.
Você pode escolher entre os seguintes atributos do Apollo:
| Tipo de atributo | Atributo de resposta do Apollo | Descrição | Formato do valor |
|---|---|---|---|
| Nome do contato | person.first_name |
Refere-se ao primeiro nome do contato (se existir) | String |
| Sobrenome do contato | person.last_name |
Refere-se ao sobrenome do contato (se existir) | String |
| Nome completo do contato | person.name |
Refere-se ao nome completo do contato (se existir) | String |
| Perfil do LinkedIn | person.linkedin_url |
Refere-se ao perfil do LinkedIn do contato | String |
| Perfil do Facebook | person.facebook_url |
Refere-se ao perfil do Facebook do contato | String |
| Perfil do Twitter | person.twitter_url |
Refere-se ao perfil do Twitter do contato | Texto |
| Cargo | person.title |
Refere-se ao cargo do contato | Texto |
| Cidade | person.city |
Refere-se à cidade atual onde o contato reside | Texto |
| Estado | person.state |
Refere-se ao estado atual onde o contato reside | Texto |
| País | person.country |
Refere-se ao país atual onde o contato reside | Texto |
| Nome da empresa | person.organization.name |
Refere-se ao nome da empresa em que o contato trabalha atualmente | Texto |
| Site da empresa | person.organization.website_url |
Refere-se ao site da empresa (e.g. http://www.google.com) | Texto |
| URL do AngelList | person.organization.angellist_url |
Refere-se à URL do AngelList da empresa | Texto |
| Perfil da empresa no LinkedIn | person.organization.linkedin_url |
Refere-se ao perfil da empresa no LinkedIn | Texto |
| Perfil da empresa no Twitter | person.organization.twitter_url |
Refere-se ao perfil da empresa no Twitter | Texto |
| Perfil da empresa no Facebook | person.organization.facebook_url |
Refere-se ao perfil da empresa no Facebook | Texto |
| Domínio da empresa | person.organization.domain |
Refere-se ao domínio da empresa (e.g. google.com) | Texto |
| Número de funcionários da empresa | person.organization.estimated_num_employees |
Refere-se a uma estimativa do tamanho da empresa (e.g. 13) | Inteiro |
| Número de telefone da empresa | person.organization.phone |
Refere-se ao telefone principal da empresa | Texto |
| Ranking Alexa | person.organization.alexa_ranking |
Refere-se ao ranking Alexa do site principal da empresa | Inteiro |
| Idiomas da empresa | person.organization.languages |
Refere-se a uma lista dos idiomas compatíveis no site da empresa | Array de String |
| Logo da empresa | person.organization.logo_url |
Refere-se ao logo da empresa | String |
| Setor | person.organization.industry |
Refere-se ao setor em que a empresa atua | String |
| Endereço da sede | person.organization.raw_address |
Refere-se ao endereço bruto da sede global da empresa | String |
| Cidade da sede | person.organization.city |
Refere-se à cidade onde a sede global da empresa está localizada | String |
| Estado da sede | person.organization.state |
Refere-se ao estado onde a sede global da empresa está localizada | String |
| País da sede | person.organization.country |
Refere-se ao país onde a sede global da empresa está localizada | String |
| Símbolo de negociação em bolsa | person.organization.publicly_traded_symbol |
Refere-se ao símbolo de negociação da empresa, caso ela seja listada em bolsa (ex.: AAPL para Apple) | String |
| Bolsa de valores de negociação | person.organization.publicly_traded_exchange |
Refere-se ao nome da bolsa de valores em que a empresa está listada (ex.: NYSE) | String |
| Descrição SEO da empresa | person.organization.seo_description |
Refere-se à breve descrição que a empresa usa para se descrever para fins de SEO | String |
| Financiamento total | person.organization.total_funding |
Refere-se ao financiamento total captado pela empresa em USD (ex.: 120000000) | Inteiro |
| Data da rodada de financiamento mais recente | person.organization.latest_funding_round_date |
Refere-se à data do financiamento mais recente recebido pela empresa, se houver (ex.: 2016-05-01T00:00:00.000+00:00) | String |
| Etapa do financiamento mais recente | person.organization.latest_funding_stage |
Refere-se à etapa do financiamento mais recente da empresa, se houver (por exemplo, Série A) | String |
| Número de localizações de varejo | person.organization.retail_location_count |
Refere-se ao número total de localizações de varejo que a empresa tem | Integer |
| Receita anual | person.organization.annual_revenue |
Refere-se a uma estimativa da receita atual da empresa em USD (por exemplo, 120000000) | Integer |
| Tecnologia | person.organization.technology_names |
Refere-se a uma lista das tecnologias que a empresa usa atualmente | Array de String |
Você não precisa conhecer os formatos de valor para configurar o mapeamento de campos de enriquecimento no Marketo. No entanto, se você usar a API da Apollo regularmente, talvez queira saber o que significa cada formato de valor:
-
String: Exibe uma sequência de caracteres correspondente a um valor. Na API da Apollo, você precisa colocar strings entre aspas. Por exemplo:
“person.organization.country”: "Brazil" -
Integer: Um único valor numérico. Na API da Apollo, você não deve usar aspas. Por exemplo:
“person.organization.annual_revenue”: 4000000 -
Array de String: Uma sequência de caracteres correspondente a vários valores. Na API da Apollo, você precisa colocar todos os arrays de strings entre colchetes. Por exemplo:
“person.organization.technology_names” : ["Cloudflare DNS", "Mailchimp Mandrill"]
- Selecione o campo correspondente ao campo do Marketo no Marketo.
- Você pode adicionar quantos campos forem necessários. Repita o processo para campos adicionais.
- Quando terminar, clique em Salvar.
Agora você está pronto para acionar o webhook no Marketo.
Para saber mais sobre como usar seu webhook para enriquecer leads com os gatilhos do Marketo, confira Usar um webhook em uma Smart Campaign na Base de conhecimento do Marketo.


