Como conectar qualquer CRM via n8n, Make ou webhook

Seu CRM não está na lista de integrações nativas? Você pode conectar qualquer CRM que tenha API usando uma ferramenta de automação, como n8n ou Make, ou um endpoint próprio. O LinkedScope chama um webhook seu, recebe a lista de negócios e cruza esses dados com o LinkedIn Ads.

• Tempo: 30 a 60 minutos
• Quem pode fazer: Alguém que saiba montar um fluxo no n8n, Make ou similar
• Método: Webhook HTTPS + token
• Acesso: O LinkedScope só lê o que o seu webhook devolve

Prefere que a IA monte o fluxo?
Conecte o Claude, o ChatGPT ou o Codex ao Make ou ao n8n e use o prompt pronto do guia Como conectar qualquer CRM com IA.

Como funciona

1. Você cria um webhook no n8n, no Make ou no seu backend.
2. O LinkedScope chama esse webhook com POST, sem corpo, enviando um token de autenticação no cabeçalho.
3. Seu fluxo valida o token, busca os negócios no CRM e devolve um JSON com a lista.
4. O LinkedScope importa os negócios e repete a chamada de segunda a sexta, às 03:00 UTC (ou quando você clica em Sincronizar CRM).

Antes de começar

• Acesso de dono ou administrador na conta do LinkedScope e um plano com integração de CRM.
• Acesso à API do seu CRM e a uma ferramenta que exponha um webhook HTTPS público (n8n, Make, Zapier com webhook, Pipedream ou seu próprio servidor).
• Nenhum outro CRM conectado ao LinkedScope. Cada conta usa um CRM por vez.

Atalho: templates prontos para n8n e Make

Para não montar o fluxo do zero, use o template da sua ferramenta. Ele já recebe a chamada do LinkedScope, valida o token, separa os negócios, mapeia os campos e responde no formato certo, inclusive quando o CRM não tem negócios. Você só troca o conector do CRM e confere o mapeamento. Com o template, os passos 1 e 2 abaixo já vêm resolvidos.

• Template para n8n (.json): workflow com nota de instruções em português
• Blueprint para Make (.json): cenário com as etapas nomeadas em português

No n8n

1. Importe o template
   Em um workflow novo, abra o menu ⋯ no canto superior direito e escolha Import from URL…. Cole o link do template para n8n e clique em Import. Se preferir, baixe o arquivo e use Import from file….
2. Confira o fluxo
   O workflow chega com cinco etapas e uma nota com este mesmo passo a passo: LinkedScope chama este webhook, Buscar negócios no CRM (substitua), Um item por negócio, Mapear campos para o LinkedScope e Responder ao LinkedScope.
3. Proteja o webhook
   Abra a etapa LinkedScope chama este webhook. Em Credential for Header Auth, escolha Create new credential, preencha Name com auth e Value com um segredo longo e aleatório e clique em Save. Guarde o segredo: ele vai no campo Token de autenticação do LinkedScope.
4. Conecte o seu CRM
   Troque a etapa Buscar negócios no CRM (substitua) pelo nó do seu CRM (por exemplo, Pipedrive, HubSpot ou Zoho CRM, com a operação de listar negócios e Return All ligado) ou ajuste a URL, a autenticação e a paginação da requisição HTTP. Traga todos os negócios dos últimos 24 meses, não só os recentes.
5. Indique onde está a lista
   Em Um item por negócio, informe o campo da resposta que contém a lista de negócios (o template vem com data). Se o nó do seu CRM já devolve um item por negócio, apague esta etapa.
6. Mapeie os campos
   Em Mapear campos para o LinkedScope, o nome de cada campo é o que o LinkedScope espera. Troque o que vem depois de $json. pelo campo equivalente do seu CRM. Os essenciais são dealName, companyName, dealStage e createdAt, e a tabela do Passo 2 explica todos.
7. Publique e copie a URL
   Clique em Publish (nas versões antigas do n8n, ative o workflow). Depois, abra a primeira etapa, selecione Production URL e copie o endereço. Use sempre a Production URL: a Test URL só responde enquanto o editor está escutando.

No Make

1. Importe o blueprint
   Crie um cenário novo, abra o menu ⋮ no canto superior direito e escolha Import blueprint. Selecione o arquivo baixado e clique em Import blueprint.
2. Confira o cenário
   O cenário chega com cinco etapas: LinkedScope chama este webhook, Buscar negócios no CRM (substitua), Juntar páginas do CRM, Converter para JSON e Responder ao LinkedScope (mapa de campos). Nenhuma delas roda uma vez por negócio: quem converte os campos é o LinkedScope.
