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

# Consultas inteligentes ao ERP pelo WhatsApp

> Entenda como os usuários consultam informações do ERP pelo WhatsApp usando as consultas configuradas pela Software House no Plug4ia.

Com o **Plug4ia**, usuários autorizados consultam informações do ERP conversando pelo WhatsApp. Eles podem perguntar em linguagem natural sobre vendas, produtos, contas, compras e outros dados configurados pela Software House.

As respostas dependem das **Tools** cadastradas no Portal Administrativo. Cada Tool possui uma descrição e uma **consulta SQL**, que define quais dados podem ser buscados no ERP.

<Info>
  O Plug4ia não cria consultas automaticamente no ERP. A Software House configura as consultas SQL disponíveis e o assistente usa essas consultas para responder aos usuários.
</Info>

## Categorias de consulta

As categorias disponíveis dependem das Tools configuradas para cada ERP, mas normalmente as consultas são organizadas por área de negócio.

<CardGroup cols={2}>
  <Card title="Vendas" icon="chart-line">
    Faturamento, total por período, ticket médio, produtos mais vendidos, formas de pagamento, horários de pico e vendas por grupo.
  </Card>

  <Card title="Contas a receber" icon="file-invoice-dollar">
    Clientes devedores, títulos vencidos, títulos em aberto, valores pendentes e recebimentos.
  </Card>

  <Card title="Contas a pagar" icon="credit-card">
    Contas a vencer, contas em aberto, pagamentos realizados, fornecedores e atrasos.
  </Card>

  <Card title="Produtos" icon="box">
    Detalhes de produtos, código de barras, estoque disponível, margem e preços.
  </Card>

  <Card title="Compras" icon="cart-shopping">
    Informações de compras e fornecedores, conforme as consultas configuradas para o ERP.
  </Card>
</CardGroup>

## Como uma consulta é escolhida

Quando o usuário envia uma pergunta, o Plug4ia interpreta a intenção da mensagem e compara com as Tools disponíveis para aquele ERP.

<Steps>
  <Step title="O usuário faz uma pergunta">
    O usuário envia uma mensagem pelo WhatsApp.

    ```text theme={null}
    Quais foram as vendas de ontem?
    ```
  </Step>

  <Step title="O Plug4ia identifica o assunto">
    A pergunta é analisada para entender se o usuário quer consultar vendas, produtos, contas, compras ou outro tema configurado.
  </Step>

  <Step title="A Tool correspondente é selecionada">
    O Plug4ia usa a descrição das Tools para escolher a consulta mais adequada.
  </Step>

  <Step title="A consulta SQL é executada">
    A consulta SQL configurada na Tool busca as informações no ambiente integrado da empresa.
  </Step>

  <Step title="A resposta é formatada">
    O resultado é transformado em uma resposta clara e enviado ao usuário pelo WhatsApp.
  </Step>
</Steps>

## Consultas de vendas

As consultas de vendas ajudam o usuário a acompanhar o desempenho comercial da empresa.

| Consulta               | Exemplo de pergunta                            |
| ---------------------- | ---------------------------------------------- |
| Total por período      | "Qual foi o faturamento desta semana?"         |
| Vendas do dia          | "Quanto vendemos hoje?"                        |
| Ticket médio           | "Qual foi o ticket médio de ontem?"            |
| Produtos mais vendidos | "Quais produtos mais venderam no mês?"         |
| Formas de pagamento    | "Como foram as vendas por forma de pagamento?" |
| Horário de pico        | "Qual horário teve mais vendas?"               |
| Vendas por grupo       | "Quanto vendemos por grupo de produto?"        |

**Exemplo de conversa:**

```text theme={null}
Usuário: Quais foram as vendas de ontem?

Plug4ia: Aqui está o resumo de vendas de ontem:

Total faturado: R$ 12.847,50
Número de vendas: 43
Ticket médio: R$ 298,78

Produtos em destaque:
1. Produto A - R$ 2.100,00
2. Produto B - R$ 1.850,00
3. Produto C - R$ 980,00
```

## Consultas de contas a receber

As consultas de contas a receber ajudam o usuário a acompanhar clientes devedores, títulos vencidos e valores em aberto.

| Consulta           | Exemplo de pergunta                              |
| ------------------ | ------------------------------------------------ |
| Clientes devedores | "Quais clientes estão em atraso?"                |
| Títulos vencidos   | "Mostre os títulos vencidos desta semana"        |
| Títulos em aberto  | "Quais contas estão em aberto para o cliente X?" |
| Valores pendentes  | "Quanto temos a receber este mês?"               |
| Último pagamento   | "Quando foi o último pagamento do cliente Y?"    |

**Exemplo de conversa:**

```text theme={null}
Usuário: Quais clientes estão com títulos vencidos?

Plug4ia: Encontrei 3 clientes com títulos vencidos:

1. Cliente A - R$ 3.200,00, vencido há 15 dias
2. Cliente B - R$ 890,00, vencido há 7 dias
3. Cliente C - R$ 4.500,00, vencido há 30 dias

Total em atraso: R$ 8.590,00
```

