1️⃣ Permissão de notificações

• Objetivo: permitir que o app de resposta automática exiba suas próprias notificações (por exemplo, quando a resposta automática está ativa ou quando há novos pedidos).
  
  

• Por que é necessário? Sem essa permissão, você não verá os alertas do app. Ajuda a acompanhar a atividade em tempo real.
  
  

• Como ativar? Na primeira execução, o app pedirá permissão. Você também pode ativar em: Configurações > Notificações > Permitir notificações do app.
  
  

2️⃣ Permissão de bateria

• Objetivo: evitar que o sistema encerre o app em segundo plano.
  
  

• Por que é necessário? Se o sistema encerrar o app, as respostas automáticas não funcionarão continuamente.
  
  

• Como ativar? Toque no ícone piscante na parte superior da tela. Ou vá para Configurações > Bateria > Otimização de bateria, selecione o app e defina como Não otimizar ou Sempre permitir.
  
  

3️⃣ Permissão de leitura de notificações

• Objetivo: permite que o app leia o conteúdo das notificações de outros apps (como WhatsApp ou Telegram).
  
  

• Por que é necessário? O app precisa ler as mensagens para gerar a resposta correta. Sem essa permissão, ele detectará a notificação, mas não conseguirá ler ou responder.
  
  

• Como ativar? Ao ativar a resposta automática, o app pedirá acesso às notificações. Você também pode ir em: Configurações > Apps > Acesso especial > Acesso a notificações e ativar para o app.
  
  

⚠️ Nota importante: todas as três permissões devem estar ativas para o app funcionar corretamente.

Aplicativos suportados
Vá para a seção de aplicativos dentro do app.
Selecione os aplicativos permitidos para resposta automática.
Certifique-se de que as notificações estão ativadas para cada aplicativo:
Sem permissão de notificação, o app não pode ler nem responder mensagens.
Depois de confirmado, a resposta automática funcionará apenas nos aplicativos selecionados.

⚠️ Notas importantes

• Se a permissão de notificação não for concedida a um aplicativo da lista, a resposta automática não funcionará nesse app.
  
  

• Não é possível adicionar novos aplicativos fora da lista predefinida.
  
  

• Você pode ativar ou desativar qualquer aplicativo da lista conforme desejar, mas a permissão de notificação é essencial.
  
  

💡 Dica para usuários: Comece ativando o WhatsApp e o SMS para confirmar que a resposta automática funciona, depois teste os outros aplicativos um por um.

As configurações de interação permitem controlar totalmente como o Auto Reply funciona – do estilo de resposta até os horários.

📝 1. Estilo de resposta

• Resposta padrão
  
  

• Respostas profissionais
  
  

• Respostas aleatórias
  
  

• Menus interativos
  
  

• Respostas com IA
  
  

👥 2. Opções de público-alvo

• Responder a todos
  
  

• Responder apenas a contatos selecionados
  
  

• Bloquear respostas para contatos específicos
  
  

• Responder em grupos ou desativar
  
  

🔢 3. Número de respostas por usuário

• Definir limite máximo por usuário
  
  

• Valor (0) = ilimitado
  
  

📩 4. Mensagem de limite diário

• Enviada quando o usuário atingir o limite diário
  
  

• Em branco = nenhuma mensagem enviada
  
  

⏳ 5. Atraso na resposta

• Opção 1: responder imediatamente → pausar → retomar
  
  

• Opção 2: atrasar até 99 segundos antes do envio
  
  

📱 6. Resposta com tela bloqueada

• Responder apenas com a tela bloqueada
  
  

🙌 7. Mensagem de boas-vindas

• Mensagem única no primeiro contato
  
  

• Mensagem aleatória da lista reserva
  
  

• Opções de repetição:
  
  

  • Uma vez por usuário
    
    

  • Uma vez por dia (na primeira mensagem)
    
    

  • Desativada
    
    

📝 8. Cabeçalho e rodapé da mensagem

• Texto fixo no início/fim de cada mensagem
  
  

🔔 9. Notificações

• Notificação em cada resposta enviada (on/off)
  
  

• Notificação de erro (on/off)
  
  

🕒 10. Horários de resposta

• Sempre ativo
  
  

