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

# Agendamentos automáticos pelo WhatsApp

> Configure envios automáticos de consultas do ERP pelo WhatsApp no Plug4ia, com frequências únicas, diárias, semanais ou por intervalo.

O **Plug4ia** permite agendar o envio automático de consultas pelo WhatsApp. A Software House pode configurar agendamentos para que usuários recebam relatórios e indicadores sem precisar solicitar manualmente todos os dias.

Os agendamentos usam as consultas disponíveis para o ERP. Por isso, a informação enviada depende das **Tools** e das **consultas SQL** configuradas no Portal Administrativo.

## Tipos de agendamento

<CardGroup cols={2}>
  <Card title="Único" icon="calendar-day">
    Envio pontual em uma data ou horário específico. Útil para lembretes, fechamentos ou consultas programadas.

    **Exemplo:** "Me envie as vendas hoje às 15:30"
  </Card>

  <Card title="Diário" icon="calendar">
    Envio repetido todos os dias no mesmo horário. Ideal para acompanhar indicadores recorrentes.

    **Exemplo:** "Quero receber o total de vendas todo dia às 9h"
  </Card>

  <Card title="Semanal" icon="calendar-week">
    Envio em um dia da semana específico. Indicado para relatórios semanais de acompanhamento.

    **Exemplo:** "Envie o relatório toda segunda às 8h"
  </Card>

  <Card title="Por intervalo" icon="clock">
    Envio recorrente a cada período definido, como 15 minutos, 30 minutos, 1 hora ou mais.

    **Exemplo:** "Me avise a cada 30 minutos sobre as vendas"
  </Card>
</CardGroup>

## Onde gerenciar agendamentos

A Software House pode gerenciar agendamentos pelo Portal Administrativo.

No menu **Usuários**, abra as ações do usuário desejado e selecione **Gerenciar agendamentos**. Nessa tela, é possível criar, editar, ativar, inativar e filtrar agendamentos.

<Info>
  O agendamento é vinculado ao usuário. Isso garante que o envio respeite o WhatsApp cadastrado e as empresas às quais esse usuário tem acesso.
</Info>

## Como criar um agendamento no portal

<Steps>
  <Step title="Acesse o usuário">
    No Portal Administrativo, vá em **Usuários** e localize o usuário que receberá os envios.
  </Step>

  <Step title="Abra os agendamentos">
    No menu de ações do usuário, clique em **Gerenciar agendamentos**.
  </Step>

  <Step title="Clique em Novo agendamento">
    Preencha os dados principais do agendamento.

    | Campo             | Descrição                                                                   |
    | ----------------- | --------------------------------------------------------------------------- |
    | Empresa / ERP     | Empresa que será consultada no envio automático                             |
    | Agente            | Área da consulta, como vendas, produtos, contas a pagar ou contas a receber |
    | Horário           | Horário em que o relatório será enviado                                     |
    | Frequência        | Define se o envio será único, diário, semanal ou por intervalo              |
    | Dia da semana     | Usado quando a frequência for semanal                                       |
    | Ação agendada     | Texto com a consulta que o Plug4ia deve executar                            |
    | Enviar em áudio   | Define se o relatório será enviado como áudio                               |
    | Agendamento ativo | Define se o agendamento começará a executar após salvar                     |
  </Step>

  <Step title="Descreva a ação agendada">
    No campo **Ação agendada**, escreva o que o usuário deve receber.

    Exemplos:

    ```text theme={null}
    Enviar resumo de vendas de ontem
    ```

    ```text theme={null}
    Enviar contas a vencer hoje
    ```

    ```text theme={null}
    Enviar produtos com estoque baixo
    ```
  </Step>

  <Step title="Salve o agendamento">
    Depois de salvar, o agendamento ficará disponível na lista do usuário e será executado conforme a frequência configurada.
  </Step>
</Steps>

## Exemplos de agendamento

