Skip to main content

​
Configuração Básica

​
1. Configurando o Webhook no Zapier

  1. Crie um novo Zap no Zapier
  2. Escolha “Webhooks by Zapier” como trigger
  3. Selecione “Catch Hook” como evento
  4. Copie a URL do webhook fornecida pelo Zapier

​
2. Configurando no PIED

  1. Acesse Configurações > API e Webhooks no PIED
  2. Clique em Adicionar e configure:
    • Nome: Zapier - [Nome da Automação]
    • Endpoint: URL copiada do Zapier
    • Gatilho: Selecione o evento desejado

​
3. Modelo JSON para Zapier

{
  "event_type": "{{eventType}}",
  "timestamp": "{{timestamp}}",
  "data": {
    "id": "{{id}}",
    "code": "{{code}}",
    "name": "{{name}}",
    "original_value": "{{originalValue}}",
    "final_value": "{{finalValue}}",
    "status": "{{dealStatus}}",
    "total_power": "{{totalPower}}",
    "created_date": "{{budgetCreated}}",
    "company": {
      "name": "{{company.name}}",
      "email": "{{company.email}}",
      "phone": "{{company.phone}}",
      "city": "{{company.city}}",
      "state": "{{company.state}}"
    },
    "responsible": {
      "name": "{{responsible.name}}",
      "email": "{{responsible.email}}"
    }
  }
}

​
Exemplos de Automações

​
Slack - Notificações de Pedidos

Trigger: Webhook do PIED Action: Send Channel Message (Slack) Configuração da mensagem: 
🎉 *Novo Pedido Criado!*

*Código:* {{data__code}}
*Cliente:* {{data__company__name}}
*Valor:* R$ {{data__final_value}}
*Responsável:* {{data__responsible__name}}
*Status:* {{data__status}}

📍 *Localização:* {{data__company__city}}, {{data__company__state}}

​
Google Sheets - Registro de Pedidos

Trigger: Webhook do PIED Action: Create Spreadsheet Row (Google Sheets) Mapeamento de colunas:
  • A: {{data__code}} (Código)
  • B: {{data__name}} (Nome)
  • C: {{data__company__name}} (Empresa)
  • D: {{data__final_value}} (Valor)
  • E: {{data__status}} (Status)
  • F: {{data__created_date}} (Data)

​
Trello - Gestão de Projetos

Trigger: Webhook do PIED Action: Create Card (Trello) Configuração do card:
  • Nome: Pedido {{data__code}} - {{data__company__name}}
  • Descrição:
**Cliente:** {{data__company__name}}
**Valor:** R$ {{data__final_value}}
**Potência:** {{data__total_power}} kWp
**Responsável:** {{data__responsible__name}}
**Contato:** {{data__company__email}} | {{data__company__phone}}

​
Gmail - Email Automático

Trigger: Webhook do PIED Action: Send Email (Gmail) Configuração do email:
  • Para: {{data__responsible__email}}
  • Assunto: Novo Pedido: {{data__code}} - {{data__company__name}}
  • Corpo:
<h2>Novo Pedido Criado</h2>

<p><strong>Código:</strong> {{data__code}}</p>
<p><strong>Cliente:</strong> {{data__company__name}}</p>
<p><strong>Valor:</strong> R$ {{data__final_value}}</p>
<p><strong>Status:</strong> {{data__status}}</p>

<h3>Dados do Cliente</h3>
<p><strong>Email:</strong> {{data__company__email}}</p>
<p><strong>Telefone:</strong> {{data__company__phone}}</p>
<p><strong>Cidade:</strong> {{data__company__city}}, {{data__company__state}}</p>

<p>Acesse o PIED para mais detalhes.</p>

​
Filtros e Condições

​
Filtro por Valor

Processe apenas pedidos acima de R$ 10.000: 
{{data__final_value}} > 10000

​
Filtro por Estado

Apenas pedidos de São Paulo: 
{{data__company__state}} = "SP"

​
Filtro por Status

Apenas pedidos aprovados: 
{{data__status}} = "Aprovado"

​
Automações Avançadas

​
Multi-Step: CRM + Slack + Email

  1. Webhook PIED → Recebe dados do pedido
  2. Filter → Apenas pedidos > R$ 5.000
  3. HubSpot → Cria/atualiza contato
  4. Slack → Notifica equipe comercial
  5. Gmail → Envia email de boas-vindas

​
Delay + Follow-up

  1. Webhook PIED → Pedido criado
  2. Delay → Aguarda 24 horas
  3. Filter → Verifica se status não mudou
  4. Slack → Alerta para follow-up

​
Testando a Integração

​
1. Teste Manual no Zapier

  • Use a função “Test Trigger” no Zapier
  • Crie um pedido teste no PIED
  • Verifique se os dados chegaram corretamente

​
2. Validação de Dados

Verifique se todos os campos estão sendo mapeados:
  • ✅ Código do pedido
  • ✅ Nome do cliente
  • ✅ Valor final
  • ✅ Status
  • ✅ Dados da empresa

​
3. Logs de Execução

  • Monitore o histórico de execução no Zapier
  • Verifique erros e sucessos
  • Ajuste filtros conforme necessário

​
Solução de Problemas

  • Verifique se o webhook está ativo no PIED
  • Confirme se a URL do Zapier está correta
  • Teste com um pedido real, não simulado
  • Verifique o modelo JSON no PIED
  • Confirme se todos os campos estão mapeados
  • Teste com diferentes tipos de pedido
  • Valide o JSON no PIED
  • Verifique se não há campos vazios obrigatórios
  • Use valores padrão para campos opcionais

​
Limites e Considerações

​
Planos Zapier

  • Free: 100 tarefas/mês, 5 Zaps
  • Starter: 750 tarefas/mês, 20 Zaps
  • Professional: 2.000 tarefas/mês, Zaps ilimitados

​
Performance

  • Webhooks são processados em tempo real
  • Delays podem ser adicionados entre ações
  • Filtros reduzem o consumo de tarefas

​
Segurança

  • Use HTTPS sempre
  • Não exponha dados sensíveis em logs
  • Configure filtros para dados críticos

​
Próximos Passos