Integração via Webhook – Pluga + Leavo
1. Visão Geral
A Pluga é uma plataforma iPaaS (Integration Platform as a Service) brasileira que conecta ferramentas web sem código. A integração com o Leavo permite criar automações simples e rápidas entre o sistema de qualificação de leads e 150+ ferramentas.
Casos de uso principais:
- Enviar leads do Leavo para ferramentas sem integração nativa
- Capturar leads de ferramentas diversas e qualificar no Leavo
- Criar automações no-code rápidas e simples
- Conectar Leavo a ferramentas brasileiras
Fluxos disponíveis:
- ✅ Pluga → Leavo: Pluga Webhooks envia dados
- ✅ Leavo → Pluga: Pluga Webhooks recebe dados
Diferencial: 100% no-code, plataforma brasileira, foco em simplicidade, ideal para não-técnicos.
2. Documentação Oficial
Pluga:
Leavo:
3. Recursos disponíveis via Webhook
3.1 Como Pluga Webhooks funciona
A Pluga oferece webhooks bidirecionais:
| Funcionalidade | Suporte | Detalhes |
|---|---|---|
| Recebe webhooks | ✅ Sim | Pluga gera URL única |
| Envia webhooks | ✅ Sim | Pluga envia para URL externa |
| Formato | JSON | Preferencial (também aceita form-urlencoded) |
| Método | POST | Apenas POST |
| Arrays | ❌ Não | NÃO suporta arrays - apenas strings |
⚠️ LIMITAÇÃO CRÍTICA: Pluga Webhooks NÃO suporta arrays (listas). Apenas variáveis tipo string.
4. Como configurar webhooks
4.1 FLUXO 1: Leavo → Pluga (Enviar Leads)
Permite que o Leavo envie leads qualificados para outras ferramentas via Pluga.
Passo 1: Criar Automação na Pluga
- Acesse https://pluga.co
- Clique em "Criar Automação"
- Ferramenta de origem: Selecione "Pluga Webhooks"
- Gatilho: "Notificação recebida"
Passo 2: Configurar Webhook de Origem
2.1 Na Pluga:
- A Pluga gera automaticamente uma URL exclusiva:
https://webhooks.pluga.co/v2/webhooks/abc12345-6789-0def-ghij-klm123456789
⚠️ Copie esta URL - será configurada no Leavo.
2.2 Definir Schema (Estrutura JSON):
A Pluga precisa conhecer a estrutura dos dados. Cole um exemplo de JSON:
{
"nome": "João Silva",
"email": "joao@example.com",
"telefone": "5511999999999",
"empresa": "Empresa ABC",
"status": "Qualificado"
}
Passo 3: Configurar Webhook de Saída no Leavo
- No Leavo, vá em Webhooks → Saída
- Clique em "+ Criar Webhook"
Configurar:
| Campo | Valor |
|---|---|
| Nome | Enviar para Pluga - Automações |
| URL | https://webhooks.pluga.co/v2/webhooks/[UUID] |
| Método | POST |
| Trigger | Lead criado OU Status alterado |
| Filtro | Status = Qualificado |
Mapeamento Visual:
Campos para enviar:
- ✅ Nome →
nome - ✅ Email →
email - ✅ Telefone →
telefone - ✅ Empresa →
empresa - ✅ Status →
status
⚠️ Importante: Use nomes simples (minúsculas, sem espaços)
Passo 4: Configurar Ação de Destino na Pluga
4.1 Escolher ferramenta de destino:
Exemplos:
- Google Sheets (Adicionar linha)
- Gmail (Enviar email)
- Slack (Enviar mensagem)
- Mailchimp (Adicionar contato)
4.2 Mapear campos:
Para Google Sheets:
- Coluna A:
{{nome}} - Coluna B:
{{email}} - Coluna C:
{{telefone}}
4.3 Ativar automação:
- Clique em "Ativar"
- Automação fica ativa
4.2 FLUXO 2: Pluga → Leavo (Capturar Leads)
Permite que ferramentas diversas enviem leads para qualificação no Leavo via Pluga.
Passo 1: Criar Webhook de Entrada no Leavo
- No Leavo, vá em Webhooks → Entrada
- Clique em "+ Criar Webhook"
Configurar:
- Nome:
Receber de Pluga - Múltiplas Fontes - Descrição:
Recebe leads via Pluga Webhooks - Webhook ativo: LIGADO
Passo 2: Copiar URL do Leavo
https://api.leavo.ai/api/webhooks/x1y2z3a4-b5c6-7890-defg-hi0123456789
Passo 3: Criar Automação na Pluga
3.1 Ferramenta de origem:
Escolha uma ferramenta (exemplos):
- Google Forms (Resposta recebida)
- Typeform (Resposta recebida)
- Mailchimp (Novo inscrito)
- RD Station (Lead convertido)
Passo 4: Configurar Pluga Webhooks como Destino
4.1 Ferramenta de destino:
- Selecione "Pluga Webhooks"
- Ação: "Enviar notificação"
4.2 Configurar URL:
- Cole a URL do Leavo
4.3 Personalizar mensagem:
{
"name": "{{nome_do_campo_origem}}",
"email": "{{email_do_campo_origem}}",
"phone": "{{telefone_do_campo_origem}}",
"company": "{{empresa_do_campo_origem}}"
}
5. Testando a integração
✅ Checklist - Leavo → Pluga
Pluga:
- Automação criada
- Webhook de origem configurado
- URL exclusiva copiada
- Schema JSON definido
- Ferramenta de destino configurada
- Automação ativada
Leavo:
- Webhook de saída criado
- URL da Pluga configurada
- Trigger configurado
✅ Checklist - Pluga → Leavo
Pluga:
- Automação criada
- Ferramenta de origem configurada
- Webhook de destino configurado
- URL do Leavo configurada
- Automação ativada
Leavo:
- Webhook de entrada criado
- URL copiada
- Campos mapeados
6. Estrutura de Payloads
6.1 Leavo → Pluga
{
"nome": "Maria Santos",
"email": "maria@example.com",
"telefone": "5511988887777",
"empresa": "Tech Solutions",
"status": "Qualificado",
"tags": "Hot-Lead, B2B",
"origem": "Google Ads"
}
⚠️ Tags como string: Pluga não aceita arrays, então tags vão como string.
6.2 Pluga → Leavo
{
"name": "Pedro Oliveira",
"email": "pedro@example.com",
"phone": "5511977776666",
"company": "Startup XYZ",
"source": "Google Forms via Pluga"
}
7. Observações e Limitações
7.1 Limitações da Pluga
| Aspecto | Limitação |
|---|---|
| Arrays | ❌ NÃO SUPORTA |
| Tipos de dados | Apenas strings |
| Formato | JSON (preferencial) |
| Método | POST apenas |
| Segurança | URL exclusiva |
7.2 Planos da Pluga
Free:
- 50 execuções/mês
- 2 automações
Starter:
- 1.000 execuções/mês
- 10 automações
Pro:
- 10.000 execuções/mês
- 100 automações
8. Boas Práticas
8.1 Nomear Campos Corretamente
✅ Use nomes simples:
nome ✅
email ✅
telefone ✅
❌ Evite:
Nome Completo ❌ (espaço)
E-mail ❌ (hífen)
Número de Telefone ❌ (espaços)
8.2 Trabalhar com Tags
Como Pluga não aceita arrays:
✅ Envie tags como string:
{
"tags": "Hot-Lead, B2B, Urgente"
}
9. Troubleshooting
9.1 Automação não executa
| Causa | Solução |
|---|---|
| Automação desativada | ✅ Ative toggle na Pluga |
| URL incorreta | ✅ Recopie URL |
| Schema não definido | ✅ Cole JSON de exemplo |
| Limite de execuções | ✅ Verifique plano |
9.2 Campos não mapeiam
| Causa | Solução |
|---|---|
| Nome de campo com espaço | ✅ Use underscore: nome_completo |
| Campo não existe no schema | ✅ Atualize schema JSON |
| Array enviado | ✅ Converta para string |
10. Casos de Uso
10.1 Google Forms → Leavo
Objetivo: Capturar leads de formulário Google
Fluxo:
Google Forms (Nova resposta)
↓
Pluga (Webhook)
↓
Leavo (Qualificar)
10.2 Leavo → Google Sheets
Objetivo: Registrar leads em planilha
Fluxo:
Leavo (Lead Qualificado)
↓
Pluga (Webhook)
↓
Google Sheets (Nova linha)


