Configuração do WhatsApp

Configure a integração com a API do WhatsApp para automatizar o envio de mensagens aos alunos e responsáveis. O sistema utiliza uma arquitetura modular inteligente com mais de 17.000 combinações diferentes de mensagens, adaptando-se automaticamente ao tipo de destinatário.

Como Acessar

Outras Opções → Parâmetros → WhatsApp

---

🔧 Configuração Inicial

1. Conectar Dispositivo

1. Editar → Acesse a tela de configuração
2. Número do Remetente → Insira o número que será usado para enviar as mensagens
3. Registrar → Clique e aguarde o QR Code aparecer
4. Conectar no WhatsApp:
   • Abra o WhatsApp no seu smartphone
   • Toque em Aparelhos Conectados
   • Selecione Conectar um aparelho
   • Escaneie o QR Code gerado pelo sistema
5. Finalizar → Após sincronização, clique em Salvar

2. Testar Configuração

• Campo Teste → Insira um número no campo Nro Telefone Teste
• Validar → Clique em Teste Msg ao lado de cada tipo de mensagem
• Verificar → Confirme se as mensagens estão sendo recebidas

---

🎯 Sistema de Diferenciação de Destinatários

O sistema WhatsApp implementa um algoritmo de personalização que adapta automaticamente as mensagens com base no tipo de destinatário:

Tipos de Destinatários Identificados

Tipo	Identificação	Linguagem	Foco
👶 Responsável de Criança	Aluno < 15 anos	"Seu(sua) filho(a)"	Orgulho familiar, apoio parental
👨‍👩‍👧‍👦 Responsável Familiar	Telefone responsável ≠ telefone aluno	Formal, terceira pessoa	Progresso acadêmico, acompanhamento
🎓 Próprio Aluno	Telefone responsável = telefone aluno	Direta ao estudante	Conquista pessoal, motivação individual

Algoritmo de Identificação

Se aluno.idade < 15 anos → Responsável de Criança
Senão se telefone_responsável ≠ telefone_aluno → Responsável Familiar  
Senão → Próprio Aluno

---

📱 Tipos de Mensagens Automáticas

Tipo de Mensagem	Quando é Enviada	Descrição
🎂 Aniversário	Data de aniversário	Parabeniza o aluno no seu dia especial
📅 Vencimento (Dia)	No dia do vencimento	Lembra sobre o vencimento da parcela
⏰ Vencimento (+2 dias)	2 dias após vencimento	Oferece segunda via e dados bancários
🤝 Vencimento (+10 dias)	10 dias após vencimento	Incentiva negociação e quitação
💪 Vencimento (+15 dias)	15 dias após vencimento	Mensagem motivacional para pagamento
🎓 Lembrete de Aula	Dia da aula agendada	Lembra o horário da aula
📋 Aviso de Falta	Dia seguinte à falta	Estimula reagendamento da aula
📊 Notificação de Nota	Ao registrar nota	Informa resultado (aprovação/reprovação)
👋 Notificação de criação de matrícula	Ao criar uma nova matrícula	Ativa/desativa o botão de enviar mensagem de boas-vindas na tela de matrículas

Configuração Rápida

Para cada tipo de mensagem, selecione Sim para ativar ou Não para desativar o envio automático.

---

⚠️ Sobre a notificação de criação de matrícula

Esta notificação só é enviada caso, na ação de criação da matrícula, o botão "SALVAR E ENVIAR MENSAGEM" seja pressionado:

Este botão ficará logo ao lado do botão verde clássico de salvar. Caso o WhatsApp não esteja conectado, a mensagem também não é enviada.

📝 Modelos de Mensagens

🎂 Aniversário

Hoje é o seu dia!
Que nunca lhe falte motivos para sorrir, e que sua vida seja repleta de felicidades e sonhos realizados!
Estaremos sempre aqui para te ajudar a alcançar seus objetivos!
Nossa equipe te deseja um Feliz Aniversário! 

📅 Vencimento - Dia do Vencimento

Olá!

O dia a dia está cada vez mais corrido, por isso, passamos para te lembrar que hoje é o dia do vencimento da sua parcela.
Caso precise da segunda via do boleto ou nossos dados bancários, pode entrar em contato comigo, será um prazer te atender.

Obrigado pela preferência!

⏰ Vencimento - 2 Dias Após

Olá! Tudo bem?

Ainda não identificamos o pagamento da sua parcela com vencimento em XX/XX/XX.
Se você precisa da segunda via do boleto ou nossos dados bancários, pode entrar em contato comigo, será um prazer te atender.
Agradecemos a preferência!

