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

> [card] Único
>
> 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] Diário
>
> 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] Semanal
>
> 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] Por intervalo
>
> 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"

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

> [!NOTE]
>
> 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.

## Como criar um agendamento no portal

**1. Acesse o usuário**

No Portal Administrativo, vá em **Usuários** e localize o usuário que receberá os envios.

**2. Abra os agendamentos**

No menu de ações do usuário, clique em **Gerenciar agendamentos**.

**3. 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 |

**4. 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
```

**5. Salve o agendamento**

Depois de salvar, o agendamento ficará disponível na lista do usuário e será executado conforme a frequência configurada.

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

## Formatos de envio

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

> [card] Texto
>
> Formato padrão. O usuário recebe a resposta no WhatsApp com valores, listas, tabelas ou resumos.

> [card] Áudio
>
> 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](https://docs.plug4ia.com/features/audio.md).

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

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

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

> [card] [Consultas](https://docs.plug4ia.com/features/queries.md)
>
> Entenda como as Tools e consultas SQL definem o que pode ser agendado.

> [card] [Áudio](https://docs.plug4ia.com/features/audio.md)
>
> Veja como funcionam os envios narrados pelo WhatsApp.

> [card] [Usuários](https://docs.plug4ia.com/admin/users.md)
>
> Configure usuários, WhatsApp autorizado e permissões por empresa.

> [card] [Empresas](https://docs.plug4ia.com/admin/companies.md)
>
> Acompanhe o status da empresa e do integrador local.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.