O que é o HubSpot
O HubSpot é um CRM completo, com marketing, vendas e atendimento no mesmo produto. É comum em operações B2B com ciclo de venda longo e várias pessoas envolvidas na decisão.
A integração aqui é menos sobre transportar registro e mais sobre respeitar o modelo: contato, empresa, negócio e ticket são objetos distintos, ligados por associações. Ignorar isso produz base tecnicamente cheia e comercialmente inútil.
O que a API entrega
API REST bem documentada, com objetos padrão e objetos personalizados, propriedades customizadas e associações explícitas entre registros. Também há webhooks para mudança de propriedade e de estágio.
As associações não são automáticas: criar contato e empresa não os liga. Integração que esquece esse passo gera negócio sem empresa, e relatório por cliente para de funcionar.
Há limite de requisições por período e por aplicativo. Operação em massa deve usar as rotas de lote em vez de uma chamada por registro.
Fluxos que construímos
Cliente do ERP para o CRM
Empresa, contatos e associações criados corretamente, com o documento como chave de deduplicação — não o nome.
Negócio ganho para o ERP
Fechamento virando pedido, contrato ou ordem de serviço sem redigitação, com os itens e a condição comercial preservados.
Faturamento de volta ao CRM
Situação financeira e histórico de compra visíveis para quem vende, para a conversa de renovação acontecer com informação.
Ticket de atendimento ligado ao cliente
Chamado associado à empresa certa, para o histórico não ficar preso a um contato que saiu.
O que costuma quebrar
Registro sem associação
Contato, empresa e negócio existem mas não se ligam. A base parece completa e o relatório por cliente não fecha — é a falha mais comum nesta plataforma.
Deduplicação por nome
Nome de empresa varia demais para servir de chave. Documento resolve, e precisa estar em propriedade dedicada desde o começo.
Uma chamada por registro
Carga inicial feita registro a registro estoura o limite e leva horas. As rotas de lote existem para isso.
Propriedade criada sem padrão
Campos personalizados nascendo sem convenção viram dezenas de propriedades parecidas. Definir a convenção antes é barato; limpar depois, não.
Prazo típico
- 2 a 4
- semanas para cliente, negócio e associações
- +1 a 2
- semanas para faturamento de volta
- lote
- carga inicial pelas rotas de lote
Perguntas frequentes
Por que a associação entre objetos importa tanto?
Porque é o que faz o relatório por cliente existir. Sem associação, você tem contatos, empresas e negócios em listas separadas — e nenhuma pergunta de gestão pode ser respondida, mesmo com todos os dados presentes.
Devemos usar objeto personalizado?
Quando a sua operação tem uma entidade que os objetos padrão não representam — uma apólice, um contrato de locação, um lote. O cuidado é não recriar em objeto personalizado algo que já cabe em negócio, o que dobra a manutenção.
Dá para integrar mantendo o app da nossa agência?
Dá, definindo quem é dono de cada propriedade. Quando dois aplicativos escrevem no mesmo campo, o último grava e o outro parece estar errado — a maior parte dos casos de 'o CRM mudou sozinho' é isso.
Como fica o custo com o volume de contatos?
O plano do HubSpot é sensível a volume, então sincronizar a base inteira do ERP pode encarecer sem trazer valor. Definir o critério do que sobe — cliente ativo, oportunidade real — costuma ser decisão comercial, e vale tomá-la antes de integrar.