🤝 Vencimento - 10 Dias Após

Oi! Tudo bem contigo?
Não identificamos o pagamento da sua parcela com vencimento em XX/XX/XX.
NÃO DESISTA DE SEUS SONHOS!
Fale comigo e vamos negociar.
Estou te esperando!

💪 Vencimento - 15 Dias Após

Ainda não identificamos o pagamento da sua parcela com vencimento em XX/XX/XX.
Você só vencerá amanhã se não desistir hoje!
Nós te ajudamos a alcançar seus objetivos.
Vamos negociar.

🎓 Lembrete de Aula

Hoje é dia de dar mais um passo para seu sucesso!
Estamos te esperando às XX:XX horas.
Aguardo você!

📋 Aviso de Falta

Sentimos sua falta durante a aula, vamos marcar sua reposição?
Qual é o melhor dia e hora para você?

👋 Mensagem de criação de nova matrícula

Olá {{PRIMEIRO_NOME_ALUNO}}!  Aqui é da escola {{NOME_FANTASIA}} 🎉

É um prazer ter você com a gente nessa jornada de aprendizado. Aqui, você vai encontrar conteúdos preparados com carinho e atenção para ajudar no seu desenvolvimento, sempre de forma prática, clara e no seu ritmo.

Nosso objetivo é tornar o processo de aprender algo leve e envolvente, despertando sua curiosidade a cada passo. 🚀

📋 DADOS DE ACESSO:
* Login: {{LOGIN}}
* Senha: {{SENHA}}
* Portal do Aluno: https://www.ead.grupooportunidade.com.br

⚠️ Guarde essas informações com cuidado e não compartilhe com outras pessoas.

Conte conosco sempre que precisar. Desejamos que essa seja uma experiência transformadora para você!
Vamos forjar novas habilidades juntos. 🔥

Alterações na mensagem

A mensagem enviada ao aluno varia conforme as seguintes condições:

Modalidade do aluno:

• ONLINE: recebe o link do portal do aluno + dados de acesso
• Presencial: recebe apenas os dados de acesso

Nome fantasia da escola:

• Se não estiver configurado ou contiver valores padrão ("xxx" ou "xxxxxx"), a apresentação da escola será omitida da mensagem
• Configure o nome fantasia em: OUTRAS OPÇÕES → PARÂMETROS → EMPRESA

Nota: A variável {{NOME_FANTASIA}} na mensagem só será exibida quando o nome fantasia estiver devidamente configurado.

📊 Sistema Avançado de Notificação de Nota

🤖 Sistema de Mensagens com Inteligência Artificial

O sistema WhatsApp utiliza Inteligência Artificial para gerar mensagens personalizadas e únicas para cada situação. Cada mensagem é criada automaticamente combinando 3 blocos estruturados:

[BLOCO 1: INTRODUÇÃO] + [BLOCO 2: INFORMAÇÕES DA AULA] + [BLOCO 3: CONCLUSÃO]

Como Funciona:

1. 🧠 IA Identifica o Contexto: Tipo de destinatário, resultado da aula, histórico do aluno
2. 📊 Insere Dados da Aula: Nome do aluno, aula realizada, curso e nota obtida
3. 🎯 Combina Blocos Inteligentes: IA seleciona e combina blocos para criar mensagem única
4. 📱 Envia Automaticamente: Mensagem personalizada é enviada via WhatsApp

Combinações Disponíveis por Categoria:

• Aprovação Regular: 25 introduções × 12 corpos × 15 conclusões = 4.500 combinações (por tipo de destinatário)
• Sequência de Sucessos: 15 introduções × 6 corpos × 7 conclusões = 630 combinações (por tipo de destinatário)
• Excelência Consecutiva: 15 introduções × 6 corpos × 7 conclusões = 630 combinações (por tipo de destinatário)
• Reprovação: 14 mensagens únicas

Inteligência Artificial Avançada

A IA gera mais de 17.000 combinações diferentes garantindo que as mensagens nunca se repitam, sempre incluindo as informações específicas da aula e nota do aluno de forma natural e engajante.

🎯 Tipos de Mensagens Inteligentes

✅ Mensagens de Aprovação

🏆 Aprovação Regular (Nota ≥ 60 ou ≥ 70 para exercícios digitais)

• Adapta automaticamente a linguagem ao tipo de destinatário
• Constrói mensagem única combinando blocos aleatórios
• Tom celebrativo e encorajador

🔥 Sequência de Sucessos (3+ notas altas consecutivas ≥ 80)