• Definir horários por dia da semana
  
  

⚠️ Nota:
O uso inteligente dessas configurações torna as respostas mais profissionais e flexíveis.

Respostas profissionais são o núcleo do sistema e permitem criar regras avançadas para lidar com mensagens dos usuários de forma flexível e inteligente.

📌 Adicionar nova regra

1. Palavras-chave
   Você pode inserir uma ou mais palavras-chave que ativam a regra quando aparecem na mensagem do usuário.
   Para várias palavras, separe-as com //.
   Exemplo:
   "reserva // compra // consulta"
   Se o usuário enviar qualquer uma dessas palavras, a regra será aplicada.
   
   

2. Tipo de correspondência
   
   

• Todas as mensagens: aplica-se a todas as mensagens recebidas, sem necessidade de palavras-chave.
  Exemplo: qualquer mensagem recebe uma saudação padrão.
  
  

• Correspondência exata: a mensagem deve ser idêntica à palavra-chave.
  Exemplo: "reserva" → se o usuário digitar apenas "reserva".
  
  

• Contém palavra: aplica-se se a mensagem contiver a palavra-chave.
  Exemplo: "reserva" → "Quero uma reserva", "Posso reservar agora?".
  
  

• Termina com palavra: aplica-se se a mensagem terminar com a palavra-chave.
  Exemplo: "agora" → "Reservo agora".
  
  

• Detecção de idioma: o app detecta o idioma e aplica a regra se corresponder ao código ISO 639-1.
  Exemplo:
  "ar" → mensagens em árabe
  "en" → mensagens em inglês
  
  

• Correspondência inteligente (coringas):
  * → qualquer número de caracteres
  ? → um caractere
  // → separa várias opções
  Exemplo:
  Padrão: reserva* → "reserva", "reserva viagem"
  Padrão: ?compra → "acompra", "bcompra"
  
  

• Mais de X caracteres: regra aplicada se a mensagem for longa.
  Exemplo: >100 caracteres.
  
  

• Menos de X caracteres: regra aplicada se a mensagem for curta.
  Exemplo: <5 caracteres → "ok", "sim".
  
  

• Apenas números: aplica-se se a mensagem contiver apenas dígitos.
  Exemplo: "123456".
  
  

• Pergunta (contém ?): aplica-se se a mensagem tiver ponto de interrogação.
  Exemplo: "Vocês entregam?".
  
  

• Expressões regulares (Regex): controle avançado.
  
  

  • ^\d{10}$ → número de 10 dígitos (telefone).
    
    

  • ^[A-Za-z]+$ → apenas letras (sem números).
    
    

  • .*reserva.* → qualquer mensagem contendo "reserva".
    
    

  • \b(?:compra|pedido)\b → mensagem com "compra" ou "pedido".
    
    

3. Modo de resposta
   
   

• Enviar resposta fixa
  
  

• Enviar todas as respostas cadastradas
  
  

• Enviar resposta aleatória
  
  

• Não responder
  
  

• Escolher resposta de backup aleatória
  
  

• Ativar menus interativos
  
  

• Resposta com IA (com instruções personalizadas, ex: "Responda de forma curta e amigável")
  
  

• Enviar mensagem de boas-vindas
  
  

• Registrar pedido do cliente (nome, endereço, telefone etc.)
  
  

• Encaminhar para humano (volta ao automático após tempo definido)
  
  

4. Lista de respostas
   Permite adicionar várias respostas e usá-las conforme o modo de resposta.
   
   

5. Configurações adicionais
   
   

• Parar outras regras após correspondência
  
  

• Atrasar envio da resposta (segundos/minutos)
  
  

• Bloquear envio repetido para o mesmo usuário (minutos/horas/dias)
  
  

• Definir horário de funcionamento (ex: 9h às 17h)
  
  

6. Personalizar por aplicativo
   Você pode aplicar a regra somente em apps específicos.
   Exemplo:
   
   

• Regra apenas para WhatsApp
  
  

• Regra separada para Telegram
  
  

📌 Sub-regras
As sub-regras são uma extensão das regras principais.
Uma sub-regra não funciona de forma independente; só é ativada após a execução de uma regra principal.
Quando uma regra principal é ativada, as novas mensagens recebidas são verificadas primeiro em relação às sub-regras associadas.

