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

> O Make é uma plataforma de automação visual que permite criar fluxos complexos com interface drag-and-drop intuitiva.

## Configuração Inicial

### 1. Configurando Webhook no Make

1. **Crie um novo cenário** no Make
2. **Adicione o módulo "Webhooks"**
3. **Selecione "Custom webhook"**
4. **Copie a URL gerada**

### 2. Configurando no PIED

Configure o webhook no PIED com a URL do Make:

```json theme={null}
{
  "event": "{{eventType}}",
  "timestamp": "{{timestamp}}",
  "data": {
    "pedido": {
      "id": "{{id}}",
      "codigo": "{{code}}",
      "nome": "{{name}}",
      "valor_original": {{originalValue}},
      "valor_final": {{finalValue}},
      "status": "{{dealStatus}}",
      "potencia_total": {{totalPower}},
      "data_criacao": "{{budgetCreated}}"
    },
    "empresa": {
      "nome": "{{company.name}}",
      "email": "{{company.email}}",
      "telefone": "{{company.phone}}",
      "cidade": "{{company.city}}",
      "estado": "{{company.state}}"
    },
    "responsavel": {
      "nome": "{{responsible.name}}",
      "email": "{{responsible.email}}"
    }
  }
}
```

## Cenários de Automação

### 1. Fluxo de Qualificação de Leads

**Estrutura Visual:**

```
Webhook → Router → [Valor > 10k] → HubSpot CRM
                 → [Valor < 10k] → Google Sheets
                 → [Todos] → Slack Notification
```

**Configuração:**

1. **Webhook** - Recebe dados do PIED
2. **Router** - Divide o fluxo baseado em condições
3. **Filter (Valor > 10k)** - `{{data.pedido.valor_final}} > 10000`
4. **HubSpot** - Cria contato como lead qualificado
5. **Filter (Valor \< 10k)** - `{{data.pedido.valor_final}} <= 10000`
6. **Google Sheets** - Adiciona à planilha de leads
7. **Slack** - Notifica equipe (sem filtro)

### 2. Workflow de Aprovação Automática

**Estrutura Visual:**

```
Webhook → Filter → [Status=Pendente] → Teams Approval → Update PIED
                 → [Status≠Pendente] → Direct Processing
```

**Módulos:**

* **Webhook** - Recebe pedido
* **Filter** - `{{data.pedido.status}} = "Pendente"`
* **Microsoft Teams** - Envia mensagem de aprovação
* **Delay** - Aguarda resposta (24h)
* **HTTP** - Atualiza status no PIED via API

### 3. Multi-Channel Notification

**Estrutura Visual:**

```
Webhook → Data Store → Parallel Processing:
                     → Slack (Equipe)
                     → Teams (Gerência)  
                     → Email (Cliente)
                     → WhatsApp (Responsável)
```

## Módulos Essenciais

### Webhook Configuration

```json theme={null}
{
  "webhook_name": "PIED Pedidos",
  "method": "POST",
  "response": {
    "status": 200,
    "body": "OK"
  }
}
```

### Router com Filtros

**Filtro por Valor:**

* **Condition:** `{{data.pedido.valor_final}} > 50000`
* **Label:** "Alto Valor"

**Filtro por Estado:**

* **Condition:** `{{data.empresa.estado}} = "SP"`
* **Label:** "São Paulo"

### Data Transformer

```javascript theme={null}
// Transformar dados para formato padronizado
{
  "pedido_id": "{{data.pedido.codigo}}",
  "cliente": "{{data.empresa.nome}}",
  "valor": "{{formatNumber(data.pedido.valor_final; 2; ','; '.')}}",
  "prioridade": "{{if(data.pedido.valor_final > 50000; 'Alta'; 'Normal')}}",
  "data_formatada": "{{formatDate(data.pedido.data_criacao; 'DD/MM/YYYY HH:mm')}}"
}
```

## Integrações Populares

### Slack - Notificações Inteligentes

**Configuração:**

* **Channel:** `#vendas` (normal) ou `#vendas-vip` (alto valor)
* **Message:**

```
🎉 *Novo Pedido {{data.pedido.codigo}}*

*Cliente:* {{data.empresa.nome}}
*Valor:* R$ {{formatNumber(data.pedido.valor_final; 2; ','; '.')}}
*Status:* {{data.pedido.status}}
*Responsável:* {{data.responsavel.nome}}

{{if(data.pedido.valor_final > 50000; '🚨 *ALTO VALOR* - Atenção especial necessária'; '')}}
```

### Google Sheets - Dashboard Automático

**Configuração:**

* **Spreadsheet:** Dashboard Vendas
* **Worksheet:** Pedidos 2024
* **Values:**
  * A: `{{data.pedido.codigo}}`
  * B: `{{data.empresa.nome}}`
  * C: `{{data.pedido.valor_final}}`
  * D: `{{data.pedido.status}}`
  * E: `{{data.responsavel.nome}}`
  * F: `{{formatDate(now; 'DD/MM/YYYY HH:mm')}}`

### HubSpot CRM - Gestão de Leads

**Create/Update Contact:**