• Detecta automaticamente sequências de alto desempenho
• Mensagens especiais celebrando a consistência
• Linguagem específica para reconhecer a regularidade

👑 Excelência Consecutiva (2+ notas máximas = 10)

• Identifica sequências de notas perfeitas
• Mensagens de reconhecimento da excelência absoluta
• Tom mais enfático e comemorativo

❌ Mensagens de Reprovação

• Tom motivacional e encorajador
• Não diferencia tipo de destinatário
• Foco na persistência e melhoria
• 14 variações diferentes (formato longo e compacto)
• Sorteia aleatoriamente para evitar repetição

💡 Exemplos de Adaptação por Destinatário

👶 Para Responsável de Criança

🎉 Que alegria!

Seu(sua) filho(a) João foi aprovado na aula 5 do curso Informática Básica!
📊 Nota obtida: 85

Vocês estão de parabéns pelo apoio! O progresso tem sido excelente! 📚✨

🎓 Para Próprio Aluno

🎉 Parabéns!

Você foi aprovado na aula 5 do curso Informática Básica!
📊 Sua nota: 85

Continue assim! Seu progresso está sendo excelente! 📚✨

👨‍👩‍👧‍👦 Para Responsável Familiar

🎉 Excelente resultado!

O estudante João foi aprovado na aula 5 do curso Informática Básica!
📊 Nota obtida: 85

O acompanhamento está fazendo diferença! Continue apoiando! 📚✨

---

📝 Exemplos Detalhados de Mensagens

✅ Mensagens de Aprovação Regular

👶 Responsável de Criança - Exemplos de Blocos

Bloco 1 (Introduções) - Algumas variações:

🎉 Que alegria!
🌟 Ótima notícia! 
✅ Sucesso!
🏆 Parabéns!
🎊 Maravilhoso!
🚀 Fantástico!
🔥 Que orgulho!
💫 Incrível!
🎯 Espetacular!
⭐ Magnífico!

Bloco 2 (Corpos) - Algumas variações:

Seu(sua) filho(a) [NOME] foi aprovado(a) na aula [AULA] do curso [CURSO]! 📊 Nota obtida: [NOTA]

[NOME] brilhou na aula [AULA] do curso [CURSO]! 🌟 Desempenho: [NOTA]

[NOME] mandou muito bem na aula [AULA] do curso [CURSO]! 🎯 Pontuação: [NOTA]

[NOME] arrasou na aula [AULA] do curso [CURSO]! 🚀 Nota final: [NOTA]

[NOME] foi um espetáculo na aula [AULA] do curso [CURSO]! ✨ Resultado: [NOTA]

Bloco 3 (Conclusões) - Algumas variações:

Vocês estão de parabéns pelo apoio! O progresso tem sido excelente! 📚✨

O acompanhamento de vocês está fazendo toda diferença! Continuem assim! 🚀

Vocês são os melhores pais do mundo! Esse sucesso é reflexo do amor de vocês! 💖👨‍👩‍👧‍👦

A família unida constrói futuros brilhantes! Vocês são incríveis! 🌟👪

O carinho de vocês está formando um grande estudante! Que orgulho! 🥰📚

🎓 Próprio Aluno - Exemplos de Blocos

Bloco 1 (Introduções) - Algumas variações:

🎉 Parabéns!
🌟 Excelente! 
✅ Aprovado!
🏆 Muito bem!
🚀 Sensacional!
💫 Incrível!
🔥 Arrasou!
🎯 Certeiro!
⭐ Brilhante!
💎 Diamante bruto!

Bloco 2 (Corpos) - Algumas variações:

Você foi aprovado(a) na aula [AULA] do curso [CURSO]! 📊 Sua nota: [NOTA]

Você brilhou na aula [AULA] do curso [CURSO]! 🌟 Desempenho: [NOTA]

Você mandou ver na aula [AULA] do curso [CURSO]! 🎯 Pontuação: [NOTA]

Você arrebentou na aula [AULA] do curso [CURSO]! 🚀 Nota final: [NOTA]

Você foi um espetáculo na aula [AULA] do curso [CURSO]! ✨ Resultado: [NOTA]

Bloco 3 (Conclusões) - Algumas variações:

Continue assim! Seu progresso está sendo excelente! 📚✨

Parabéns pelo seu empenho! Você está no caminho certo! 🚀

Você é um(a) guerreiro(a) dos estudos! Continue brilhando! 💪⭐

Seu esforço está sendo recompensado! Que orgulho de você! 🏆💖

Você está construindo um futuro incrível! Continue assim! 🌟🔨

