Skip to main content

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:
{
  "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

{
  "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

// 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:
{
  "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:
{
  "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

{
  "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

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

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