CRM com API e webhook: o que integrar e o que conferir

O lead preenche o formulário do site, e o pedido cai num e-mail. Alguém copia o nome e o telefone para o CRM — quando lembra. O negócio é ganho, e outra pessoa digita tudo de novo no sistema de notas. Cada cópia é um atraso, e cada atraso é um cliente esperando.

Um CRM com API e webhook acaba com essa digitação. Este texto explica as duas coisas em língua de gente, mostra o que dá para automatizar e lista o que conferir antes de assinar. Uma declaração: quem escreve vende a Vetora, e a mesma lista é aplicada a ela no fim, com o guia de integração aberto para você conferir.

O que é a API de um CRM?

API é a porta pela qual um sistema conversa com outro, sem ninguém clicar em tela. Pense num balcão: o outro sistema chega, mostra uma chave e faz um pedido — "crie este contato", "me dê os negócios de outubro". O CRM confere a chave e responde.

A chave é uma senha feita para máquina. Ela vai em cada pedido, e quem a tem age em nome da sua empresa. Por isso ela mora no servidor do site ou na ferramenta de automação — nunca na página que o visitante abre.

E o webhook, o que é?

O webhook é o mesmo balcão, virado ao contrário. Em vez de o outro sistema perguntar a toda hora se algo mudou, o CRM avisa quando muda: "um negócio foi ganho", "uma proposta foi aceita". O aviso vai para um endereço que você cadastra.

Quase toda integração boa usa os dois: o webhook avisa que algo aconteceu, e a API busca ou grava o resto.

O que dá para automatizar com API e webhook?

• Lead do site direto no funil. O formulário que o site já tem manda os dados para a API, com a origem da campanha junto, e o negócio nasce na etapa certa, com dono.
• Venda ganha vira pedido. O aviso de negócio ganho chega ao sistema de gestão, que gera o pedido ou a nota.
• Contato novo na lista de e-mail. O aviso de contato criado alimenta a ferramenta de e-mail marketing.
• Planilha ou painel sempre em dia. Um sistema lê os negócios pela API de hora em hora e atualiza a planilha da diretoria.
• Gasto de anúncio dentro do CRM. Quem tem o investimento numa planilha manda para o CRM, e o custo por lead e o retorno de cada campanha saem na mesma conta.
• Aviso para quem precisa agir. A proposta aceita dispara uma mensagem para o financeiro emitir a cobrança.

O gasto de anúncio é o que mais pesa para quem investe em tráfego: sem o custo e a venda no mesmo lugar, ninguém sabe quanto cada campanha vendeu. A conta está em como calcular ROAS, CAC e CPL, e o caso da agência, em CRM para agência de tráfego.

Como integrar um CRM com n8n, Make ou Zapier?

n8n, Make e Zapier ligam um sistema a outro sem programar — ou programando pouco. Eles não precisam de uma "integração nativa" com o CRM. Precisam de duas coisas: um webhook para receber o aviso e uma API para mandar o pedido.

O caminho é o mesmo nas três. O gatilho é o webhook genérico — o nó Webhook no n8n, o Custom webhook no Make, o Catch Hook no Zapier —, que gera um endereço; esse endereço vai no cadastro de webhooks do CRM. Para mandar dados ao CRM, usa-se o passo de requisição HTTP, com a chave no cabeçalho. Um fluxo de exemplo, "negócio ganho vira pedido", no n8n:

1. 1Crie um fluxo com o nó Webhook e copie o endereço que ele gerar.
2. 2No CRM, cadastre esse endereço e marque o aviso de negócio ganho.
3. 3No fluxo, confira a assinatura do aviso antes de seguir (o que é isso, logo abaixo).
4. 4O aviso traz o título, o valor e o contato do negócio. Com eles, o fluxo monta o pedido e o manda ao sistema de gestão, pelo nó de requisição HTTP ou pelo nó pronto dele, se houver.

