Guia de integração de sistemas

Integração de sistemas com o HubSpot: API, middleware e iPaaS

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

O que é integração de sistemas?

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.

Neste guia

  1. O que integrar ao HubSpot
  2. App nativo, iPaaS e middleware ou API sob medida
  3. Como planejar uma integração
  4. A API do HubSpot na prática
  5. Erros comuns e como resolver
  6. Perguntas frequentes

O que integrar

Seis integrações que mais mudam a operação.

Cada uma resolve um retrabalho diferente. Comece pela que hoje consome mais tempo do time ou gera mais erro.

  • ERP e faturamento

    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 CRM
  • Sistemas legados

    Sistemas antigos, sem API moderna, que ainda guardam dados importantes. Exigem uma camada intermediária para conversar com o HubSpot.

    Integração de sistema legado
  • WhatsApp e atendimento

    Conversas registradas no contato e no negócio, com o histórico visível para quem atende depois.

    CRM integrado com WhatsApp
  • Sites e formulários externos

    Leads de qualquer site ou landing page chegando ao HubSpot com origem, consentimento e campos corretos.

    Forms API do HubSpot
  • Enriquecimento de dados

    Dados de empresa e de contato completados automaticamente, para segmentar, distribuir e priorizar leads.

    Enriquecimento de dados em vendas
  • Warehouse e BI

    Dados do HubSpot e de outros sistemas reunidos em um só lugar para análises que o CRM sozinho não faz.

    Ferramentas de ETL

Os caminhos

App nativo, iPaaS ou API sob medida

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.

Comparação entre app nativo do marketplace, iPaaS ou middleware e integração sob medida via API
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

Cinco passos antes da primeira linha de código.

A maior parte dos problemas de integração nasce no planejamento, não no código.

  1. 01 · Dados

    Mapeie objetos e campos

    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.

  2. 02 · Regras

    Defina a fonte da verdade

    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.

  3. 03 · Fluxo

    Escolha direção e frequência

    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.

  4. 04 · Construção

    Escolha o caminho e construa

    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.

  5. 05 · Operação

    Monitore e documente

    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

Os fundamentos de uma integração sob medida.

Quando o caminho é a API, estes são os pontos que decidem se a integração aguenta o dia a dia.

  • 01

    Autenticação e apps

    App privado ou público, OAuth, escopos e tokens: a base que evita bloqueios depois.

    Autenticação na API da HubSpot
  • 02

    Leitura e sincronização do CRM

    Como ler objetos, propriedades e associações e manter outro sistema em dia com o HubSpot.

    API de CRM da HubSpot
  • 03

    Busca e filtros

    A Search API para encontrar registros por filtro, ordenar e buscar só o que mudou.

    Search API da HubSpot
  • 04

    Paginação

    Percorrer grandes volumes de registros sem perder nem duplicar nenhum.

    Paginação na API da HubSpot
  • 05

    Webhooks

    Receber eventos do HubSpot em tempo real, com validação de assinatura e novas tentativas.

    Webhooks da HubSpot
  • 06

    Código dentro do HubSpot

    Ações de código personalizado nos workflows para regras que a automação nativa não cobre.

    Custom code na HubSpot

Para automações que combinam webhooks, workflows e código, veja automação na HubSpot com webhooks, workflows e código personalizado.

Erros comuns

O que quebra e como resolver.

A maioria das integrações quebradas cai em um destes casos.

  • Erro 403 de escopos

    O app não tem a permissão que a chamada exige, mesmo depois de reinstalado.

    Como resolver o 403
  • Erro 429 de limite

    Chamadas demais em pouco tempo. Exige controle de ritmo, lotes e novas tentativas com espera.

    Limites da API da HubSpot
  • Invalid refresh token

    O token de acesso deixa de ser renovado e a integração para sem aviso.

    Causas e correção
  • Webhook disparado de novo

    Eventos reenviados que criam registros ou tarefas duplicados quando o receptor não trata repetição.

    Retentativas de webhooks
  • Atualizações perdidas

    Sincronizações que buscam só uma parte dos registros alterados e deixam o outro sistema desatualizado.

    Sincronizar contatos sem perder nada
  • Integração sem dono

    Ninguém recebe o alerta quando a integração falha, e o time descobre pelo cliente.

    Integração via API na operação

Do blog

Últimos artigos sobre integrações e API.

Ver todos os artigos de integrações e API

Perguntas frequentes

Integração de sistemas, respondida.

O que é integração de sistemas?

É 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.

Quais são as formas de integrar o HubSpot a outro sistema?

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.

O que é a API do HubSpot?

É 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.

O que é middleware?

É 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 vale fazer uma integração sob medida?

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.

A sincronização deve ser nos dois sentidos?

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.

Integrar ou migrar para o HubSpot?

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?

Onde o HubSpot termina, nossos engenheiros de integração começam.

Construímos integrações, pipelines de dados e automações onde o HubSpot nativo não chega, com monitoramento e documentação.

Conheça GTM Engineering