Integrações
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:- Acesse seu agente no Super Agentes
- Vá para a aba Ambientes
- Clique em WhatsApp
- Localize a conexão do WhatsApp que deseja configurar
- 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:
- Ative a opção Dividir mensagens longas
- 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:
- 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:
- Ative a opção Intervenção Automática
- 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.
- É 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
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
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
Solução de Problemas
Mensagens Não Estão Sendo Divididas Corretamente
Se as mensagens não estiverem sendo divididas corretamente:- Verifique se a opção Dividir mensagens longas está ativada
- Certifique-se de que o Tamanho máximo por mensagem está configurado com um valor razoável (recomendado: 300)
- 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:- Verifique se a opção “Notificar as enviadas por mim também” está ativada no painel da Z-API
- Certifique-se de que você está usando a versão mais recente da Z-API
- Verifique se os eventos “Send Message” e “Message Upsert” estão selecionados no painel da Evolution
- 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:- Aumente o valor do Tempo de espera (recomendado: 10-15 segundos)
- 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.