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

> A Pluga é uma plataforma brasileira de automação que permite conectar o PIED com mais de 500 ferramentas, incluindo Google Sheets, Teams, Slack, CRMs e muito mais.

## Pré-requisitos

* Conta ativa no PIED com acesso ao módulo de API
* Conta na Pluga (paga)

## Tutorial: Enviando Pedidos Criados para Google Sheets

Este tutorial mostra como capturar informações de pedidos criados no PIED e enviar automaticamente para uma planilha do Google Sheets.

### 1. Configurando a Automação na Pluga

1. Na Pluga, acesse a página principal e selecione **"Criar automatização"**

2. Dê um nome para automação. Neste exemplo será **"Pedido criado"**

3. Selecione a ferramenta **"Pluga Webhooks"** e no campo de gatilho, selecione **"Notificação recebida"**

4. Conecte uma nova conta, iremos nomear neste exemplo de **PIED**

5. Na tela seguinte, você receberá a URL a ser colocada no PIED:

<img src="https://mintcdn.com/pied-3a231858/Yv40P3HvT7ieGLcn/images/pluga/pluga-webhook-url.png?fit=max&auto=format&n=Yv40P3HvT7ieGLcn&q=85&s=42aebd31c4a14fc23b72068b2f1de0b0" alt="URL do Webhook na Pluga" width="948" height="502" data-path="images/pluga/pluga-webhook-url.png" />

<Note>
  **Importante:** Copie esta URL, pois você precisará dela na próxima etapa.
</Note>

### 2. Configurando o Webhook no PIED

6. Acesse sua plataforma do PIED, vá em **"Configurações > API e Webhooks"**

7. Clique em **"Adicionar"** e preencha os campos:
   * **Nome do webhook:** Pedido criado - Pluga
   * **Endpoint:** Cole a URL copiada da Pluga
   * **Gatilho:** Selecione **"Pedido criado"**

<img src="https://mintcdn.com/pied-3a231858/Yv40P3HvT7ieGLcn/images/pluga/pluga-webhook-config.png?fit=max&auto=format&n=Yv40P3HvT7ieGLcn&q=85&s=d514576765b953bc05d82497034ce175" alt="Configuração do Webhook no PIED" width="572" height="568" data-path="images/pluga/pluga-webhook-config.png" />

8. Em **"Modelo de envio do JSON"**, copie o código abaixo e clique em **"Salvar e Continuar"**:

```json theme={null}
{
  "evento": "order.created",
  "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}}"
    },
    "responsavel": {
      "nome": "{{responsible.name}}",
      "email": "{{responsible.email}}"
    }
  }
}
```

### 3. Adicionando Filtros (Opcional)

9. **OPCIONAL:** Caso queira adicionar algum filtro condicional, selecione **"Adicionar filtro condicional"**

   Nesta tela, é possível utilizar os campos do PIED cadastrados na etapa anterior para gerar filtros como:

   * Notificar somente se o pedido for de uma empresa de SC
   * Apenas pedidos acima de R\$ 10.000
   * Somente pedidos de um responsável específico

<img src="https://mintcdn.com/pied-3a231858/Yv40P3HvT7ieGLcn/images/pluga/pluga-filtros.png?fit=max&auto=format&n=Yv40P3HvT7ieGLcn&q=85&s=0d45425b076826ff0e4fde4c58ab704d" alt="Filtros Condicionais" width="876" height="575" data-path="images/pluga/pluga-filtros.png" />

10. Clique em **"Salvar e Continuar"** e a configuração relativa ao PIED estará pronta

### 4. Configurando o Google Sheets

11. Neste tutorial, o Google Sheets será usado como ferramenta de destino, mas os passos são semelhantes para todas as ferramentas:

12. Clique em **"Conectar nova ferramenta"** e selecione o **Google Sheets**

<img src="https://mintcdn.com/pied-3a231858/Yv40P3HvT7ieGLcn/images/pluga/pluga-sheets.png?fit=max&auto=format&n=Yv40P3HvT7ieGLcn&q=85&s=8de3e62266ba3be0f035d7bd6dc7ff79" alt="Seleção do Google Sheets" width="950" height="534" data-path="images/pluga/pluga-sheets.png" />

13. Selecione a conta que será usada e faça login pelo Google. Crie uma planilha nova para ser utilizada

14. Selecione a planilha que receberá os dados:

