Integração WordPress + Leavo

Integração via Webhook – WordPress + Leavo

1. Visão Geral

O WordPress é o CMS (Content Management System) mais popular do mundo, base de 43% dos websites. A integração com o Leavo permite capturar leads de formulários, comentários e eventos do site.

Casos de uso principais:

• Capturar leads de formulários Contact Form 7, Gravity Forms
• Enviar comentaristas para qualificação no Leavo
• Qualificar visitantes que baixam materiais
• Sincronizar usuários WordPress com leads

Fluxos disponíveis:

• ✅ WordPress → Leavo: Via webhooks (plugins) ou API REST
• ✅ Leavo → WordPress: Via REST API (criar usuários, posts)

Diferencial: CMS flexível, API REST nativa, webhooks via plugins, 60.000+ plugins disponíveis.

2. Documentação Oficial

WordPress:

• REST API Handbook
• Authentication
• WP Webhooks Plugin

Leavo:

• Painel de Webhooks

3. Recursos disponíveis via Webhook

3.1 WordPress.org vs WordPress.com

Para WordPress.org: Use plugins de webhooks (WP Webhooks, WPForms, etc)

3.2 Eventos Disponíveis (via Plugins)

WP Webhooks Plugin:

4. Como configurar webhooks

4.1 FLUXO 1: WordPress → Leavo (Capturar Leads)

Permite que formulários WordPress enviem leads para qualificação no Leavo.

Passo 1: Instalar Plugin de Webhooks

Opção A: WP Webhooks (Recomendado)

1. No Admin WordPress, vá em Plugins → Adicionar novo
2. Busque "WP Webhooks"
3. Clique em "Instalar agora"
4. Clique em "Ativar"

Opção B: Contact Form 7 + Webhook Add-on

1. Instale Contact Form 7
2. Instale CF7 to Webhook

Opção C: WPForms (Próprio webhook integrado)

1. Instale WPForms
2. Webhook integrado nas configurações

Passo 2: Criar Webhook de Entrada no Leavo

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

Configurar:

• Nome: Receber de WordPress - Formulários
• Descrição: Leads de Contact Form 7 e outros
• Webhook ativo: LIGADO

Passo 3: Copiar URL do Leavo

Passo 4: Configurar Webhook no WordPress

4.1 Via WP Webhooks:

1. No Admin WP, vá em WP Webhooks → Send Data
2. Clique em "Add Webhook URL"

Configurar:

4.2 Mapear Campos:

{
  "name": "{{form.fields.name}}",
  "email": "{{form.fields.email}}",
  "phone": "{{form.fields.phone}}",
  "message": "{{form.fields.message}}",
  "source": "WordPress Contact Form"
}

4.3 Via WPForms:

1. Edite o formulário no WPForms
2. Vá em Settings → Webhooks
3. Clique em "Add New Webhook"

Configurar:

Passo 5: Estrutura do Payload WordPress

Exemplo de WPForms:

{
  "entry_id": "123",
  "form_id": "456",
  "form_name": "Formulário Contato",
  "fields": {
    "1": {
      "name": "Name",
      "value": "João Silva",
      "id": 1
    },
    "2": {
      "name": "Email",
      "value": "joao@example.com",
      "id": 2
    },
    "3": {
      "name": "Phone",
      "value": "5511999999999",
      "id": 3
    }
  },
  "date": "2025-12-11 18:00:00"
}

Passo 6: Mapear Campos no Leavo

4.2 FLUXO 2: Leavo → WordPress (Criar Usuários)

Permite que leads qualificados no Leavo virem usuários WordPress.

Passo 1: Gerar Application Password

1.1 No WordPress Admin:

1. Vá em Usuários → Seu Perfil
2. Role até "Senhas de Aplicação"
3. Nome: Leavo Integration
4. Clique em "Adicionar Nova Senha"

WordPress gera senha:

Use sem espaços: abcd1234efgh5678ijkl9012

Passo 2: Configurar Middleware (n8n)

2.1 Nó Function:

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

return {
  json: {
    username: leavo.email.split('@')[0],
    email: leavo.email,
    first_name: leavo.nome.split(' ')[0],
    last_name: leavo.nome.split(' ').slice(1).join(' '),
    roles: ['subscriber'],
    meta: {
      telefone: leavo.telefone,
      empresa: leavo.empresa
    }
  }
};

2.2 Nó HTTP Request:

5. Testando a integração

✅ Checklist - WordPress → Leavo

WordPress:

• Plugin instalado
• Webhook configurado
• Campos mapeados
• Formulário testado

Leavo:

• Webhook de entrada criado
• URL copiada
• Campos mapeados

✅ Checklist - Leavo → WordPress

WordPress:

• Application Password gerada
• API REST testada

Middleware (n8n):

• Workflow criado
• Transformation implementada
• Basic Auth configurado

6. Estrutura de Payloads

6.1 WordPress → Leavo (Contact Form 7)

{
  "your-name": "Maria Santos",
  "your-email": "maria@example.com",
  "your-phone": "5511988887777",
  "your-message": "Gostaria de saber mais sobre os serviços",
  "form-id": "123",
  "form-title": "Formulário de Contato"
}

6.2 Leavo → WordPress (REST API users)

curl -X POST 'https://seu-site.com/wp-json/wp/v2/users' \
-u 'username:abcd1234efgh5678ijkl9012' \
-H 'Content-Type: application/json' \
-d '{
  "username": "pedro",
  "email": "pedro@example.com",
  "first_name": "Pedro",
  "last_name": "Oliveira",
  "roles": ["subscriber"]
}'

7. Observações e Limitações

7.1 Limitações do WordPress

7.2 Plugins Recomendados

Para Webhooks:

• WP Webhooks (Grátis + Pro)
• CF7 to Webhook (Contact Form 7)
• Webhooks for WPForms

Para Formulários:

• WPForms (Webhooks nativos)
• Contact Form 7 (Popular)
• Gravity Forms (Avançado)

8. Boas Práticas

8.1 Usar Application Passwords

✅ Mais seguro que senha normal:

Vantagens:

• Pode ser revogada
• Não expõe senha real
• Por aplicação

8.2 Validar Dados Antes de Enviar

✅ Filtrar spam:

add_filter('wpcf7_before_send_mail', function($contact_form) {
  $submission = WPCF7_Submission::get_instance();
  $data = $submission->get_posted_data();
  
  if (!filter_var($data['your-email'], FILTER_VALIDATE_EMAIL)) {
    return false;
  }
  
  return $contact_form;
});

9. Troubleshooting

9.1 Webhook não envia

9.2 Usuário não cria

10. Casos de Uso

10.1 Formulário → Qualificação

Objetivo: Leads de formulários qualificados automaticamente

Fluxo:

10.2 Lead → Usuário WordPress

Objetivo: Leads qualificados viram usuários

Fluxo:

Referências

• WordPress REST API Handbook
• WP Webhooks Plugin
• Painel de Webhooks Leavo