• Se houver correspondência → a resposta da sub-regra é enviada.
  
  

• Se não houver correspondência → as sub-regras são desativadas e o sistema volta a verificar as outras regras principais.
  
  

📝 Exemplo prático:

• Regra principal: Se o usuário escrever "Pedido" → resposta: "Qual produto você deseja comprar?"
  
  

• Sub-regras:
  
  

  • Se o usuário escrever "Livro" → resposta: "Um pedido de livro foi registrado."
    
    

  • Se o usuário escrever "Caneta" → resposta: "Um pedido de caneta foi registrado."

⚙️ Configurações gerais das respostas profissionais

• Tempo para encaminhar a um humano
  
  

• Ação em caso de falha (ignorar / IA / resposta de backup aleatória)
  
  

⚙️ Exemplo prático
📌 Nova regra:

• Palavras-chave: reserva // agendamento
  
  

• Tipo de correspondência: contém palavra
  
  

• Modo de resposta: IA
  
  

• Instrução IA: "Responda como um atendente da empresa Aldhobhani, em linguagem formal."
  
  

• App-alvo: apenas WhatsApp
  
  

• Lista de respostas: vazia (IA gera a resposta)
  
  

• Configuração extra: bloquear respostas repetidas ao mesmo usuário por 10 minutos

Formulários de solicitação são um recurso avançado que ajuda a coletar dados e pedidos de clientes, como:

• Nome
  
  

• Número de telefone
  
  

• Email
  
  

• Endereço
  
  

• Perguntas ou número da transação
  
  

Estes formulários podem ser vinculados diretamente às respostas profissionais ou menus interativos, de forma que o formulário seja acionado automaticamente quando uma regra corresponder (por exemplo: "Quero reservar", "Quero comprar"...).

📌 Componentes do formulário

1. Nome do formulário
   Nome descritivo que ajuda a entender o objetivo do formulário (ex.: Solicitação de Reserva – Dados do Cliente).
   
   

2. Conteúdo da mensagem
   Mensagem de boas-vindas ou introdutória enviada primeiro ao usuário.
   Fornece uma visão geral do serviço ou explica o que é necessário (ex.: "Olá 👋, para concluir a reserva, por favor insira seus dados").
   
   

3. Respostas interativas (Perguntas)
   Cada resposta interativa contém:
   
   

• Nome do campo: título interno armazenado no aplicativo (ex.: Nome, Telefone, Email).
  
  

• Pergunta para o usuário: texto mostrado ao usuário (ex.: "Por favor, insira seu nome completo").
  
  

• Tipo de dado:
  
  

  • Texto simples
    
    

  • Número de telefone (verifica validade)
    
    

  • Email (verifica formato correto)
    
    

  • Apenas números (impede entrada não numérica)
    
    

Várias perguntas podem ser adicionadas sequencialmente; o aplicativo envia a próxima pergunta após o usuário responder à anterior.

📌 Opções adicionais
✅ Confirmação de salvamento (Opcional)

• Texto de confirmação: ex.: "Deseja salvar estes dados?"
  
  

• Código de confirmação de salvamento: palavra ou símbolo que, se inserido pelo usuário, salva a solicitação (ex.: "Sim")
  
  

• Código de cancelamento: palavra ou símbolo que, se inserido pelo usuário, ignora a solicitação (ex.: "Não")
  
  

📩 Mensagem de conclusão
Mensagem de agradecimento ou notificação após salvar a solicitação.
Exemplo: "Sua solicitação foi salva ✅, entraremos em contato em breve."

🔔 Notificações

• Enviar notificação dentro do app quando houver uma nova solicitação.
  
  

• Enviar resumo ao cliente com os dados inseridos (ex.:
  Nome: …
  Telefone: …
  Endereço: …)
  
  

🔗 Vinculação do formulário
O formulário pode ser vinculado a uma regra profissional (Keyword Rule) ou menu interativo, ativando-o quando o usuário seleciona um item específico.

💡 Benefício: Com os formulários de solicitação, você pode transformar seu sistema de respostas automáticas em um sistema completo de gerenciamento de pedidos, coletando dados dos clientes de forma organizada e rápida.

