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

# Assistente de IA via WhatsApp

> Use o Plug4ia para consultar informações do ERP pelo WhatsApp, enviar perguntas por texto ou áudio e receber respostas de forma simples.

O **Plug4ia** transforma o WhatsApp em um canal de consulta inteligente para os dados do ERP. Usuários autorizados podem enviar perguntas em linguagem natural e receber respostas sobre vendas, produtos, contas, compras e outros indicadores configurados pela Software House.

A experiência foi pensada para o uso diário: o usuário não precisa abrir o ERP, montar relatórios manualmente ou saber onde a informação está no sistema. Basta perguntar pelo WhatsApp.

## Como funciona

<Steps>
  <Step title="O usuário envia uma mensagem">
    O usuário envia uma pergunta pelo WhatsApp, em texto ou áudio.

    Exemplo:

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

  <Step title="O Plug4ia identifica o usuário">
    O sistema verifica se o número de WhatsApp está cadastrado e ativo.

    Se o número não estiver autorizado, a mensagem não será processada.
  </Step>

  <Step title="O Plug4ia entende a pergunta">
    A inteligência artificial interpreta a intenção da mensagem e identifica qual tipo de informação o usuário está solicitando.
  </Step>

  <Step title="A consulta correta é usada">
    Com base nas consultas SQL configuradas pela Software House, o Plug4ia busca os dados disponíveis para a empresa à qual o usuário tem acesso.
  </Step>

  <Step title="A resposta é enviada pelo WhatsApp">
    O usuário recebe a resposta diretamente na conversa, em formato simples de entender.

    Dependendo da configuração e do tipo de pergunta, a resposta pode conter texto, lista, resumo, tabela ou gráfico.
  </Step>
</Steps>

## O que o usuário pode perguntar

As respostas dependem das consultas SQL configuradas para cada ERP, mas o Plug4ia pode ser usado para diferentes áreas da operação.

<AccordionGroup>
  <Accordion title="Vendas" icon="chart-line">
    Consulte faturamento por período, vendas do dia, ticket médio, produtos mais vendidos, formas de pagamento, horários de pico e outros indicadores comerciais.
  </Accordion>

  <Accordion title="Produtos" icon="box">
    Consulte informações de produtos, estoque disponível, preços, margens, códigos de barras e detalhes cadastrados no ERP.
  </Accordion>

  <Accordion title="Contas a receber" icon="file-invoice-dollar">
    Consulte títulos em aberto, títulos vencidos, clientes devedores, valores pendentes e informações de recebimentos.
  </Accordion>

  <Accordion title="Contas a pagar" icon="credit-card">
    Consulte contas a vencer, contas em atraso, pagamentos realizados, fornecedores e resumos financeiros.
  </Accordion>

  <Accordion title="Compras" icon="cart-shopping">
    Consulte informações relacionadas a compras e fornecedores, conforme as consultas configuradas para o ERP.
  </Accordion>

  <Accordion title="Agendamentos" icon="calendar">
    Crie, consulte, altere ou cancele relatórios automáticos enviados pelo WhatsApp. Saiba mais em [Agendamentos](/features/schedules).
  </Accordion>
</AccordionGroup>

## Exemplos de perguntas

```text theme={null}
Quanto vendemos hoje?
```

```text theme={null}
Quais produtos mais venderam esta semana?
```

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

```text theme={null}
Tenho contas a pagar hoje?
```

```text theme={null}
Como está o estoque do produto 123?
```

```text theme={null}
Me envie o resumo de vendas todos os dias às 8h.
```

<Tip>
  O usuário pode escrever como falaria normalmente. O Plug4ia interpreta a intenção da pergunta e usa as consultas disponíveis para responder.
</Tip>

## Mensagens de voz

O usuário também pode enviar áudio pelo WhatsApp. O Plug4ia interpreta a mensagem de voz e trata a solicitação como uma pergunta comum.

Exemplo:

```text theme={null}
"Quais foram as vendas de ontem?"
```

Esse recurso é útil para usuários que estão em atendimento, no estoque, em deslocamento ou em qualquer situação em que seja mais rápido falar do que digitar.

<Tip>
  Mensagens de voz também podem ser usadas para solicitar agendamentos, como: **"Me mande o faturamento todo dia às nove da manhã."**
</Tip>

## Respostas em áudio

Além de receber respostas em texto, o usuário pode receber determinados relatórios em áudio quando essa opção estiver configurada.

Isso é especialmente útil para resumos executivos, acompanhamentos diários e consultas rápidas pelo celular.

## Controle de acesso

O Plug4ia respeita as permissões configuradas no Portal Administrativo.

| Controle               | Como funciona                                                          |
| ---------------------- | ---------------------------------------------------------------------- |
| Usuário cadastrado     | Apenas usuários ativos podem usar o assistente                         |
| WhatsApp autorizado    | O número do usuário deve estar cadastrado corretamente                 |
| Acesso por empresa     | O usuário só consulta empresas liberadas para ele                      |
| Consultas configuradas | O assistente só responde com base nas consultas disponíveis para o ERP |

<Warning>
  Antes do primeiro uso, confirme se o usuário está ativo, com WhatsApp cadastrado e com acesso à empresa correta.
</Warning>

## Quando o Plug4ia não responde

O Plug4ia foi criado para responder perguntas relacionadas aos dados do ERP. Perguntas fora desse contexto podem ser recusadas.

Exemplos de situações que podem não gerar resposta:

* Perguntas sobre assuntos que não fazem parte do ERP.
* Solicitações de empresas às quais o usuário não tem acesso.
* Perguntas que dependem de uma consulta ainda não configurada.
* Mensagens enviadas por números não cadastrados.
* Consultas para empresas com integrador desconectado.

<Note>
  Se uma pergunta esperada não for respondida, verifique se a consulta correspondente está configurada e ativa em **Tools**.
</Note>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Consultas disponíveis" icon="magnifying-glass" href="/features/queries">
    Entenda como as consultas configuradas definem o que o Plug4ia pode responder.
  </Card>

  <Card title="Agendamentos" icon="calendar-clock" href="/features/schedules">
    Configure relatórios automáticos para envio recorrente pelo WhatsApp.
  </Card>

  <Card title="Áudio" icon="microphone" href="/features/audio">
    Veja como usar mensagens de voz e respostas narradas.
  </Card>

  <Card title="Usuários" icon="users" href="/admin/users">
    Gerencie usuários, WhatsApp autorizado e permissões por empresa.
  </Card>
</CardGroup>