> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pied.com.br/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração com Zapier

> O Zapier permite conectar o PIED com mais de 5.000 aplicativos diferentes, criando automações poderosas sem necessidade de programação.

## 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

```json theme={null}
{
  "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:**

```html theme={null}
<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

<AccordionGroup>
  <Accordion title="Zap não está disparando" icon="exclamation-triangle">
    * Verifique se o webhook está ativo no PIED
    * Confirme se a URL do Zapier está correta
    * Teste com um pedido real, não simulado
  </Accordion>

  <Accordion title="Dados incompletos" icon="database">
    * Verifique o modelo JSON no PIED
    * Confirme se todos os campos estão mapeados
    * Teste com diferentes tipos de pedido
  </Accordion>

  <Accordion title="Erro de formatação" icon="code">
    * Valide o JSON no PIED
    * Verifique se não há campos vazios obrigatórios
    * Use valores padrão para campos opcionais
  </Accordion>
</AccordionGroup>

## 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

* Explore [outras plataformas](/integrations/introduction) como Pluga e n8n
* Configure [webhooks personalizados](/integrations/custom-webhooks) para necessidades específicas
* Veja exemplos com [Make](/integrations/make) para automações visuais