```json theme={null}
{
  "email": "{{data.empresa.email}}",
  "firstname": "{{data.empresa.nome}}",
  "phone": "{{data.empresa.telefone}}",
  "city": "{{data.empresa.cidade}}",
  "state": "{{data.empresa.estado}}",
  "pedido_valor": "{{data.pedido.valor_final}}",
  "pedido_codigo": "{{data.pedido.codigo}}",
  "lead_source": "PIED API"
}
```

### Microsoft Teams - Aprovações

**Adaptive Card:**

```json theme={null}
{
  "type": "AdaptiveCard",
  "version": "1.3",
  "body": [
    {
      "type": "TextBlock",
      "text": "Novo Pedido para Aprovação",
      "weight": "Bolder",
      "size": "Medium"
    },
    {
      "type": "FactSet",
      "facts": [
        {
          "title": "Código:",
          "value": "{{data.pedido.codigo}}"
        },
        {
          "title": "Cliente:",
          "value": "{{data.empresa.nome}}"
        },
        {
          "title": "Valor:",
          "value": "R$ {{formatNumber(data.pedido.valor_final; 2; ','; '.')}}"
        }
      ]
    }
  ],
  "actions": [
    {
      "type": "Action.Submit",
      "title": "Aprovar",
      "data": {
        "action": "approve",
        "pedido_id": "{{data.pedido.id}}"
      }
    },
    {
      "type": "Action.Submit",
      "title": "Rejeitar",
      "data": {
        "action": "reject",
        "pedido_id": "{{data.pedido.id}}"
      }
    }
  ]
}
```

## Funções Avançadas

### Aggregator - Relatórios Periódicos

**Configuração:**

1. **Data Store** - Armazena pedidos do dia
2. **Aggregator** - Agrupa por período (diário)
3. **Iterator** - Processa cada grupo
4. **Email** - Envia relatório consolidado

### Error Handling

**Configuração:**

1. **Error Handler** - Captura erros
2. **Slack** - Notifica equipe técnica
3. **Data Store** - Salva para reprocessamento
4. **Email** - Alerta administrador

### Scheduling - Relatórios Automáticos

**Cenário Separado:**

1. **Schedule** - Todo dia às 9h
2. **Data Store** - Busca pedidos do dia anterior
3. **Google Sheets** - Gera relatório
4. **Gmail** - Envia para gerência

## Monitoramento e Analytics

### Execution History

* **Visualização:** Timeline de execuções
* **Filtros:** Por status, data, módulo
* **Detalhes:** Dados de entrada/saída de cada módulo

### Performance Metrics

* **Tempo de execução:** Média por cenário
* **Taxa de sucesso:** % de execuções bem-sucedidas
* **Consumo:** Operations utilizadas

### Alertas Automáticos

```json theme={null}
{
  "trigger": "execution_failed",
  "action": "send_notification",
  "channels": ["slack", "email"],
  "message": "Falha no cenário PIED: {{scenario.name}}"
}
```

## Otimização e Best Practices

### Estrutura de Dados

```javascript theme={null}
// Padronizar estrutura de saída
{
  "success": true,
  "data": {
    "pedido": "{{data.pedido.codigo}}",
    "processado_em": "{{now}}",
    "acoes_executadas": [
      "slack_notification",
      "crm_update",
      "sheet_update"
    ]
  },
  "metadata": {
    "scenario_id": "{{scenario.id}}",
    "execution_id": "{{execution.id}}"
  }
}
```

### Filtros Eficientes

```javascript theme={null}
// Filtro combinado para otimizar execuções
{{and(
  data.pedido.valor_final > 1000,
  data.empresa.estado = "SP",
  data.pedido.status != "Cancelado"
)}}
```

### Retry Logic

**Configuração:**

* **Max attempts:** 3
* **Interval:** 30 segundos
* **Backoff:** Exponencial

## Custos e Limites

### Planos Make

* **Free:** 1.000 operations/mês
* **Core:** 10.000 operations/mês (\$9/mês)
* **Pro:** 40.000 operations/mês (\$16/mês)
* **Teams:** 80.000 operations/mês (\$29/mês)

### Otimização de Operations

* Use filtros para reduzir execuções desnecessárias
* Combine múltiplas ações em um cenário
* Configure schedules adequados
* Monitore consumo regularmente

## Troubleshooting

### Webhook não recebe dados

1. **Verifique a URL** no PIED
2. **Teste manualmente** com Postman
3. **Confira logs** no Make
4. **Valide JSON** do PIED

### Módulos falhando

1. **Verifique credenciais** das integrações
2. **Confirme permissões** das APIs
3. **Teste conexões** individualmente
4. **Analise error logs** detalhados

### Performance lenta

1. **Otimize filtros** para reduzir processamento
2. **Use parallel processing** quando possível
3. **Configure timeouts** adequados
4. **Monitore execution time**

## Próximos Passos

* Explore [outras plataformas](/integrations/introduction) como Zapier e n8n
* Configure [webhooks personalizados](/integrations/custom-webhooks) para necessidades específicas
* Veja exemplos com [Pluga](/integrations/pluga) para comparação