Conectando Respond.io ao HubSpot: Sync de Contatos, Log de Conversas e Fluxos

Uma equipe de vendas B2B usava o Respond.io para WhatsApp e o HubSpot como CRM principal. O problema: eles eram dois sistemas paralelos. Os reps tinham que checar o Respond.io para ver o histórico de conversas e o HubSpot para ver o histórico de negócios. Gestores não conseguiam ver se um lead que estava no pipeline do HubSpot havia sido contatado pelo WhatsApp recentemente. O contexto ficava dividido entre ferramentas.

A integração nativa do Respond.io com o HubSpot resolve essa fragmentação ao criar um canal bidirecional: contatos criados no Respond.io aparecem no HubSpot, conversas do WhatsApp ficam registradas na linha do tempo do HubSpot, e eventos no HubSpot podem disparar automações no Respond.io.

Pré-requisitos

Antes de configurar a integração, verifique:

  1. Conta Respond.io com plano que inclui integrações de CRM (Team ou superior)
  2. Conta HubSpot com acesso de admin (a autorização OAuth requer permissões de admin)
  3. WhatsApp Business API já conectado ao Respond.io (a integração com HubSpot não requer que o WhatsApp esteja funcionando, mas é o caso de uso principal)
  4. Mapeamento de campos definido: saber quais propriedades do Respond.io você quer mapear para quais propriedades do HubSpot antes de começar a configuração

Etapa 1: Conectando via OAuth

A conexão entre Respond.io e HubSpot é feita via OAuth e leva menos de 5 minutos.

No Respond.io:

  1. Vá para Configurações → Integrações
  2. Encontre HubSpot na lista de integrações disponíveis
  3. Clique em "Conectar"
  4. Você será redirecionado para o HubSpot para autorizar a conexão
  5. Faça login com sua conta HubSpot (precisa ter permissões de admin)
  6. Selecione o portal HubSpot que deseja conectar (se tiver múltiplos)
  7. Autorize o acesso
  8. Você será redirecionado de volta ao Respond.io com a conexão estabelecida

Depois da conexão, você vai configurar os detalhes: quais objetos sincronizar, como mapear campos, quais eventos disparar automações.

Etapa 2: Configure a sincronização de contatos

A sincronização de contatos define o que acontece quando um novo contato é criado no Respond.io e como os campos são mapeados para o HubSpot.

Configurações de sincronização:

Em Configurações → Integrações → HubSpot → Sincronização de Contatos, configure:

  • Direção da sincronização: Respond.io → HubSpot (recomendado para começar), ou bidirecional
  • Gatilho de criação: Quando criar o contato no HubSpot? Opções: quando uma nova conversa começa, quando um fluxo de qualificação é concluído, ou manualmente pelo rep
  • Conflito de duplicatas: O que fazer se o número de telefone já existe no HubSpot? Opções: atualizar contato existente (recomendado), criar novo, ou pular

Mapeamento de campos padrão:

O Respond.io mapeia automaticamente alguns campos básicos:

  • Nome do contato → Nome/Sobrenome no HubSpot
  • Número de telefone → Número de telefone no HubSpot
  • E-mail (se coletado) → E-mail no HubSpot
  • Canal de origem → Lead Source no HubSpot

Mapeamento de campos customizados:

Campos coletados no fluxo de qualificação (tamanho da empresa, cargo, desafio, score) precisam ser mapeados manualmente.

Em Configurações → Integrações → HubSpot → Mapeamento de Campos:

  1. Clique em "Adicionar Mapeamento"
  2. Em "Campo do Respond.io", selecione o atributo de contato customizado (ex: qualif_tamanho_equipe)
  3. Em "Propriedade do HubSpot", selecione ou crie a propriedade customizada correspondente
  4. Repita para cada campo de qualificação

Para que o mapeamento funcione, as propriedades customizadas precisam existir no HubSpot antes de configurar o mapeamento. Crie-as em HubSpot → Configurações → Propriedades → Criar Propriedade antes de voltar para o Respond.io.

Etapa 3: Configure o log de conversas

O log de conversas registra as mensagens do WhatsApp (e outros canais do Respond.io) na linha do tempo do contato no HubSpot como atividades.

Habilitando o log de atividades:

Em Configurações → Integrações → HubSpot → Log de Atividades:

  • Ative "Registrar mensagens como atividades no HubSpot"
  • Escolha o tipo de atividade: Note (mais visível na linha do tempo) ou Task (útil se você usa tasks do HubSpot para follow-up)
  • Configure o formato: incluir o texto da mensagem, o canal, o timestamp e o rep que respondeu

O que aparece na linha do tempo:

Cada troca de mensagens aparece na linha do tempo do contato assim:

[WhatsApp - 08/04/2026 14:32]
Canal: WhatsApp Business API
Rep: Carlos Silva

Lead: "Olá, vi seu anúncio sobre gestão de vendas"
Rep: "Olá! Aqui é o Carlos da Rework. [...]"

[Conversa iniciada via anúncio Meta Ads]

Reps que abrem o contato no HubSpot conseguem ver o histórico completo do WhatsApp sem precisar abrir o Respond.io.

Limitações do log:

O log registra conversas depois da conexão ser estabelecida. Conversas anteriores à integração não são retroativamente registradas. Se você tem conversas históricas importantes no Respond.io, precisará de uma exportação manual ou de um script de migração.

Etapa 4: Configure workflows disparados pelo HubSpot

Um dos recursos mais poderosos da integração é usar eventos do HubSpot para disparar ações no Respond.io.

Casos de uso comuns:

Caso 1: Enviar mensagem WhatsApp quando negócio avança de estágio