🔥 Mensagens de Sequência de Sucessos (3+ notas altas)

Exemplo Completo - Responsável de Criança:

🎆 Que sequência incrível!

Seu(sua) filho(a) Maria está em uma sequência incrível! 4 notas altas consecutivas no curso Digitação!

Vocês estão criando um(a) grande estudante! A dedicação familiar está dando frutos incríveis! 🌟📚

Exemplo Completo - Próprio Aluno:

🚀 Sequência vitoriosa!

Você está numa pegada imbatível! 4 aprovações consecutivas no curso Digitação!

Sua dedicação é inspiradora! Você vai longe! 🚀✨

👑 Mensagens de Excelência Consecutiva (2+ notas 10)

Exemplo Completo - Responsável de Criança:

🏆 Excelência absoluta!

Seu(sua) filho(a) Carlos é um gênio! Conquistou 3 notas máximas (10) consecutivas no curso Excel Avançado!

Vocês têm um(a) verdadeiro(a) gênio em casa! Essa excelência é fruto do amor e dedicação familiar! 🧠💖

❌ Mensagens de Reprovação (Exemplos)

Formato Longo:

📢 Atenção!

O aluno Maria obteve nota 45 na aula 3 do curso Word Básico.

⭐ Não desanime! O aprendizado é uma jornada e cada tentativa é um passo importante.

🎯 Estamos aqui para apoiar o sucesso do seu aprendizado!

Formato Compacto:

🌟 Cada passo conta! João enfrentou a aula 2 do curso PowerPoint e obteve nota 38. 💪 Lembre-se: Até os grandes campeões precisam de treino! 🏆 A próxima tentativa será ainda melhor!

---

⚠️ Requisitos e Observações

Termos de Aceite

É necessário aceitar os Termos de Aceite para utilizar a funcionalidade do WhatsApp.

Autorização de Envio

Certifique-se de que o envio de mensagens está autorizado no cadastro do aluno para que as notificações sejam enviadas corretamente.

Variáveis Dinâmicas

As mensagens utilizam variáveis que são substituídas automaticamente:

• {aluno} - Nome do aluno
• {aula} - Nome/número da aula
• {curso} - Nome do curso
• {nota} - Nota obtida pelo aluno
• XX/XX/XX - Data de vencimento
• XX:XX - Horário da aula

🔧 Configurações Técnicas Avançadas

Regras de Negócio

1. Autorização do Aluno: aceitaReceberWhatsResp deve ser true
2. Configuração do Cliente: enviarNotificacaoNotaWhats deve ser "Sim"
3. Telefone Válido: Mínimo 10 dígitos após limpeza
4. Autorização WhatsApp: aceite_termo_whats deve ser true
5. Sender ID: Usa phoneNumberId do cliente ou sender padrão

Critérios de Aprovação

• Aulas Regulares: Nota mínima = 60
• Exercícios Digitais: Nota mínima = 70
• Sequência de Sucessos: 3+ notas consecutivas ≥ 80
• Excelência Consecutiva: 2+ notas consecutivas = 10

Processamento Assíncrono

O sistema utiliza processamento assíncrono para não impactar a performance da API principal, com timeout de 10 segundos por envio.

---

📊 Estatísticas do Sistema

Quantitativo de Combinações

• Aprovações regulares: 13.500 combinações
• Sequências de sucesso: 1.890 combinações
• Excelência consecutiva: 1.890 combinações
• Reprovações: 14 mensagens
• 🎯 TOTAL: 17.294 variações diferentes

Benefícios da Arquitetura

1. Variedade Extrema: Mais de 17 mil combinações possíveis
2. Personalização Inteligente: Adaptação automática ao destinatário
3. Contextualização Avançada: Mensagens especiais para padrões de desempenho
4. Engajamento Máximo: Conteúdo sempre diferente evita monotonia
5. Inteligência Comportamental: Reconhece padrões automaticamente

---

Envio Automático com IA

• 🤖 Inteligência Artificial: Cada mensagem é gerada automaticamente pela IA combinando 3 blocos estruturados
• 📊 Dados da Aula: Sistema inclui automaticamente nome do aluno, aula realizada, curso e nota obtida
• 🎯 Personalização: IA adapta linguagem conforme tipo de destinatário (criança, responsável ou aluno)
• 🔄 Variação Infinita: Mais de 17.000 combinações garantem mensagens sempre diferentes
• ⚡ Envio Automático: Disparado imediatamente após registrar a nota no sistema
• 🧪 Teste: Use sempre o campo de teste antes de ativar o envio automático