3. Crie o webhook com API key
   Abra LinkedScope chama este webhook e clique em Add. Dê um nome ao webhook e, em API Key authentication, clique em Add API key e depois em Add. Preencha API key value com um valor longo e aleatório e clique em Create e em Save. Esse valor é o token que vai no LinkedScope.
4. Copie a URL do webhook
   Na mesma etapa, copie o endereço de Webhook URL e salve o módulo.
5. Conecte o seu CRM
   Troque o módulo Buscar negócios no CRM (substitua) pela requisição à API do seu CRM (URL, cabeçalhos e paginação) ou por um módulo de busca do seu CRM, como Search deals. Deixe ligada a opção Return error if HTTP request fails: se o CRM falhar, o LinkedScope precisa receber o erro, e não uma lista vazia. Se usar um módulo do CRM, abra Juntar páginas do CRM, escolha esse módulo em Source Module e marque Select All. O LinkedScope encontra a lista sozinho quando ela vem em data, results, items ou records.
6. Traga todos os negócios
   Se a API do seu CRM divide a lista em páginas, abra o módulo de busca e escolha em Pagination type o tipo que a documentação do CRM indica. O template já traz Output format em Array of pages e Limit em 10000; se trocar o módulo, confira esses dois campos, porque o padrão do Make é 100 e aí só os 100 primeiros negócios chegam ao LinkedScope. Módulos de busca dos CRMs também costumam vir com um limite baixo; aumente-o ou marque a opção de trazer todos. Filtrar pelos últimos 24 meses reduz o número de páginas. A paginação não encarece o cenário: o módulo gasta 1 crédito com qualquer número de páginas.
7. Ajuste o mapa de campos
   Abra Responder ao LinkedScope (mapa de campos). No Body, o fieldMap liga cada campo do LinkedScope (à esquerda) ao campo de um negócio no seu CRM (à direita). Troque só os textos da direita, sempre entre aspas: use ponto para campos dentro de outros (org.name) e [0] para o primeiro item de uma lista (owners[0].email). Apague as linhas que o seu CRM não tem, mantendo a vírgula no fim de todas menos da última, e não mexa na linha deals.
8. Salve e ligue o cenário
   Salve o cenário e ligue o agendamento Immediately as data arrives.

Custo no Make
O cenário gasta cerca de 5 créditos por chamada, com qualquer quantidade de negócios ou de páginas do CRM. O webhook é chamado na conexão, no teste, na sincronização automática de segunda a sexta e quando alguém clica em Sincronizar CRM.

Com o fluxo pronto, vá para o Passo 3: conecte no LinkedScope. No teste, confira se os negócios de amostra aparecem com nome, empresa e etapa.

Passo 1: monte o webhook

1. Crie um gatilho de webhook
   No n8n, use o nó Webhook. No Make, o módulo Custom webhook. Configure o método POST e copie a URL de produção (HTTPS).
2. Valide o token
   Defina um segredo longo e aleatório. No início do fluxo, compare o cabeçalho recebido com esse segredo. Se não bater, responda 401 ou 403 e encerre.
3. Busque os negócios no CRM
   Consulte a API do CRM e traga os negócios criados ou fechados nos últimos 24 meses, com a empresa e o responsável de cada um.
4. Mapeie para o formato do LinkedScope
   Transforme cada negócio nos campos da tabela abaixo.
5. Responda com JSON
   Devolva HTTP 200, Content-Type: application/json e a lista de negócios. Não deixe o fluxo responder antes de terminar a busca.

Qual cabeçalho o LinkedScope envia

• Se você colar só o segredo no campo Token de autenticação, o LinkedScope envia o cabeçalho auth: <segredo>. Se o webhook recusar (401/403), ele tenta de novo com x-make-apikey: <segredo>, o padrão de chave de API do Make.
• Para usar outro cabeçalho, cole no formato Nome-Do-Cabecalho: segredo, por exemplo Authorization: Bearer abc123. O nome aceita apenas letras, números e hífen.

Segurança do token
Nunca exponha o segredo no front-end nem em repositórios. Use um valor longo e aleatório e troque-o se houver suspeita de vazamento.

Passo 2: formato da resposta

O jeito mais simples é devolver um array JSON de negócios:

[
  {
    "dealId": "D-1001",
    "dealName": "Enterprise plan",
    "dealLink": "https://crm.example.com/deals/D-1001",
    "pipeline": "Sales",
    "dealStage": "Proposal sent",
    "dealValue": 15000,
    "createdAt": "2026-03-01T10:23:00Z",
    "closedAt": null,
    "isWon": null,
    "ownerName": "Ana Silva",
    "ownerEmail": "[email protected]",
    "companyName": "ACME",
    "companyDomain": "acme.com",
    "linkedinCompanyUrl": "https://www.linkedin.com/company/acme"
  }
]