## Consultas de contas a pagar

As consultas de contas a pagar oferecem visibilidade sobre compromissos financeiros e pagamentos.

| Consulta               | Exemplo de pergunta                                  |
| ---------------------- | ---------------------------------------------------- |
| Títulos a vencer       | "O que vence nos próximos 7 dias?"                   |
| Títulos em aberto      | "Quais contas ainda não foram pagas?"                |
| Títulos quitados       | "Quais pagamentos foram feitos esta semana?"         |
| Fornecedores em atraso | "Quais fornecedores estão com pagamentos atrasados?" |
| Resumo financeiro      | "Quanto temos a pagar este mês?"                     |

**Exemplo de conversa:**

```text theme={null}
Usuário: O que vence nos próximos 7 dias?

Plug4ia: Contas a vencer nos próximos 7 dias:

29/04 - Fornecedor A: R$ 1.200,00
30/04 - Fornecedor B: R$ 3.450,00
02/05 - Fornecedor C: R$ 780,00
04/05 - Fornecedor A: R$ 920,00

Total a pagar: R$ 6.350,00
```

## Consultas de produtos

As consultas de produtos permitem verificar informações do catálogo do ERP.

| Consulta            | Exemplo de pergunta                               |
| ------------------- | ------------------------------------------------- |
| Detalhes do produto | "Me dê as informações do produto Parafuso 3/8"    |
| Código de barras    | "Qual o código de barras do produto X?"           |
| Estoque             | "Quantas unidades do produto Y temos em estoque?" |
| Margem              | "Qual a margem do produto Z?"                     |
| Preço               | "Qual o preço de venda do produto X?"             |

**Exemplo de conversa:**

```text theme={null}
Usuário: Qual o estoque atual do produto Parafuso 3/8?

Plug4ia: Produto: Parafuso 3/8 Polegada
Código: PAR-038
Estoque atual: 1.240 unidades
Estoque mínimo: 500 unidades
Status: Adequado
```

## Consultas de compras

As consultas de compras dependem das informações disponíveis no ERP e das Tools configuradas pela Software House.

| Consulta               | Exemplo de pergunta                           |
| ---------------------- | --------------------------------------------- |
| Compras por período    | "Quanto compramos este mês?"                  |
| Compras por fornecedor | "Quanto compramos do fornecedor X?"           |
| Produtos comprados     | "Quais produtos foram comprados esta semana?" |
| Últimas compras        | "Quais foram as últimas compras registradas?" |

<Note>
  Se a Software House ainda não configurou uma Tool para determinada pergunta, o Plug4ia pode não conseguir responder aquele assunto.
</Note>

## Gráficos pelo WhatsApp

Quando a consulta configurada retorna dados adequados para visualização, o Plug4ia pode responder com gráficos no WhatsApp.

Exemplos de pedidos:

```text theme={null}
Me mostre um gráfico das vendas por dia desta semana
```

```text theme={null}
Gere um gráfico com os 5 produtos mais vendidos do mês
```

```text theme={null}
Quero um gráfico das vendas por forma de pagamento
```

<Tip>
  Para aumentar a chance de receber um gráfico, peça explicitamente a visualização na mensagem, usando termos como "gráfico", "comparativo" ou "por período".
</Tip>

## Boas práticas para configurar consultas

Para que o usuário tenha uma boa experiência no WhatsApp, configure as Tools com nomes e descrições claras.

| Item         | Recomendação                                                  |
| ------------ | ------------------------------------------------------------- |
| Nome         | Use um nome curto e fácil de identificar no portal            |
| Descrição    | Explique exatamente qual pergunta a consulta responde         |
| Consulta SQL | Configure a SQL para retornar somente os dados necessários    |
| Agente       | Selecione a área correta, como vendas, produtos ou financeiro |
| Status       | Ative apenas consultas já validadas                           |

<Warning>
  Revise cada consulta SQL antes de ativar a Tool. A resposta do usuário será baseada nos dados retornados por essa consulta.
</Warning>

## Quando uma consulta pode não responder

Algumas situações podem impedir uma resposta:

* A Tool correspondente não está cadastrada.
* A consulta SQL da Tool não está ativa ou não foi validada.
* O usuário não tem acesso à empresa consultada.
* A empresa está inativa.
* O integrador local da empresa está desconectado.
* A pergunta pede uma informação que não existe no ERP.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Assistente IA" icon="message-circle" href="/features/whatsapp-ai">
    Entenda como o usuário conversa com o Plug4ia pelo WhatsApp.
  </Card>

  <Card title="Agendamentos" icon="calendar-clock" href="/features/schedules">
    Configure consultas recorrentes para envio automático pelo WhatsApp.
  </Card>

  <Card title="Tools" icon="wrench" href="/admin/tools">
    Veja como cadastrar e manter as consultas SQL disponíveis para cada ERP.
  </Card>

  <Card title="Empresas" icon="store" href="/admin/companies">
    Confira como acompanhar o status do integrador de cada cliente.
  </Card>
</CardGroup>