A ferramenta é uma conta à parte. Em 03/11/2026, o n8n podia rodar num servidor seu, pela versão publicada no GitHub, ou na nuvem dele, a partir de 20 euros por mês no anual, com 2,5 mil execuções. O Make tinha um plano sem custo, com mil créditos por mês. No Zapier, confira se o seu plano inclui o app de webhook antes de montar o fluxo.

O que conferir num CRM com API antes de assinar

Todo CRM diz que "tem API". Oito perguntas separam a que serve da que atrapalha:

1. 1A documentação é aberta? Você, ou o seu técnico, deve conseguir lê-la antes de pagar, com um exemplo de cada pedido.
2. 2A API vem em todo plano? Em alguns sistemas, ela fica no plano de cima. Na página de preços da Odoo, por exemplo, a "API Externa" aparecia só no plano Personalizado, e não no Padrão (03/11/2026).
3. 3Dá para criar uma chave por integração? Com uma chave só para tudo, um vazamento obriga a trocar a chave e derruba todas as integrações de uma vez. E uma chave presa ao login de uma pessoa cai quando ela sai da empresa.
4. 4A chave pode só ler? A planilha da diretoria não precisa criar contato. Chave que só lê limita o estrago se vazar.
5. 5O webhook é assinado? Sem assinatura, quem descobre o endereço inventa um "negócio ganho", e o seu sistema emite a nota. A assinatura — o nome técnico é HMAC — é um selo que só o CRM e você sabem calcular, a partir de um segredo que só os dois conhecem.
6. 6Se o aviso falhar, ele é reenviado? E fica um histórico do que foi entregue e do que falhou, para alguém conferir?
7. 7Os limites estão escritos? Quantos registros por página, quantos pedidos por minuto. O Twenty, por exemplo, escreve na página de preços: 50 chamadas por minuto no Pro, 100 no Organization (03/11/2026).
8. 8Dá para ler tudo sem perder nenhum? Sincronizar exige ler em páginas, a partir de um ponto, sem pular o que entrou no mesmo segundo.

A API não está entre as sete perguntas de como escolher um CRM. Para quem vai ligar o CRM a outros sistemas, ela é a oitava.

A chave nunca vai na página do site

Esta vale para você, não para o CRM. Tudo o que está no código de uma página, qualquer visitante lê — e, com a chave, cria contato em laço e lê a sua base inteira. Para o visitante enviar direto do navegador, o caminho é um formulário de captura ou um widget, públicos de propósito e com proteção contra robô. A chave fica no servidor do site ou no n8n. E quem responde pelos dados diante da LGPD é a sua empresa — o que a lei pede está em LGPD e CRM no WhatsApp.

Como a Vetora responde a cada pergunta

A mesma lista, aplicada a quem escreve. Tudo está no guia de integração, aberto a quem ainda não comprou, com os exemplos prontos para copiar.

São três endereços, cada um para ler e para gravar: negócios, contatos e investimento em anúncio. Criar um negócio cria o contato junto, e o mesmo telefone nunca vira um segundo contato. Os avisos são sete — contato criado, negócio criado, negócio mudou de etapa, negócio ganho, negócio perdido, proposta aceita e proposta recusada —, e cada um chega com o nome no cabeçalho X-Crm-Evento, para filtrar sem abrir o aviso.

O que a Vetora não faz

• O aviso não é instantâneo. Ele sai na próxima batida do agendador, que roda a cada 10 minutos. Para quem precisa reagir no mesmo segundo, isso conta.
• Não há integração pronta com ERP, loja virtual ou portal. A ponte é a API e o webhook, montada por um técnico ou por um n8n: é projeto, não configuração.
• Negócio trazido pela importação de planilha não avisa como negócio novo. Contato importado, sim.
• O formulário HTML do seu site não envia direto para o CRM: o envio passa pelo servidor do site, ou por um n8n, com a chave.

O que mais o sistema liga — o WhatsApp, o ASAAS, o Meta Ads, o Google Ads e a assinatura eletrônica — está na seção de integrações da página inicial.