Integração HubSpot + Brevo

HubSpot + Brevo

Ligue os dados CRM do HubSpot à plataforma de envolvimento do Brevo. Use o HubSpot como fonte de verdade para dados de contactos e negócios, e o Brevo para execução de campanhas multicanal, e-mail, SMS, WhatsApp.

Servidores MCP Utilizados

ServidorURLAutenticaçãoPropósito
HubSpot MCPmcp.hubspot.comOAuth/PKCEDados CRM: contactos, empresas, negócios, tickets, produtos, pedidos (só leitura)
Brevo MCPmcp.brevo.com/v1/brevo/mcpTokenContactos, e-mail, SMS, WhatsApp, campanhas, rastreamento de eventos

Caution

O servidor MCP do HubSpot é atualmente só leitura (BETA). Pode ler dados CRM do HubSpot e usá-los para acionar ações no Brevo, mas não pode escrever de volta no HubSpot via MCP. Para sincronização bidirecional, use a REST API do HubSpot em conjunto com a ligação MCP.

Configuração

Passo 1: Criar App de Autenticação MCP do HubSpot

  1. No HubSpot, aceda a Desenvolvimento > Apps de Autenticação MCP
  2. Clique em Criar app de autenticação MCP
  3. Defina o seu URL de redirecionamento (para testes no Claude Desktop: http://localhost:6274/oauth/callback/debug)
  4. Anote o seu Client ID e Client Secret

Passo 2: Ligar Ambos os Servidores MCP

Para ferramentas que suportam OAuth (Cursor, VS Code):

{
"mcpServers": {
"hubspot": {
"url": "https://mcp.hubspot.com/",
"headers": {
"Authorization": "Bearer your-hubspot-oauth-token"
}
},
"brevo": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.brevo.com/v1/brevo/mcp",
"--header",
"Authorization: Bearer ${BREVO_MCP_TOKEN}"
],
"env": {
"BREVO_MCP_TOKEN": "your-brevo-mcp-token"
}
}
}
}

Tip

O HubSpot MCP requer OAuth com PKCE. Ferramentas como o Cursor gerem isto nativamente. Para Claude Desktop/Code, pode ser necessário obter um token separadamente e passá-lo como Bearer token.

Passo 3: Verificar

> Mostre-me os negócios HubSpot em fase de Negociação
> Quantos contactos tenho no Brevo?

Caso de Uso 1: Agente de Sincronização de Contactos CRM

Sincronize contactos HubSpot para o Brevo com enriquecimento de dados de negócios:

---
name: hubspot-contact-sync
description: Sync HubSpot CRM contacts to Brevo with deal data enrichment
version: 1.0.0
temperature: 0.1
tools:
- hubspot
- brevo_contacts
- brevo_attributes
- brevo_lists
- brevo_segments
triggers:
- schedule: "0 */4 * * *"
---
# Sincronização de Contactos HubSpot
Leia contactos e dados de negócios associados do HubSpot,
sincronize para o Brevo com atributos enriquecidos para segmentação.
## Estratégia
1. Consultar o HubSpot para contactos modificados desde a última sincronização
2. Para cada contacto, obter negócios associados e empresa
3. Criar/atualizar contacto Brevo com dados enriquecidos:
- Fase de ciclo de vida CRM → atributo Brevo
- Valor do negócio → atributo Brevo
- Fase do negócio → segmento Brevo
4. Segmentação automática no Brevo:
- Contactos "SQL" → lista Leads Qualificados para Vendas
- Contactos "Opportunity" → lista Pipeline Ativo
- Contactos "Customer" → lista Clientes
## Mapeamento de Campos
| Propriedade HubSpot | Atributo Brevo |
|--------------------|-----------------|
| email | EMAIL |
| firstname | FIRSTNAME |
| lastname | LASTNAME |
| phone | SMS |
| lifecyclestage | LIFECYCLE_STAGE |
| hs_lead_status | LEAD_STATUS |
| company (associado) | COMPANY |
| deal amount (soma) | DEAL_VALUE |
| deal stage (mais recente) | DEAL_STAGE |
## Regras
- NUNCA sincronizar contactos sem endereços de e-mail
- SEMPRE preservar dados Brevo existentes se o campo HubSpot estiver vazio
- Rastrear sincronização com eventos: hubspot_sync_success, hubspot_sync_error
- Registar contagem de contactos por fase de ciclo de vida para relatórios

Caso de Uso 2: Agente de Campanha por Fase de Negócio

Acione campanhas Brevo com base em mudanças de fase de negócio no HubSpot:

---
name: hubspot-deal-campaigns
description: Trigger targeted Brevo campaigns when HubSpot deals change stages
version: 1.0.0
temperature: 0.3
tools:
- hubspot
- brevo_contacts
- brevo_email_campaign_management
- brevo_templates
- brevo_segments
triggers:
- schedule: "0 9 * * *"
---
# Agente de Campanha por Fase de Negócio
Monitorize as fases de negócio no HubSpot e acione campanhas de
envolvimento adequadas no Brevo.
## Mapeamento de Fase para Campanha
| Fase de Negócio HubSpot | Ação Brevo |
|-------------------------|------------|
| Appointment Scheduled | Enviar e-mail de preparação para reunião com info da empresa |
| Qualified to Buy | Adicionar à sequência de nutrição "Nurture" |
| Presentation Scheduled | Enviar case study relevante para o sector |
| Decision Maker Bought-In | Enviar calculadora de ROI + guia de preços |
| Contract Sent | Enviar pré-visualização de onboarding "O que esperar" |
| Closed Won | Acionar sequência de boas-vindas + onboarding |
| Closed Lost | Adicionar à sequência "Win-back" (delay de 30 dias) |
## Regras
- APENAS enviar para contactos associados ao negócio
- Verificar se o contacto deu opt-in de marketing antes de enviar
- Um accionador de campanha por mudança de fase de negócio (sem duplicados)
- Registar todos os acionamentos de campanha para atribuição de negócios

Exemplo: Consulta em Linguagem Natural

Utilizador: "Encontre todos os negócios HubSpot fechados este mês e certifique-se
de que esses contactos estão a receber a nossa sequência de onboarding de e-mail no Brevo."
Claude: A consultar o HubSpot para negócios fechados este mês...
[Usa hubspot MCP para pesquisar negócios com closeddate no mês atual]
Encontrei 12 negócios fechados este mês, envolvendo 18 contactos.
A verificar o Brevo para estes contactos...
[Usa brevo_contacts para pesquisar cada e-mail]
Resultados:
- 14 contactos já estão no Brevo e a receber sequência de onboarding
- 4 contactos ainda não estão no Brevo
A criar 4 novos contactos Brevo e a adicionar à lista de onboarding...
[Usa brevo_contacts para criar contactos]
[Usa brevo_lists para adicionar à lista "Onboarding"]
Concluído. Todos os 18 contactos dos negócios fechados este mês estão agora
na sequência de onboarding do Brevo.

Próximos Passos

Assistente AI

Olá! Pergunte-me qualquer coisa sobre a documentação.

Comece grátis com Brevo