Configurações:
⏳ Tempo de cancelamento
Defina o tempo permitido para o usuário inserir todos os dados antes que a solicitação seja cancelada automaticamente.
Tempo em minutos (1 a 60). Exemplo: 30 minutos.

🕑 Mensagem após expiração (Opcional)
Mensagem enviada se o usuário não concluir a entrada dos dados dentro do tempo definido.
Exemplo: "Desculpe, sua solicitação foi cancelada por não completar os dados em 30 minutos. Você pode tentar novamente a qualquer momento."

As respostas com IA permitem que o sistema responda aos clientes de forma natural e inteligente, em vez de depender apenas de respostas prontas. Para usar esse recurso, você precisa inserir a chave API do Gemini.

🔑 Passo 1: Inserir a chave Gemini API

Importância da chave:
A chave serve como autenticação para informar ao Gemini que essas solicitações pertencem à sua conta. Sem a chave, a IA não funcionará.

Como obter a chave:

• Clique no botão “Obter chave API”.
  
  

• Você será direcionado para a página de criação da chave via sua conta Gmail.
  
  

• Se já tiver uma chave, copie-a.
  
  

• Se não tiver, crie uma nova chave.
  
  

Inserindo a chave:

• Copie a chave e cole no campo principal da chave dentro do aplicativo.
  
  

• Você pode testar a chave clicando em “Testar chave” para garantir que funciona.
  
  

Chave reserva:

• Há um campo adicional para inserir uma chave API reserva.
  
  

• Se houver problema com a chave principal, o aplicativo alternará automaticamente para a chave reserva, garantindo a continuidade das respostas.
  
  

⚡ Modelos disponíveis do Gemini:

• Gemini 1.5 Flash: Muito rápido, adequado para respostas curtas e instantâneas, consome menos tokens
  
  

• Gemini 2.0 Flash: Geração mais nova, mais rápida e precisa, ideal para respostas curtas e melhor compreensão do contexto
  
  

• Gemini 2.5 Flash: Mais avançado da série Flash, melhor equilíbrio entre velocidade e qualidade
  
  

• Gemini 1.5 Flash Lite: Versão muito leve, ideal para respostas simples e redução de custos
  
  

• Gemini 1.5 Pro: Mais inteligente e preciso, adequado para respostas complexas ou textos longos, consome mais tokens
  
  

🏋️ Treinamento do Gemini (instruções personalizadas):
Após ativar o Gemini, você pode treiná-lo conforme a personalidade e os serviços da sua empresa:

• Clique em “Adicionar instruções” para abrir a tela de inserção de dados de treinamento.
  
  

• Essas instruções ajudam a IA a responder em nome da sua empresa de forma consistente.
  
  

Exemplo prático (empresa Aldhobhani Development):
Instrução:
"Você é um assistente virtual da Aldhobhani Development. Nossa empresa é especializada em aplicativos móveis, inteligência artificial e software web. Quando o cliente perguntar sobre nossos serviços, forneça uma explicação breve das soluções e diga que oferecemos suporte técnico de alta qualidade. Não use linguagem muito formal – seja amigável e profissional."

Exemplo 2 (aplicativo atual):
Instrução:
*"Você é um assistente virtual do aplicativo [Auto Reply]. O aplicativo é especializado em respostas automáticas e gerenciamento de conversas via WhatsApp, Messenger, Instagram, Telegram e SMS. Permite ao usuário configurar respostas profissionais, transferir conversas para funcionários humanos e ativar respostas via IA. Se o cliente perguntar sobre os recursos do aplicativo, explique que ele oferece:

• Automação inteligente de respostas
  
  

• Suporte a menus interativos
  
  

• Gerenciamento de pedidos de clientes via formulários
  
  

• Relatórios e estatísticas precisas
  
  

• Integração com IA Gemini para respostas naturais
  Faça suas respostas claras, amigáveis e profissionais."*
  
  

🔹 Resultado: O Gemini responderá como um funcionário de suporte do aplicativo, conhecendo detalhes e recursos.