Quando um negócio no HubSpot avança de "Proposta Enviada" para "Em Negociação", envie automaticamente uma mensagem WhatsApp para o contato:

"Olá [Nome]! Recebi confirmação de que você revisou nossa proposta. Quero ter certeza de que todas as suas dúvidas foram respondidas. Tem alguma pergunta específica antes de seguirmos?"

Configuração: HubSpot Workflow → trigger em mudança de estágio → ação "Respond.io: Enviar Mensagem" → selecione template de mensagem.

Caso 2: Criar conversa no Respond.io quando um lead de alto valor entra no pipeline

Quando um negócio é criado no HubSpot com valor acima de R$50.000, crie automaticamente uma conversa no Respond.io e atribua para o AE responsável pela conta:

Configuração: HubSpot Workflow → trigger em criação de negócio (filtro: Valor >= 50000) → ação "Respond.io: Criar Conversa" → atribuir para o owner do negócio.

Caso 3: Atualizar propriedade do contato no HubSpot quando rep define status no Respond.io

Quando um rep marca uma conversa como "Qualificado" no Respond.io, atualiza o estágio do lead no HubSpot para "MQL":

Configuração: No Respond.io Workflow → trigger em mudança de tag → ação "HubSpot: Atualizar Propriedade" → Lifecycle Stage = MQL.

Configurando workflows bidirecionais:

Para workflows que vão do HubSpot para o Respond.io:

  1. No HubSpot, crie um Workflow em Automação → Workflows
  2. Defina o gatilho (mudança de propriedade, criação de objeto, etc.)
  3. Adicione uma ação "Webhook" que faz POST para o endpoint do Respond.io
  4. No Respond.io, configure o Webhook como gatilho de um Workflow interno

Para workflows que vão do Respond.io para o HubSpot:

  1. No Respond.io, crie um Workflow em Automação → Workflows
  2. Defina o gatilho (conversa criada, tag adicionada, campo atualizado)
  3. Adicione uma ação "HubSpot" com a operação desejada (criar/atualizar contato, criar negócio, atualizar propriedade)

Etapa 5: Sincronização de negócios (deals)

Além de contatos, você pode configurar a criação automática de negócios no HubSpot a partir de eventos no Respond.io.

Criando negócios automaticamente:

Em Configurações → Integrações → HubSpot → Sincronização de Negócios:

  • Ative "Criar negócio quando lead for qualificado"
  • Configure: qual evento dispara a criação (conclusão de fluxo de qualificação, tag específica adicionada, ou manualmente pelo rep)
  • Configure os campos do negócio: pipeline, estágio inicial, nome padrão do negócio, owner

O nome do negócio pode usar variáveis: [Nome da Empresa] - WhatsApp - [Data] cria um negócio nomeado de forma útil para rastreamento de fonte.

Associando negócios ao contato e empresa:

Se você está coletando o nome da empresa no fluxo de qualificação, o Respond.io pode:

  1. Verificar se a empresa já existe no HubSpot
  2. Criar a empresa se não existir
  3. Associar o contato à empresa
  4. Criar o negócio associado ao contato e à empresa

Essa associação automática elimina a etapa manual que muitos reps pulam, resultando em negócios não associados a empresas e dados de pipeline inconsistentes.

Etapa 6: Teste a integração completamente

Antes de ativar para leads reais, faça um teste end-to-end:

  1. Envie uma mensagem para o número WhatsApp conectado a partir de um número de teste
  2. Complete o fluxo de qualificação
  3. Verifique se o contato foi criado no HubSpot com os campos corretos
  4. Verifique se a conversa aparece na linha do tempo do contato
  5. Se configurou criação automática de negócio, verifique se o negócio foi criado
  6. Mude o estágio do negócio no HubSpot e verifique se o workflow bidirecional disparou corretamente (se configurado)
  7. Verifique se o rep recebeu a notificação de handoff

O teste completo leva menos de 30 minutos e previne problemas que só aparecem com leads reais, quando a correção é mais cara.

Armadilhas Comuns

Mapeamento de campos incompleto. Configurar a conexão OAuth mas não mapear os campos de qualificação resulta em contatos criados no HubSpot sem as informações relevantes. Defina o mapeamento completo antes de ativar.

Propriedades customizadas não existindo no HubSpot antes do mapeamento. O Respond.io vai tentar criar o contato com os campos mapeados, mas se a propriedade não existe no HubSpot, o campo é ignorado silenciosamente. Crie todas as propriedades customizadas no HubSpot primeiro.

Sincronização unidirecional criando duplicatas. Se a sincronização está configurada como Respond.io → HubSpot sem lógica de deduplicação, e um contato já existe no HubSpot, você pode acabar com duplicatas. Configure a opção "Atualizar contato existente" baseado em número de telefone ou e-mail.

Workflows do HubSpot disparando para todos os contatos, não apenas os de chat. Se um Workflow do HubSpot envia mensagem WhatsApp para todos os contatos que entram em um estágio específico do pipeline, inclui contatos que vieram de outros canais e podem não ter interagido com o WhatsApp. Adicione um filtro de Lead Source = WhatsApp ou Canal = WhatsApp nos Workflows do HubSpot que disparam ações no Respond.io.

Próximos Passos

Comece com a configuração básica: sincronização de contatos + log de conversas. Ative, rode por duas semanas e verifique se os dados no HubSpot estão chegando limpos. Só depois adicione os workflows bidirecionais, que têm mais complexidade para debugar. Uma integração simples funcionando bem vale mais do que uma integração complexa com problemas intermitentes.

Saiba Mais