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
| Servidor | URL | Autenticação | Propósito |
|---|---|---|---|
| HubSpot MCP | mcp.hubspot.com | OAuth/PKCE | Dados CRM: contactos, empresas, negócios, tickets, produtos, pedidos (só leitura) |
| Brevo MCP | mcp.brevo.com/v1/brevo/mcp | Token | Contactos, 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
- No HubSpot, aceda a Desenvolvimento > Apps de Autenticação MCP
- Clique em Criar app de autenticação MCP
- Defina o seu URL de redirecionamento (para testes no Claude Desktop:
http://localhost:6274/oauth/callback/debug) - 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-syncdescription: Sync HubSpot CRM contacts to Brevo with deal data enrichmentversion: 1.0.0temperature: 0.1tools: - hubspot - brevo_contacts - brevo_attributes - brevo_lists - brevo_segmentstriggers: - 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ção2. Para cada contacto, obter negócios associados e empresa3. 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 Brevo4. 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óriosCaso 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-campaignsdescription: Trigger targeted Brevo campaigns when HubSpot deals change stagesversion: 1.0.0temperature: 0.3tools: - hubspot - brevo_contacts - brevo_email_campaign_management - brevo_templates - brevo_segmentstriggers: - schedule: "0 9 * * *"---
# Agente de Campanha por Fase de Negócio
Monitorize as fases de negócio no HubSpot e acione campanhas deenvolvimento 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óciosExemplo: 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 agorana sequência de onboarding do Brevo.Próximos Passos
- Shopify + Brevo, Integração de e-commerce
- Stripe + Brevo, Integração de eventos de pagamento
- Especificação de Agente, Personalizar comportamento do agente