Integração RD Station + Leavo

Integração via Webhook – RD Station + Leavo

1. Visão Geral

A RD Station é a principal plataforma de Marketing e Vendas da América Latina, oferecendo automação de marketing (RD Station Marketing) e CRM (RD Station CRM). A integração com o Leavo permite sincronizar leads qualificados e automatizar o fluxo entre qualificação e nutrição de leads.

Casos de uso principais:

• Enviar leads qualificados do Leavo para nutrição no RD Station Marketing
• Criar oportunidades no RD Station quando lead é qualificado
• Receber conversões do RD Station para qualificação no Leavo
• Sincronizar deals do CRM com status de leads

Fluxos disponíveis:

• ✅ Leavo → RD Station: Via API REST (conversões, contatos)
• ✅ RD Station → Leavo: Webhooks notificam conversões e oportunidades

Diferencial: Líder LATAM em marketing automation, integração nativa com ecossistema brasileiro, webhooks robustos.

2. Documentação Oficial

RD Station:

• Webhook Service
• Autenticação
• Conversão via API Key
• Webhooks Payloads

Leavo:

• Painel de Webhooks

3. Recursos disponíveis via Webhook

3.1 Eventos do RD Station

RD Station Marketing:

RD Station CRM:

⚠️ CRM Webhooks: Disponíveis apenas nos planos CRM Basic e PRO.

4. Como configurar webhooks

4.1 FLUXO 1: Leavo → RD Station (Enviar Leads)

Permite que leads qualificados no Leavo sejam enviados para nutrição no RD Station Marketing.

Passo 1: Obter API Key do RD Station

1.1 No RD Station Marketing:

1. Vá em Configurações (⚙️)
2. Clique em Integrações
3. Selecione API
4. Copie a API Key (ou gere uma nova)

⚠️ IMPORTANTE: Guarde esta chave com segurança.

Passo 2: Configurar Middleware (Recomendado)

⚠️ IMPORTANTE: O RD Station requer api_key na query string. Use middleware para facilitar.

Opção A: Usando n8n

2.1 Criar Workflow:

2.2 Nó Function:

// Transformar payload do Leavo para RD Station
const leavo = $json.body.data;

return {
  json: {
    event_type: "CONVERSION",
    event_family: "CDP",
    payload: {
      conversion_identifier: "lead_qualificado_leavo",
      email: leavo.email,
      name: leavo.nome,
      mobile_phone: leavo.telefone,
      company: leavo.empresa,
      cf_status: leavo.status,
      cf_origem: "Leavo"
    }
  }
};

2.3 Nó HTTP Request:

Passo 3: Configurar Webhook de Saída no Leavo

1. No Leavo, vá em Webhooks → Saída
2. Clique em "+ Criar Webhook"

Configurar:

4.2 FLUXO 2: RD Station → Leavo (Notificar Conversões)

Permite que conversões no RD Station sejam qualificadas no Leavo.

Passo 1: Criar Webhook de Entrada no Leavo

1. No Leavo, vá em Webhooks → Entrada
2. Clique em "+ Criar Webhook"

Configurar:

• Nome: Receber de RD Station - Conversões
• Descrição: Qualifica leads que convertem
• Webhook ativo: LIGADO

Passo 2: Copiar URL do Leavo

Passo 3: Configurar Webhook no RD Station

Via Painel (RD Station Marketing):

1. Vá em Integrações → Webhooks
2. Clique em "+ Novo Webhook"
3. Configure:

Passo 4: Estrutura do Payload do RD Station

Exemplo de WEBHOOK.CONVERTED:

{
  "event_type": "WEBHOOK.CONVERTED",
  "entity_type": "CONTACT",
  "event_identifier": "Formulário Contato",
  "timestamp": "2025-12-11T18:00:00.000-03:00",
  "contact": {
    "uuid": "c2f3d2b3-7250-4d27-97f4-eef38be32f7f",
    "email": "joao@example.com",
    "name": "João Silva",
    "job_title": "Gerente",
    "mobile_phone": "5511999999999",
    "company": "Empresa ABC",
    "tags": ["Hot-Lead", "B2B"],
    "funnel": {
      "lifecycle_stage": "Lead",
      "opportunity": false,
      "origin": "Busca Paga | Google Ads"
    }
  }
}

Passo 5: Mapear Campos no Leavo

5. Testando a integração

✅ Checklist - Leavo → RD Station

RD Station:

• API Key obtida

Middleware (n8n):

• Workflow criado
• Webhook configurado
• Function implementada
• HTTP Request configurado

Teste:

• Lead qualificado
• Webhook disparou
• Conversão criada no RD Station

✅ Checklist - RD Station → Leavo

Leavo:

• Webhook de entrada criado
• URL copiada

RD Station:

• Webhook configurado
• URL do Leavo configurada
• Evento selecionado

6. Estrutura de Payloads

6.1 Leavo → RD Station (API Conversão)

curl --request POST \
  --url 'https://api.rd.services/platform/conversions?api_key=YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "event_type": "CONVERSION",
  "event_family": "CDP",
  "payload": {
    "conversion_identifier": "lead_qualificado_leavo",
    "email": "maria@example.com",
    "name": "Maria Santos",
    "mobile_phone": "5511988887777",
    "company": "Tech Solutions",
    "cf_status_leavo": "Qualificado"
  }
}'

7. Observações e Limitações

7.1 Limitações do RD Station

8. Boas Práticas

8.1 Usar Identificador de Conversão

✅ Nome descritivo:

8.2 Campos Customizados

✅ Prefixo cf_:

{
  "cf_status_leavo": "Qualificado",
  "cf_score": "85",
  "cf_origem": "Google Ads"
}

Nota: Campos customizados devem ser criados primeiro no RD Station.

9. Troubleshooting

9.1 Conversão não cria

9.2 Webhook não recebe

10. Casos de Uso

10.1 Qualificação Automática

Objetivo: Leads do RD Station qualificados pelo Leavo

Fluxo:

10.2 Nutrição Pós-Qualificação

Objetivo: Leads qualificados voltam para nutrição

Fluxo:

Referências

• RD Station Webhook Service
• RD Station API Reference
• Painel de Webhooks Leavo