<img src="https://mintcdn.com/pied-3a231858/Yv40P3HvT7ieGLcn/images/pluga/pluga-sheets-escolhida.png?fit=max&auto=format&n=Yv40P3HvT7ieGLcn&q=85&s=a86b31d88f69485cdbf653a46d21a70d" alt="Seleção da Planilha" width="975" height="539" data-path="images/pluga/pluga-sheets-escolhida.png" />

15. Configure as colunas que deseja salvar na planilha:

<img src="https://mintcdn.com/pied-3a231858/Yv40P3HvT7ieGLcn/images/pluga/pluga-sheets-colunas.png?fit=max&auto=format&n=Yv40P3HvT7ieGLcn&q=85&s=49ac71125ec1c5260f6db38d34a737c8" alt="Configuração das Colunas" width="688" height="709" data-path="images/pluga/pluga-sheets-colunas.png" />

**Sugestão de colunas:**

* **Código do Pedido:** `{{pedido.codigo}}`
* **Nome:** `{{pedido.nome}}`
* **Empresa:** `{{pedido.empresa.nome}}`
* **Valor Final:** `{{pedido.valor_final}}`
* **Status:** `{{pedido.status}}`
* **Data de Criação:** `{{pedido.data_criacao}}`
* **Responsável:** `{{pedido.responsavel.nome}}`

16. Salve a configuração

### 5. Conectando Outras Ferramentas (Opcional)

17. **OPCIONAL:** Caso queira conectar outras ferramentas simultaneamente, selecione **"Adicionar mais ações"** e siga o passo a passo da plataforma:

<img src="https://mintcdn.com/pied-3a231858/Yv40P3HvT7ieGLcn/images/pluga/pluga-multiplas.png?fit=max&auto=format&n=Yv40P3HvT7ieGLcn&q=85&s=af8ae1cc8b88f336eaa484c3f3998adf" alt="Múltiplas Ferramentas" width="1054" height="460" data-path="images/pluga/pluga-multiplas.png" />

**Ferramentas populares para conectar:**

* **Microsoft Teams** - Notificações em canais
* **Slack** - Alertas para a equipe
* **Trello** - Criação automática de cards
* **RD Station** - Atualização de leads

## Testando a Integração

Após configurar tudo:

1. **Ative a automação** na Pluga
2. **Crie um pedido teste** no PIED
3. **Verifique** se os dados apareceram na planilha
4. **Confira os logs** na Pluga em caso de problemas

<Tip>
  **Dica:** Use a função "Testar" na Pluga para simular o recebimento de dados antes de ativar a automação.
</Tip>

## Outras Integrações Populares

### Teams/Slack - Notificações Instantâneas

```json theme={null}
{
  "titulo": "🎉 Novo Pedido Criado!",
  "mensagem": "Pedido {{pedido.codigo}} - {{pedido.nome}} criado por {{pedido.responsavel.nome}}",
  "valor": "R$ {{pedido.valor_final}}",
  "empresa": "{{pedido.empresa.nome}}"
}
```

### CRM - Atualização de Leads

```json theme={null}
{
  "lead_id": "{{pedido.empresa.id}}",
  "status": "pedido_criado",
  "valor_pedido": "{{pedido.valor_final}}",
  "data_pedido": "{{pedido.data_criacao}}"
}
```

## Solução de Problemas

<AccordionGroup>
  <Accordion title="Webhook não está disparando" icon="exclamation-triangle">
    * Verifique se a URL está correta no PIED
    * Confirme se o evento está selecionado corretamente
    * Teste criando um pedido real no PIED
  </Accordion>

  <Accordion title="Dados não aparecem na planilha" icon="table">
    * Verifique se as colunas estão mapeadas corretamente
    * Confirme se a conta do Google tem permissão na planilha
    * Verifique os logs de erro na Pluga
  </Accordion>

  <Accordion title="JSON inválido" icon="code">
    * Verifique se todas as chaves estão entre aspas duplas
    * Confirme se não há vírgulas extras no final
    * Use um validador JSON online para verificar
  </Accordion>
</AccordionGroup>

## Próximos Passos

* Explore outras [integrações disponíveis](/integrations/introduction)
* Configure [webhooks personalizados](/integrations/custom-webhooks) para necessidades específicas
* Veja exemplos com [Zapier](/integrations/zapier) e [n8n](/integrations/n8n)