Forms API do HubSpot: captação de leads de qualquer site
A Forms API do HubSpot permite que qualquer site mantenha o próprio formulário e envie cada submissão ao HubSpot no momento em que ela acontece, com o cookie de ...
O que fazemos · Construir
Implementação de HubSpotMigração de CRMGTM EngineeringRelatórios e Analytics no HubSpotO que fazemos · Operar
HubSpot Managed ServicesGTM as a ServiceRevOps as a ServiceAI & Agent Hub Programa de Parceria White-LabelConteúdos
ArtigosCasesGuia de Revenue OperationsGuia de Go to MarketGuia de implementação do HubSpotGuia de vendas B2BGuia de indicadores de vendasGuia de integração de sistemasGuia de integração de sistemas
Integração de sistemas é fazer o CRM, o ERP, o faturamento, o produto e os canais de atendimento trocarem dados sozinhos, sem digitação dupla nem planilha no meio. Este guia mostra o que integrar ao HubSpot, qual caminho escolher em cada caso e como manter a integração funcionando.
Definição
Integração de sistemas é a conexão entre softwares diferentes para que um dado criado ou alterado em um deles chegue aos outros sem trabalho manual. Na área comercial, o caso mais comum é o CRM conversando com o ERP: o negócio ganho no HubSpot vira pedido no ERP, e a nota fiscal e o pagamento voltam para o registro do cliente.
Uma boa integração define três coisas: quais dados passam de um sistema para o outro, em que direção e com que frequência, e qual sistema é a fonte da verdade de cada campo. Sem essas definições, a integração copia erros mais rápido do que uma pessoa copiaria. O artigo integrando dados entre sistemas de vendas trata esse planejamento do ponto de vista do gestor.
Para o lado técnico da API do HubSpot, o nosso guia completo da API da HubSpot aprofunda autenticação, objetos e limites. Aqui o foco é a visão completa: o que integrar, qual caminho escolher e o que costuma dar errado.
O que integrar
Cada uma resolve um retrabalho diferente. Comece pela que hoje consome mais tempo do time ou gera mais erro.
Negócio ganho vira pedido, e pedidos, notas e pagamentos voltam para o cliente no CRM. Vendas e CS veem o histórico financeiro sem pedir para ninguém.
Integração com CRMSistemas antigos, sem API moderna, que ainda guardam dados importantes. Exigem uma camada intermediária para conversar com o HubSpot.
Integração de sistema legadoConversas registradas no contato e no negócio, com o histórico visível para quem atende depois.
CRM integrado com WhatsAppLeads de qualquer site ou landing page chegando ao HubSpot com origem, consentimento e campos corretos.
Forms API do HubSpotDados de empresa e de contato completados automaticamente, para segmentar, distribuir e priorizar leads.
Enriquecimento de dados em vendasDados do HubSpot e de outros sistemas reunidos em um só lugar para análises que o CRM sozinho não faz.
Ferramentas de ETLOs caminhos
Não existe caminho certo para tudo. A escolha depende do sistema do outro lado, do volume de dados e das regras de negócio.
| App nativo | iPaaS ou middleware | API sob medida | |
|---|---|---|---|
| Como funciona | Conector pronto do marketplace do HubSpot, instalado e configurado | Uma plataforma no meio recebe, transforma e envia os dados entre os sistemas | Código próprio que chama a API do HubSpot e a do outro sistema |
| Melhor para | Ferramentas populares com mapeamento padrão | Vários sistemas, transformações e regras moderadas | Regras de negócio específicas, volume alto ou sistemas sem conector |
| Tempo até rodar | Horas ou dias | Dias ou semanas | Semanas, com escopo e testes |
| Limites | Campos e regras que o conector oferece | Custo por execução e lógica complexa difícil de manter | Exige engenharia para construir e manter |
| Quem mantém | O fornecedor do app | O time que configurou os fluxos | O time de engenharia responsável |
Como planejar uma integração
A maior parte dos problemas de integração nasce no planejamento, não no código.
01 · Dados
Liste quais objetos passam de um sistema para o outro (empresas, contatos, negócios, pedidos) e o campo correspondente de cada lado, com formato e valores aceitos.
Resultado: um mapa de campos que os dois times aprovam.
02 · Regras
Para cada campo, qual sistema manda. Sem essa regra, uma sincronização nos dois sentidos sobrescreve dados bons com dados velhos.
Resultado: nenhum campo com dois donos.
03 · Fluxo
Sentido único ou nos dois sentidos; em tempo real por webhook ou em lotes programados. Tempo real só onde o processo precisa dele.
Resultado: uma sincronização do tamanho da necessidade.
04 · Construção
App nativo, iPaaS ou API sob medida, com autenticação, paginação, limites de chamadas e novas tentativas tratados desde o início.
Resultado: uma integração que aguenta volume real.
05 · Operação
Alertas para falhas, registro do que foi sincronizado e documentação do mapa de campos. Integração sem dono para de funcionar em silêncio.
Resultado: erros vistos antes de virarem problema no comercial.
Vai trocar de CRM em vez de integrar? Aí o caminho é uma migração de CRM para o HubSpot, que leva o histórico junto.
A API do HubSpot na prática
Quando o caminho é a API, estes são os pontos que decidem se a integração aguenta o dia a dia.
App privado ou público, OAuth, escopos e tokens: a base que evita bloqueios depois.
Autenticação na API da HubSpotComo ler objetos, propriedades e associações e manter outro sistema em dia com o HubSpot.
API de CRM da HubSpotA Search API para encontrar registros por filtro, ordenar e buscar só o que mudou.
Search API da HubSpotPercorrer grandes volumes de registros sem perder nem duplicar nenhum.
Paginação na API da HubSpotReceber eventos do HubSpot em tempo real, com validação de assinatura e novas tentativas.
Webhooks da HubSpotAções de código personalizado nos workflows para regras que a automação nativa não cobre.
Custom code na HubSpotPara automações que combinam webhooks, workflows e código, veja automação na HubSpot com webhooks, workflows e código personalizado.
Erros comuns
A maioria das integrações quebradas cai em um destes casos.
O app não tem a permissão que a chamada exige, mesmo depois de reinstalado.
Como resolver o 403Chamadas demais em pouco tempo. Exige controle de ritmo, lotes e novas tentativas com espera.
Limites da API da HubSpotO token de acesso deixa de ser renovado e a integração para sem aviso.
Causas e correçãoEventos reenviados que criam registros ou tarefas duplicados quando o receptor não trata repetição.
Retentativas de webhooksSincronizações que buscam só uma parte dos registros alterados e deixam o outro sistema desatualizado.
Sincronizar contatos sem perder nadaNinguém recebe o alerta quando a integração falha, e o time descobre pelo cliente.
Integração via API na operaçãoDo blog
A Forms API do HubSpot permite que qualquer site mantenha o próprio formulário e envie cada submissão ao HubSpot no momento em que ela acontece, com o cookie de ...
O erro invalid refresh token da HubSpot (BAD_REFRESH_TOKEN ou invalid_grant) indica um refresh token OAuth revogado ou não reconhecido, que não pode ser restaurado; a ...
Webhooks da HubSpot em produção exigem validar cada requisição com a assinatura v3 (HMAC SHA-256), tratar a entrega como at-least-once e fora de ordem com handlers ...
Custom code actions da HubSpot rodam JavaScript (Node.js) ou Python dentro de workflows, leem secrets como variáveis de ambiente, precisam terminar em 20 segundos com ...
Integrar a HubSpot com o n8n exige guardar a credencial no gerenciador do n8n, usar service key ou OAuth2 no node HubSpot e developer API key no Trigger, conferir os ...
A automação por API na HubSpot combina três frentes: workflows criados pela Automation v4, webhooks que avisam a integração sobre eventos em tempo real e ações de código ...
Perguntas frequentes
É a conexão entre softwares diferentes para que os dados criados ou alterados em um cheguem aos outros sem trabalho manual, como o CRM conversando com o ERP, o faturamento ou o WhatsApp.
Três caminhos principais: um app nativo do marketplace do HubSpot, uma plataforma de integração (iPaaS) ou middleware no meio dos sistemas, ou uma integração sob medida construída sobre a API do HubSpot. Veja como integrar a HubSpot a outros softwares.
É a interface que permite a outros sistemas ler e gravar dados no HubSpot, como contatos, empresas, negócios, formulários e eventos, por meio de chamadas autenticadas. O guia completo da API da HubSpot explica como ela funciona.
É um software que fica entre dois ou mais sistemas, recebendo, transformando e entregando os dados entre eles. Ajuda quando os sistemas não conversam diretamente ou quando a mesma informação precisa ir para vários destinos. Leia o que é middleware.
Quando não existe conector pronto, quando as regras de negócio são específicas demais para um app nativo ou quando o volume de dados exige controle de limites, lotes e novas tentativas que uma ferramenta genérica não oferece.
Só quando os dois sistemas precisam editar os mesmos dados. Nesse caso, defina qual sistema é a fonte da verdade de cada campo. Na maioria dos casos, cada campo tem um dono e a sincronização em um só sentido é mais simples e mais segura.
Integre quando o outro sistema continua sendo usado, como um ERP. Migre quando o HubSpot vai substituir o sistema atual, como um CRM antigo; nesse caso, veja migração de CRM para o HubSpot.
Precisa de uma integração?
Construímos integrações, pipelines de dados e automações onde o HubSpot nativo não chega, com monitoramento e documentação.