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

# Configurações do WhatsApp

> Guia completo para configurar e otimizar a integração do WhatsApp com seu agente, incluindo divisão de mensagens, tempo de espera e intervenção automática

# Configurações Avançadas do WhatsApp no Super Agentes

Este guia explica as configurações avançadas disponíveis para otimizar a integração do WhatsApp com seu agente no Super Agentes, permitindo uma experiência de conversação mais natural e eficiente.

## Acessando as Configurações do WhatsApp

Para acessar as configurações avançadas do WhatsApp:

1. Acesse seu agente no Super Agentes
2. Vá para a aba **Ambientes**
3. Clique em **WhatsApp**
4. Localize a conexão do WhatsApp que deseja configurar
5. Clique no ícone de **Configurações** (engrenagem)

## Configurações Disponíveis

### Divisão de Mensagens Longas

A divisão de mensagens permite que respostas longas sejam automaticamente divididas em mensagens menores, criando uma experiência de conversação mais natural no WhatsApp.

#### Como Configurar:

1. Ative a opção **Dividir mensagens longas**
2. Se ativada, você poderá definir o **Tamanho máximo por mensagem**

#### Opções:

* **Dividir mensagens longas**: Quando ativada, divide automaticamente mensagens longas em partes menores
* **Tamanho máximo por mensagem**: Define o número máximo de caracteres por mensagem (entre 100 e 1000)

#### Recomendações:

* **Valor recomendado**: 300 caracteres
* **Valores menores** (100-200): Melhoram a naturalidade da conversa, criando um fluxo mais dinâmico
* **Valores maiores** (400-1000): Reduzem o número total de mensagens enviadas, mas podem parecer menos naturais

### Tempo de Espera (Acúmulo de Mensagens)

O tempo de espera define quanto tempo o agente aguarda por mensagens consecutivas do usuário antes de responder, evitando interrupções quando o usuário está digitando várias mensagens em sequência.

#### Como Configurar:

1. Defina o valor desejado no campo **Tempo de espera**

#### Opções:

* **Tempo de espera**: Tempo em segundos (0-30) que o agente aguarda por mensagens consecutivas

#### Recomendações:

* **Valor recomendado**: 10 segundos
* **Valores menores** (0-5): Respostas mais rápidas, mas podem interromper o usuário
* **Valores maiores** (15-30): Maior chance de acumular todas as mensagens do usuário, mas com tempo de resposta mais lento

### Intervenção Automática

A intervenção automática permite que o atendimento humano seja ativado automaticamente quando o cliente recebe uma resposta diretamente pelo WhatsApp, fazendo com que a IA pare temporariamente de responder.

> **Nota**: Esta funcionalidade está disponível apenas para integrações via Z-API e Evolution API (não disponível para API Oficial).

#### Como Configurar:

1. Ative a opção **Intervenção Automática**
2. Se ativada, defina o **Tempo para reativar a IA**

#### Opções:

* **Intervenção Automática**: Quando ativada, a IA para de responder automaticamente se detectar uma intervenção humana
* **Tempo para reativar a IA**: Após quanto tempo (em horas, de 1 a 168) a IA deve voltar a responder automaticamente

#### Configurações Adicionais por Tipo de Integração:

**Para Z-API:**

* É necessário marcar a opção "Notificar as enviadas por mim também" no painel da Z-API para o funcionamento correto da intervenção automática.

**Para Evolution API:**

* É necessário selecionar os eventos "Send Message" e "Message Upsert" no painel da Evolution para o funcionamento correto da intervenção automática.

#### Recomendações:

* **Valor recomendado para reativação**: 24 horas
* **Valores menores** (1-12): Útil para equipes que trabalham em turnos e precisam que a IA retome rapidamente
* **Valores maiores** (48-168): Ideal para casos onde o atendimento humano deve ser mantido por mais tempo

## Casos de Uso e Exemplos

### Otimizando para Atendimento ao Cliente

Para um agente focado em atendimento ao cliente:

