(MENSAGERIA WHATSAPP INPERA) Disparo Automático das Mensagens Pendentes
Resumo da Nota Técnica
Nesta ordem de serviço foi implementado o processo de disparo automático da mensageria via WhatsApp da INPERA. Antes desta melhoria, as mensagens eram geradas pelo sistema e ficavam pendentes para envio, porém não existia uma rotina responsável por localizar essas mensagens e realizar o envio pelo WhatsApp. Com a implementação, o sistema passa a verificar periodicamente as mensagens pendentes, respeitar as configurações de cada empresa, realizar o envio e atualizar a situação da mensagem conforme o resultado.
Detalhes da Nota Técnica
Criação do processo de disparo da mensageria Foi criado um processo responsável por verificar as mensagens pendentes de envio na mensageria WhatsApp. Esse processo identifica as mensagens aguardando envio e realiza o disparo automaticamente, sem necessidade de ação manual do usuário. Com isso, as mensagens geradas por Ordem de Serviço passam a ser efetivamente enviadas pelo WhatsApp.
Controle das mensagens pendentes As mensagens geradas pelo módulo de Ordem de Serviço continuam sendo registradas como pendentes. A partir desta melhoria, o sistema passa a acompanhar essas mensagens e atualizar sua situação conforme o andamento do envio. As mensagens podem ficar nas seguintes situações: Pendente: aguardando envio; Em processamento: mensagem reservada para tentativa de envio; Enviada: mensagem enviada com sucesso; Falha: mensagem que não pôde ser enviada após as validações ou tentativas previstas.
Frequência de disparo por empresa Foi adicionada a configuração de frequência de disparo da mensageria por empresa. Essa configuração permite definir, em segundos, de quanto em quanto tempo o sistema deve processar as mensagens daquela empresa. A frequência mínima permitida é de 30 segundos. Quando não houver configuração específica, o sistema utiliza o tempo padrão definido para a rotina.
Respeito ao horário permitido para envio O disparo das mensagens passa a respeitar o horário permitido de envio configurado por empresa na integração WhatsApp ChatIA. Com isso, o sistema evita o envio de mensagens fora do horário definido pela empresa. Caso uma mensagem não possa ser enviada naquele momento por estar fora do horário permitido, ela permanece aguardando para ser enviada no próximo período válido.
Processamento por empresa O processo de disparo considera as configurações individuais de cada empresa. Dessa forma, cada empresa pode ter sua própria frequência de envio e seu próprio horário permitido para mensageria. Essa melhoria permite que o sistema atenda diferentes regras de operação sem depender de uma configuração única para todos os clientes.
Tratamento de falhas no envio Foi implementado controle para tratar falhas durante o envio das mensagens. Quando ocorrer uma falha temporária, como instabilidade de conexão ou erro momentâneo no envio, o sistema poderá tentar novamente posteriormente. Quando a falha não puder ser recuperada, como telefone inválido, configuração ausente ou impedimento de envio, a mensagem será marcada como falha. Esse controle permite acompanhar melhor quais mensagens foram enviadas e quais não puderam ser concluídas.
Controle de tentativas Foi incluído o controle de tentativas de envio das mensagens. Esse controle permite que o sistema saiba quantas vezes uma mensagem já tentou ser enviada. Com isso, evita-se que uma mesma mensagem fique sendo processada indefinidamente em caso de falha permanente.
Reabertura de mensagens travadas Foi incluída uma regra para tratar mensagens que ficaram presas em processamento. Caso uma mensagem fique em processamento por tempo excessivo, o sistema poderá retorná-la para nova tentativa de envio. Essa melhoria evita que mensagens fiquem paradas sem conclusão por causa de alguma interrupção durante o envio.
Envio com controle de volume O processo de envio foi preparado para trabalhar com várias empresas e um volume crescente de mensagens. O sistema controla a quantidade de mensagens processadas por vez, evitando sobrecarga e reduzindo o risco de lentidão. Essa abordagem permite que a mensageria funcione de forma mais segura mesmo com aumento na quantidade de empresas e mensagens.
Preparação para novos módulos Embora a mensageria atual esteja voltada para Ordem de Serviço, o processo de disparo foi preparado para permitir futuras expansões. Com isso, o envio automático poderá ser aproveitado posteriormente para outros módulos, como Orçamento e Pedido de Venda, sem necessidade de recriar toda a rotina de disparo.
Ajustes identificados nas mensagens de agendamento Durante a análise da mensageria, foram identificados ajustes necessários nas mensagens de agendamento. As mensagens de OS agendada exibem a data do agendamento, porém ainda precisam incluir também o horário. Também foi identificado que as mensagens de aviso de agendamento devem ser enviadas no momento em que o agendamento for feito, respeitando o horário permitido, e não apenas próximo da data agendada. Esses pontos foram registrados para correção mediante aprovação.
Validação do link de acompanhamento Foi revisada a geração do link de acompanhamento enviado nas mensagens. Não foi identificado problema na montagem do link. Porém, foi apontada a necessidade de confirmar se o ambiente de produção utiliza um endereço público válido. Quando o link utiliza endereço local ou IP interno, ele pode não abrir corretamente para o cliente fora da rede da empresa.
Resultado para o processo operacional Com a melhoria, a mensageria via WhatsApp passa a ter um processo completo de envio. O sistema não apenas gera os registros de mensagens, mas também realiza o disparo, respeita horários, controla tentativas, trata falhas e atualiza a situação de cada mensagem. Isso torna a comunicação com clientes, representantes e empresas mais automática, confiável e preparada para crescimento.
Frequência de disparo da mensageria: define o intervalo, em segundos, para processamento das mensagens de cada empresa. O mínimo permitido é de 30 segundos.
Horário inicial de envio: define a partir de qual horário as mensagens podem ser enviadas pela empresa.
Horário final de envio: define até qual horário as mensagens podem ser enviadas pela empresa.
Configuração da integração WhatsApp ChatIA: necessária para permitir o envio das mensagens pelo WhatsApp.
Situação da mensagem: indica se a mensagem está pendente, em processamento, enviada ou com falha.
Tentativas de envio: controla quantas tentativas de envio já foram realizadas para a mensagem.