⚙️ Configurações avançadas (Advanced Settings):
Quando ativadas, você pode controlar com precisão como o Gemini funciona. Caso contrário, as configurações padrão serão usadas.

• maxOutputTokens: Número máximo de tokens na resposta (ex.: 64 → resposta curta, 2000 → resposta longa)
  
  

• temperature: Criatividade e diversidade da resposta (0.0 → respostas precisas e fixas, 1.0 → respostas criativas; recomendado 0.6–0.8)
  
  

• topK: Número de escolhas consideradas ao gerar a próxima palavra (valor baixo → foco, valor alto → variedade)
  
  

• topP: Probabilidade acumulada para a escolha de palavras (0.9 → mais diversidade, 0.5 → mais conservador)
  
  

🎭 Estilo da resposta:

• Formal → tom educado e oficial
  
  

• Amigável → tom próximo do cliente
  
  

• Engraçado → respostas leves e divertidas
  
  

• Neutro → sem emoções ou estilo específico
  
  

• Profissional → mistura de formalidade e simpatia
  
  

✍️ Modo de resposta:

• Curta → resposta rápida e direta
  
  

• Detalhada → resposta com explicações e mais informações
  
  

📏 Configurações adicionais:

• Número máximo de caracteres: Define o tamanho da resposta (ex.: 250 → curta, 1000 → detalhada)
  
  

• Número de mensagens anteriores que o Gemini lembra: Define o alcance da memória na conversa atual (ex.: 3 → lembra as últimas 3 mensagens e responde com base nelas)
  
  

⚠️ Observação: A memória é válida apenas para o dia atual e não inclui conversas de dias anteriores. Escolher um número muito alto aumenta o consumo diário de tokens.

Claro! Aqui está a tradução profissional para português (pt), mantendo a estrutura e exemplos do original:

Menus interativos permitem direcionar o usuário por opções prontas em vez de digitar texto livre. Isso reduz erros e acelera o acesso à informação ou ação correta.

1) Nome do menu principal

Escolha um nome claro que indique seu conteúdo (ex.: Menu principal – Serviços da empresa Al-Dhobhani).

2) Definição dos itens do menu (até 7 itens)

Você pode criar até 7 itens no menu principal.
Para cada item, determine o que acontece quando é selecionado (veja “Tipos de ações” abaixo).
Dica: se precisar de mais de 7 opções, agrupe-as em submenus (classificação/agrupamento lógico).

3) Vinculação de itens a respostas profissionais

Qualquer item do menu principal ou submenu pode ser vinculado a uma regra de resposta profissional.
Ao selecionar esse item, a regra é ativada (como se o usuário tivesse digitado a palavra-chave correspondente).
Exemplo:
Item “Solicitar orçamento” ↔ regra profissional que envia o formulário de pedidos do cliente.

4) Submenus (estrutura hierárquica)

Cada item pode abrir um submenu com até 7 itens.
Cada item do submenu pode abrir outro submenu, criando vários níveis de hierarquia.
Exemplo comum:
Menu principal “Serviços” →
Item “Pacotes de desenvolvimento” (submenu) →
Itens do submenu: “Pacote básico / Pacote profissional / Pacote corporativo”

5) Personalização via importação de CSV (em vez de criar submenu manualmente)

Em vez de criar muitos itens manualmente, você pode fazer o item depender de um arquivo CSV como fonte de pesquisa/consulta:
Requisitos do arquivo: apenas 2 colunas

• input: valor digitado pelo usuário
  
  

• output: resposta que o sistema exibirá ao corresponder o valor
  
  

Exemplo de CSV (cabeçalho + 2 linhas):

• input,output

• ADEN,Entrega disponível em Aden em 24 horas

• SANA,Entrega disponível em Sana em 48 horas

Quando o usuário enviar ADEN, o aplicativo exibirá: “Entrega disponível em Aden em 24 horas”.

Quando usar CSV: quando houver dezenas ou centenas de valores (códigos de produtos, cidades, filiais), em vez de criar menus longos manualmente.

6) Personalização do item com ações especiais

Cada item (principal ou submenu) pode ter uma das seguintes ações:

• Abrir submenu: exibe opções mais detalhadas (até 7 itens por nível)
  
  