* **Dividir mensagens longas**: Ativado
* **Tamanho máximo por mensagem**: 200 caracteres
* **Tempo de espera**: 8 segundos
* **Intervenção Automática**: Ativada
* **Tempo para reativar a IA**: 24 horas

Esta configuração cria uma experiência de conversa mais natural, dá tempo suficiente para o cliente enviar várias mensagens consecutivas, e permite que um atendente humano assuma a conversa quando necessário, com a IA retomando automaticamente após 24 horas.

### Otimizando para Vendas

Para um agente focado em vendas:

* **Dividir mensagens longas**: Ativado
* **Tamanho máximo por mensagem**: 150 caracteres
* **Tempo de espera**: 5 segundos
* **Intervenção Automática**: Ativada
* **Tempo para reativar a IA**: 48 horas

Esta configuração cria uma experiência muito dinâmica e conversacional, com respostas rápidas, e permite que um vendedor humano assuma a conversa por um período mais longo quando necessário.

### Otimizando para FAQ e Informações

Para um agente focado em fornecer informações e responder perguntas frequentes:

* **Dividir mensagens longas**: Ativado
* **Tamanho máximo por mensagem**: 400 caracteres
* **Tempo de espera**: 3 segundos
* **Intervenção Automática**: Desativada

Esta configuração permite mensagens um pouco mais longas para fornecer informações completas, com respostas rápidas, sem necessidade de intervenção humana.

## Solução de Problemas

### Mensagens Não Estão Sendo Divididas Corretamente

Se as mensagens não estiverem sendo divididas corretamente:

1. Verifique se a opção **Dividir mensagens longas** está ativada
2. Certifique-se de que o **Tamanho máximo por mensagem** está configurado com um valor razoável (recomendado: 300)
3. Lembre-se que a divisão ocorre preferencialmente em pontos naturais como finais de frases

### Intervenção Automática Não Está Funcionando

Se a intervenção automática não estiver funcionando corretamente:

**Para Z-API:**

1. Verifique se a opção "Notificar as enviadas por mim também" está ativada no painel da Z-API
2. Certifique-se de que você está usando a versão mais recente da Z-API

**Para Evolution API:**

1. Verifique se os eventos "Send Message" e "Message Upsert" estão selecionados no painel da Evolution
2. Certifique-se de que você está usando a versão suportada da Evolution API (até 1.8.2)

### Agente Responde Antes do Usuário Terminar de Digitar

Se o agente estiver respondendo antes do usuário terminar de enviar todas as mensagens:

1. Aumente o valor do **Tempo de espera** (recomendado: 10-15 segundos)
2. Lembre-se que este tempo começa a contar a partir da última mensagem recebida

## Perguntas Frequentes

**P: As configurações de divisão de mensagens funcionam em todas as integrações do WhatsApp?**\
R: Sim, a divisão de mensagens funciona em todas as integrações: API Oficial, Z-API, Evolution API e Evolution QR.

**P: Posso desativar completamente a divisão de mensagens?**\
R: Sim, basta desmarcar a opção "Dividir mensagens longas". Neste caso, as mensagens serão enviadas inteiras, independentemente do tamanho.

**P: O que acontece se eu definir um tempo de espera muito alto?**\
R: Um tempo de espera muito alto (ex: 30 segundos) fará com que o agente demore mais para responder, aguardando esse período após a última mensagem do usuário. Isso pode ser percebido como lentidão pelo usuário.

**P: A intervenção automática funciona com a API Oficial do WhatsApp?**\
R: Não, a intervenção automática está disponível apenas para integrações via Z-API e Evolution API.

**P: O que acontece quando a intervenção automática é ativada?**\
R: Quando o sistema detecta que uma mensagem foi enviada diretamente pelo WhatsApp (não pelo agente), a IA para de responder automaticamente, permitindo que o atendimento humano continue sem interferência.

**P: Como a IA sabe quando deve voltar a responder após uma intervenção?**\
R: A IA voltará a responder automaticamente após o período definido no "Tempo para reativar a IA", contado a partir da última mensagem enviada pelo atendente humano.