Campos ausentes não quebram a importação: o LinkedScope usa valores padrão. Mas, sem empresa e datas, o negócio não consegue ser ligado ao LinkedIn Ads.

Também é aceito um objeto com deals e, opcionalmente, listas de usuários e empresas. Assim, os negócios podem trazer só os IDs de responsável e empresa, e o LinkedScope completa nome, e-mail e domínio:

{
  "deals": [ { "dealId": "D-1001", "dealName": "Enterprise plan", "ownerId": "u-7", "companyId": "c-42" } ],
  "users": [ { "id": "u-7", "name": "Ana Silva", "email": "[email protected]" } ],
  "companies": [ { "id": "c-42", "name": "ACME", "domain": "acme.com" } ]
}

Nomes aceitos para as listas: deals, data ou records para negócios; users, owners, members ou workspace_members para responsáveis; companies, organizations ou accounts para empresas.

Mapa de campos (fieldMap)

Em vez de converter cada negócio no seu fluxo, você pode devolver os negócios como o CRM entrega junto com um fieldMap, que diz em que campo de cada negócio está cada informação. O LinkedScope aplica o mapa sozinho. Os nomes à esquerda são os campos da tabela acima; os caminhos à direita aceitam ponto (org.name) e posição em lista (owners[0].email). A lista de negócios pode vir dentro de páginas (data, results, items ou records). Se o mapa tiver erro de formato ou um nome de campo desconhecido, o teste avisa que o mapa de campos é inválido.

{
  "fieldMap": {
    "dealId": "id",
    "dealName": "title",
    "companyName": "org.name",
    "companyDomain": "org.website",
    "dealStage": "stage.name",
    "status": "status",
    "dealValue": "value",
    "createdAt": "add_time",
    "closedAt": "close_time",
    "ownerEmail": "owners[0].email"
  },
  "deals": [
    { "data": [ { "id": 1001, "title": "Enterprise plan", "org": { "name": "ACME", "website": "acme.com" }, "stage": { "name": "Proposal sent" }, "status": "open", "value": 15000, "add_time": "2026-03-01T10:23:00Z" } ] }
  ]
}

Passo 3: conecte no LinkedScope

1. Abra as integrações
   Em Configurações > Integrações, encontre o card com o texto Conecte qualquer CRM com API usando sua conta n8n, Make ou similar.
2. Preencha os dois campos
   Em URL do webhook gatilho, cole a URL do webhook (precisa começar com https://). Em Token de autenticação, cole o segredo ou o cabeçalho completo.
3. Salve
   Clique em Salvar. O LinkedScope chama o webhook na hora para validar. Se a chamada falhar, a conexão não é salva e aparece uma mensagem de erro.
4. Teste a resposta
   Com a conexão salva, clique em Testar. A janela Teste de integração com CRM mostra quantos negócios foram recebidos e mapeados, o período coberto e uma amostra. Confira se nomes, valores e empresas estão corretos.

Depois de conectar

• A primeira sincronização começa em seguida. Depois, o LinkedScope chama o webhook de segunda a sexta, às 03:00 UTC.
• Para atualizar na hora, use Sincronizar CRM na aba Integrações.
• A conexão via webhook não tem seletor de pipelines. Para analisar só uma unidade de negócio, filtre os negócios no próprio fluxo antes de responder.
• O alerta de permissão limitada não se aplica à conexão via webhook: o LinkedScope recebe exatamente o que o seu fluxo devolve.

Erros comuns

Perguntas frequentes

O LinkedScope envia algum dado para o meu webhook?

Não. A chamada é um POST sem corpo. Só vai o cabeçalho de autenticação.

Com que frequência o webhook é chamado?

Na conexão, no teste, na sincronização automática (segunda a sexta, 03:00 UTC) e sempre que alguém clica em Sincronizar CRM. Respostas recentes ficam em cache por algumas horas.

Posso usar Zapier?

Sim, desde que o fluxo receba o webhook e devolva a resposta JSON na mesma chamada. Webhooks que só respondem “recebido” e processam depois não funcionam.

Meu CRM está entre os nativos. Devo usar a conexão via webhook?

Não. As integrações nativas têm seleção de pipelines, alerta de permissão e não exigem manutenção de fluxo. Use a conexão via webhook só para CRMs sem integração nativa.

Posso importar contatos ou enviar leads ao CRM pela conexão via webhook?

Não. A conexão via webhook é só de leitura, então a importação automática de contatos e o envio de Leads e Spark Prospects ao CRM ficam indisponíveis. Para mandar leads ao seu CRM, use um webhook da categoria Leads.

Precisa de ajuda?

Fale com a gente em [email protected], pelo menu Ajuda dentro do LinkedScope ou pela página de contato.