• Vincular ao formulário de pedidos: abre um formulário interativo (nome, telefone, endereço…), e os dados são salvos na seção de pedidos
  
  

• Transferir a conversa para um humano: suspende respostas automáticas e envia para atendimento humano
  
  

  • Após o tempo de espera (configurações gerais), as respostas automáticas retornam
    
    

• Vincular a regra profissional: ativa uma regra predefinida para enviar respostas/menus/IA, etc.
  
  

• Resposta padrão do menu: mensagem usada quando o usuário insere um valor incorreto ou “Voltar”
  
  

  • Exemplo: “Opção desconhecida. Digite o número de 1 a 3 ou ‘Voltar’”
    
    

7) Melhores práticas para criar menus

• Simplifique a estrutura: máximo de 7 itens por nível, distribua em 2–3 níveis
  
  

• Nomeie itens claramente: coloque a ação no início (ex.: “Solicitar orçamento”, “Abrir ticket de suporte”)
  
  

• Adicione instruções curtas: como escolher (número? texto?)
  
  

• Inclua “Voltar” e “Menu principal” nos submenus
  
  

• Grandes conjuntos de dados: use CSV (cidades, filiais, códigos) em vez de menus complexos
  
  

• Teste todos os caminhos: verifique se formulários/regras/transferência para humano funcionam corretamente
  
  

8) Exemplo prático – Empresa Al-Dhobhani

Menu principal – Serviços Al-Dhobhani

• Nossos serviços → submenu
  
  

  • Desenvolvimento de aplicativos móveis → vinculado à regra “Detalhes do serviço”
    
    

  • Soluções de IA → vinculado à regra “Detalhes do serviço”
    
    

  • Sites e lojas online → vinculado à regra “Detalhes do serviço”
    
    

• Pacotes → submenu
  
  

  • Básico
    
    

  • Profissional
    
    

  • Corporativo
    
    

• Solicitar orçamento → formulário de pedidos (coleta nome/telefone/requisitos)
  
  

• Suporte técnico → transfere para atendimento humano (aviso: “Você será conectado a um atendente em alguns minutos”)
  
  

• Preços por cidade → importação CSV (cidades ← disponibilidade/prazos/custo)
  
  

• Contato → regra que envia informações de contato
  
  

Funcionamento no exemplo:

• “Solicitar orçamento” → abre formulário, salva na seção de pedidos
  
  

• “Suporte técnico” → suspende respostas automáticas e envia para humano
  
  

• “Preços por cidade” → usa CSV para resposta personalizada por cidade
  
  

⚙️ Configurações de respostas em menus interativos

1. Botões de navegação fixos
   Códigos reservados, não editáveis:
   
   

• 0 → voltar ao menu principal (início)
  
  

• 9 → voltar ao nível anterior
  
  

• 99 → encerrar totalmente o menu interativo
  
  

2. Tempo limite automático (Timeout)
   Pode ser definido entre 1–60 minutos. Se o usuário não interagir, o menu fecha e o sistema retorna ao estado padrão.
   Mensagem opcional: pode ser enviada após o tempo limite
   Exemplo: “O tempo de escolha acabou. Digite qualquer mensagem para começar novamente 👋”
   
   

3. Tratamento de erros (entrada inválida)
   Se o usuário digitar número ou valor inexistente:
   
   

• reenviar o menu
  
  

• enviar mensagem curta de orientação
  Exemplo: “Opção não encontrada. Para selecionar corretamente, digite o número do menu.”
  
  

4. Observação importante 📝
   A escolha no menu é feita apenas pelos números.
   Digitar texto ou palavras aleatórias não funciona no menu interativo.
   
   

Exemplo de configuração do menu de serviços Al-Dhobhani

• 0: voltar ao menu principal
  
  

• 9: voltar ao menu anterior (Pacotes ← Principal)
  
  

• 99: encerrar menu, voltar ao chat normal
  
  

• Tempo de espera: 5 minutos
  
  

• Mensagem após timeout: “O tempo de escolha acabou ⏳. Envie qualquer mensagem para reabrir o menu principal.”
  
  

• Erro de entrada: reenviar menu + mensagem: “A opção selecionada é inválida. Escolha um número correto do menu 👇”