Pular para o conteúdo principal

Integrações de Dados e Produtividade

Registre cada lead em uma planilha, banco de dados ou no seu próprio endpoint de API. Configure em Configurações → Integrações.


Google Sheets

Adicione uma nova linha a um Google Sheet para cada lead que entrar no LeadHub.

Passo 1 — Criar um Projeto no Google Cloud

  1. Acesse console.cloud.google.com.
  2. Clique em Novo Projeto, nomeie-o LeadHub e crie-o.
  3. Pesquise pela Google Sheets API e Ative-a.
  4. Também ative a Google Drive API.

Passo 2 — Criar Credenciais OAuth

  1. No Console Cloud, vá para APIs e Serviços → Credenciais.
  2. Clique em Criar Credenciais → ID do cliente OAuth.
  3. Defina o Tipo de Aplicativo como Aplicativo Web.
  4. Em URIs de redirecionamento autorizados, adicione: https://seudominio.com/oauth/google-sheets/callback
  5. Clique em Criar e copie o Client ID e o Client Secret.

Passo 3 — Preparar Seu Google Sheet

  1. Crie um novo Google Sheet (ou abra um existente).
  2. Adicione cabeçalhos de coluna na linha 1 — sugestão: ID | Primeiro Nome | Último Nome | E-mail | Telefone | Empresa | Fonte | Pipeline | Estágio | Pontuação | Criado Em
  3. Copie o ID da Planilha da URL.

Passo 4 — Configurar no LeadHub

  1. Vá para Configurações → Integrações → Google Sheets.
  2. Preencha:
    CampoValor
    Client IDDo Passo 2
    Client SecretDo Passo 2
    ID da PlanilhaDo Passo 3
    Nome da AbaO nome da aba, ex.: Sheet1
  3. Clique em Conectar com Google para concluir o fluxo OAuth.

Notion

Crie uma nova página (entrada de banco de dados) em um banco de dados do Notion para cada lead.

Passo 1 — Criar uma Integração no Notion

  1. Acesse notion.so/my-integrations.
  2. Clique em + Nova integração.
  3. Dê um nome (LeadHub) e selecione seu workspace.
  4. Copie o Token de Integração Interna (começa com secret_).

Passo 2 — Compartilhar Seu Banco de Dados com a Integração

  1. Abra o banco de dados do Notion onde deseja armazenar leads.
  2. Clique em Compartilhar (canto superior direito) → pesquise pelo nome da sua integração → clique em Convidar.

Passo 3 — Obter o ID do Banco de Dados

Da URL do banco de dados, o ID do Banco de Dados é a string de 32 caracteres antes do ?.

Passo 4 — Configurar no LeadHub

  1. Vá para Configurações → Integrações → Notion.
  2. Preencha:
    CampoValor
    Token de APIToken de Integração Interna do Passo 1
    ID do Banco de DadosDo Passo 3
  3. Clique em Salvar e Testar.

Airtable

Adicione um novo registro a uma base do Airtable para cada lead.

Passo 1 — Obter Sua Chave de API e Detalhes da Base/Tabela

  1. Vá para airtable.com/account → role até a seção API → gere um Token de Acesso Pessoal.
  2. Abra sua base do Airtable e obtenha o ID da Base da URL.
  3. Anote o Nome da Tabela (o nome da aba na sua base).

Passo 2 — Preparar Sua Tabela do Airtable

Certifique-se de que a tabela tenha campos para: Name, Email, Phone, Source, Company, Pipeline, Stage, Score.

Passo 3 — Configurar no LeadHub

  1. Vá para Configurações → Integrações → Airtable.
  2. Preencha:
    CampoValor
    Chave de APIToken de Acesso Pessoal do Passo 1
    ID da BaseDo Passo 2
    Nome da TabelaNome exato da tabela (diferencia maiúsculas de minúsculas)
  3. Clique em Salvar e Testar.

Webhook Genérico

Envie dados de leads para qualquer URL — seu próprio servidor, uma integração personalizada, uma função serverless ou qualquer endpoint que aceite requisições HTTP POST.

Passo 1 — Preparar Seu Endpoint

Seu endpoint deve:

  • Aceitar requisições HTTP POST
  • Aceitar Content-Type: application/json
  • Retornar um código HTTP 2xx em caso de sucesso

Passo 2 — Configurar no LeadHub

  1. Vá para Configurações → Integrações → Webhook Genérico.
  2. Preencha:
    CampoValor
    URL do WebhookA URL completa do seu endpoint
    Chave Secreta(Opcional) Uma string secreta adicionada como cabeçalho X-LeadHub-Signature
  3. Clique em Salvar e Testar.

Estrutura do Payload

{
"event": "lead.created",
"id": "lead_01HXZ3...",
"first_name": "Jane",
"last_name": "Doe",
"email": "[email protected]",
"phone": "+1 555 000 1234",
"company": "Acme Corp",
"source": "facebook_lead_ads",
"pipeline": "Sales",
"stage": "New",
"score": 72,
"tags": ["webinar", "hot"],
"custom_fields": {},
"created_at": "2025-06-15T14:23:00Z"
}

Verificação de Assinatura

Se você definir uma Chave Secreta, cada requisição incluirá o cabeçalho:

X-LeadHub-Signature: sha256=HMAC_SHA256(secret, payload_body)

Push para API REST

Envie dados de leads para um endpoint de API RESTful com método HTTP, cabeçalhos e mapeamento de campos configuráveis.

Passo 1 — Identificar Seu Endpoint de API

Você precisa de:

  • A URL do endpoint completa (ex.: https://api.seuapp.com/v1/leads)
  • O método HTTP: POST, PUT ou PATCH
  • Quaisquer cabeçalhos de autenticação necessários

Passo 2 — Configurar no LeadHub

  1. Vá para Configurações → Integrações → Push para API REST.
  2. Preencha:
    CampoValor
    URL do EndpointURL completa do endpoint da API
    Método HTTPPOST, PUT ou PATCH
    CabeçalhosObjeto JSON de cabeçalhos, ex.: {"Authorization": "Bearer abc123"}
  3. Clique em Salvar e Testar.

Solução de Problemas

ProblemaSolução
Erro OAuth do Google SheetsCertifique-se de que o URI de redirecionamento corresponde exatamente, incluindo https://
"Objeto não encontrado" no NotionA integração não está compartilhada com o banco de dados — reveja o Passo 2
Incompatibilidade de campos no AirtableOs nomes dos campos diferenciam maiúsculas de minúsculas — verifique os nomes exatos
Webhook retornando 4xxVerifique se seu endpoint aceita Content-Type: application/json
Assinatura não coincideCertifique-se de computar HMAC-SHA256 sobre o corpo bruto da requisição