> For the complete documentation index, see [llms.txt](https://academy.vambe.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.vambe.ai/vambe-ads/vambe-ads-pt-br/assistente-vambe-ads/configuracion-de-alertas-y-reportes-de-performance-por-whatsapp-del-asistente-ia-de-vambe-ads.md).
# Configuração de alertas e relatórios de desempenho por WhatsApp do Assistente de IA do Vambe Ads
O assistente do Vambe Ads agora pode enviar mensagens proativamente pelo WhatsApp: relatórios periódicos com o resumo das suas campanhas e alertas automáticos quando alguma métrica sai da meta. A configuração é feita uma única vez e o sistema funciona de forma autônoma.
***
### Pré-requisitos
Antes de configurar esta funcionalidade, verifique se você tem:
* Acesso ao Vambe Ads com conta ativa e campanhas conectadas.
* Um número de WhatsApp disponível para receber relatórios e alertas.
* Pelo menos um KPI-alvo definido (custo por agendamento, ROAS, etc.).
***
### Configuração do assistente
Acesse a visão do assistente no Vambe e clique no ícone de ajustes ⚙️. Isso abre o painel **Configuração do assistente**.
#### 1. Conectar WhatsApp
Ative o toggle do WhatsApp e insira seu número com código do país, sem o sinal `+`.
> **Exemplo:** `56912345678`
Ao salvar, você receberá uma mensagem de boas-vindas confirmando a conexão.
#### 2. Escolher métricas-alvo (KPI)
Selecione o tipo de métrica que o assistente usará como referência para suas análises, relatórios e alertas:
| Opção | Descrição |
| ----------------- | ---------------------------------------------- |
| **Padrão** | Métricas nativas da Meta e do Google |
| **Vambe** | Métricas de negócio como total de agendamentos |
| **Personalizada** | Uma coluna configurada por você |
#### 3. Definir orçamento mensal
Insira quanto você planeja investir por mês. O painel mostra o gasto real dos últimos 30 dias como referência.
#### 4. Definir meta do KPI
Insira o valor que você quer atingir na sua métrica-alvo (por exemplo, USD 500 por agendamento). O painel também mostra o valor real dos últimos 30 dias como ponto de comparação.
> 💡 Você pode configurar esses valores conversando diretamente com o assistente ou manualmente neste painel. As duas formas ficam salvas no mesmo lugar.
***
### Relatórios agendados
Na seção **Relatórios agendados**, clique em **+ Novo relatório**.
| Campo | Descrição | Opções |
| ---------------------------- | ------------------------------------------------- | ----------------------------- |
| **Nome** | Etiqueta para identificar o relatório | Texto livre |
| **Frequência** | Periodicidade do envio | Diário / Semanal / Mensal |
| **Dia e hora** | Quando é enviado (fuso horário: America/Santiago) | Dia + hora |
| **O que você quer receber?** | Tipo de conteúdo do relatório | Resumo geral ou outras opções |
| **Descrição** | Instrução em linguagem natural para o assistente | Texto livre (opcional) |
> ⚠️ O relatório é enviado para o número de WhatsApp registrado na configuração. Certifique-se de tê-lo conectado antes de programar relatórios.
***
### Alertas de desempenho
Os alertas avisam automaticamente quando algo sai do controle. Existem dois tipos:
#### Variação
É acionado quando uma métrica **muda mais do que um percentual definido** em relação ao período anterior. Útil para detectar pioras graduais.
> **Exemplo:** "Me avise se o custo por agendamento subir 20% nos últimos 7 dias em alguma campanha."
#### Limite
É acionado quando uma métrica **ultrapassa ou fica abaixo de um valor fixo** que você define. Útil para estabelecer limites rígidos de eficiência.
> **Exemplo:** "Me avise se algum conjunto de anúncios ultrapassar USD 600 por agendamento."
#### Campos de configuração
| Campo | Descrição |
| ---------------------------------- | -------------------------------------------------------------------- |
| **Tipo de alerta** | Variação (%) ou Limite (valor absoluto) |
| **Métrica** | O KPI a ser monitorado |
| **Janela (dias)** | Período de avaliação, ex. últimos 7 dias |
| **Direção / Condição** | Quando é acionado: quando sobe, quando desce, maior ou igual a, etc. |
| **Variação mínima / Valor-limite** | O percentual ou valor que dispara o alerta |
| **Nível** | Em que nível é avaliado: Campanha, Conjunto ou Anúncio |
| **Gasto mínimo** (opcional) | Filtra campanhas com pouco gasto para evitar falsos positivos |
### Como isso aparece no WhatsApp?
Quando o assistente gera um relatório, você recebe um **PDF diretamente no chat do WhatsApp** com:
* Título com o gasto total, quantidade de resultados e custo por resultado do período.
* Tabela detalhada por campanha com gasto, agendamentos e status em relação ao KPI.
* Principais insights: anomalias críticas, campanhas para escalar, campanhas para revisar ou pausar, e recomendações de realocação de orçamento.
* Próximo passo sugerido pelo assistente.
As **alertas pontuais** chegam como mensagens de texto indicando a campanha afetada, a variação registrada e o valor atual da métrica.
{% hint style="info" %}
💡 Você pode responder ao assistente diretamente pelo WhatsApp para fazer perguntas de acompanhamento, como "quantos agendamentos tivemos esta semana?" ou "qual campanha teve o melhor ROAS?".
{% endhint %}
### Configurações recomendadas
Estas são algumas combinações de relatórios e alertas que recomendamos de acordo com o tipo de operação. Use-as como ponto de partida e ajuste-as ao seu negócio.
***
#### 🗓 Relatório de início de semana
**Para quem:** Clientes que querem começar a segunda-feira com contexto claro antes de tomar decisões de orçamento.
**Configuração:**
* Frequência: Semanal, segunda-feira às 9:00 AM
* Conteúdo: Resumo geral
* Descrição: *"Resumo da semana anterior. Indica quais campanhas ficaram dentro da meta, quais a superaram e qual é a recomendação de orçamento para esta semana."*
***
#### 📊 Relatório de fechamento do mês
**Para quem:** Clientes que reportam resultados para uma equipe interna ou para um cliente final.
**Configuração:**
* Frequência: Mensal, dia 1 às 8:00 AM
* Conteúdo: Resumo geral
* Descrição: *"Resumo do mês encerrado. Inclui gasto total, total de resultados, custo por resultado médio, comparação com o mês anterior e as 3 campanhas com melhor e pior desempenho."*
***
#### 🚨 Alerta de campanha fora de controle
**Para quem:** Qualquer cliente com uma meta de custo por resultado definida. Evita que uma campanha ineficiente consuma orçamento sem que ninguém perceba.
**Configuração:**
* Tipo: Limite
* Métrica: Custo por agendamento (ou seu KPI-alvo)
* Condição: Maior ou igual a `[valor objetivo × 1.5]`
* Janela: 7 dias
* Nível: Campanha
* Gasto mínimo: USD 100 (para ignorar campanhas com gasto muito baixo)
> ⚠️ Se sua meta é USD 500 por agendamento, coloque o limite em USD 750. Assim o alerta é acionado apenas quando há um desvio real, não por flutuações normais do dia a dia.
***
#### 📉 Alerta de queda de volume
**Para quem:** Clientes em que a quantidade de resultados importa tanto quanto o custo. Detecta quando uma campanha que vinha funcionando é interrompida de repente.
**Configuração:**
* Tipo: Variação
* Métrica: Custo por agendamento (ou seu KPI-alvo)
* Direção: Quando sobe
* Variação mínima: 50%
* Janela: 7 dias
* Nível: Conjunto de anúncios
***
#### 🌙 Relatório de sexta-feira para o fim de semana
**Para quem:** Clientes que não querem revisar o painel durante o fim de semana, mas querem saber se há algo urgente para atender na segunda-feira.
**Configuração:**
* Frequência: Semanal, sexta-feira às 6:00 PM
* Conteúdo: Resumo geral
* Descrição: *"Resumo rápido do desempenho desta semana. Destaque apenas se houver alguma campanha crítica que exija ação urgente na segunda-feira. Se tudo estiver dentro da meta, confirme em uma linha."*
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://academy.vambe.ai/vambe-ads/vambe-ads-pt-br/assistente-vambe-ads/configuracion-de-alertas-y-reportes-de-performance-por-whatsapp-del-asistente-ia-de-vambe-ads.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.