| Objetivo                           | Configuração sugerida                                                                            |
| ---------------------------------- | ------------------------------------------------------------------------------------------------ |
| Receber vendas todo dia pela manhã | Frequência diária, horário 08:00, ação "Enviar resumo de vendas de ontem"                        |
| Acompanhar vendas durante o dia    | Frequência por intervalo, a cada 30 minutos, ação "Enviar total de vendas do dia"                |
| Fechamento semanal                 | Frequência semanal, segunda-feira às 08:00, ação "Enviar relatório de vendas da semana anterior" |
| Aviso pontual                      | Frequência única, horário definido, ação "Enviar contas a vencer hoje"                           |

## Criando agendamentos pelo WhatsApp

Além do portal, usuários autorizados também podem solicitar agendamentos diretamente pelo WhatsApp, usando linguagem natural.

Exemplos:

```text theme={null}
Me envie o total de vendas hoje às 18h
```

```text theme={null}
Quero receber as contas a vencer todo dia às 7h30
```

```text theme={null}
Toda segunda-feira às 8h me envie o relatório de vendas da semana anterior
```

```text theme={null}
Me avise a cada 30 minutos com o total de vendas do dia
```

<Tip>
  Para obter melhores resultados, a mensagem deve informar o que enviar e quando enviar.
</Tip>

## Formatos de envio

Cada agendamento pode entregar a resposta em texto ou áudio.

<CardGroup cols={2}>
  <Card title="Texto" icon="message">
    Formato padrão. O usuário recebe a resposta no WhatsApp com valores, listas, tabelas ou resumos.
  </Card>

  <Card title="Áudio" icon="microphone">
    O usuário recebe um resumo narrado como mensagem de voz, quando a opção de áudio estiver habilitada no agendamento.

    Saiba mais em [Áudio](/features/audio).
  </Card>
</CardGroup>

**Exemplo com áudio:**

```text theme={null}
Todo dia às 8h me envie um resumo em áudio das vendas de ontem
```

## Gerenciando agendamentos pelo WhatsApp

O usuário também pode pedir informações sobre os próprios agendamentos pelo WhatsApp.

**Listar agendamentos ativos:**

```text theme={null}
Quais agendamentos eu tenho ativos?
```

**Cancelar um agendamento:**

```text theme={null}
Cancele o agendamento de vendas diário
```

**Cancelar todos os agendamentos:**

```text theme={null}
Cancele todos os meus agendamentos
```

<Note>
  Pelo portal, a Software House tem mais controle sobre os dados do agendamento, como empresa, agente, frequência, status e modo de envio.
</Note>

## Boas práticas

| Prática                               | Por que usar                                      |
| ------------------------------------- | ------------------------------------------------- |
| Use descrições objetivas              | Facilita a interpretação da ação agendada         |
| Escolha a empresa correta             | Garante que o relatório consulte o cliente certo  |
| Valide a Tool antes de agendar        | Evita envios com dados incompletos ou inesperados |
| Use intervalos com critério           | Evita excesso de mensagens para o usuário         |
| Prefira áudio para resumos executivos | Facilita o consumo rápido de indicadores          |

<Warning>
  Agendamentos por intervalo podem gerar muitas mensagens ao longo do dia. Use esse tipo apenas quando o acompanhamento frequente fizer sentido para a operação.
</Warning>

## Quando um agendamento pode falhar

Algumas situações podem impedir o envio correto:

* O usuário está inativo.
* O WhatsApp do usuário não está cadastrado corretamente.
* O usuário não tem acesso à empresa configurada.
* A empresa está inativa.
* O integrador local está desconectado.
* A Tool necessária para a consulta não está configurada ou ativa.
* A consulta SQL não retorna dados para o período solicitado.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Consultas" icon="magnifying-glass" href="/features/queries">
    Entenda como as Tools e consultas SQL definem o que pode ser agendado.
  </Card>

  <Card title="Áudio" icon="microphone" href="/features/audio">
    Veja como funcionam os envios narrados pelo WhatsApp.
  </Card>

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

  <Card title="Empresas" icon="store" href="/admin/companies">
    Acompanhe o status da empresa e do integrador local.
  </Card>
</CardGroup>