Novo Módulo – Notificações de Novos Pedidos no Telegram
Patch Notes – Notificações de Novos Pedidos no Telegram
Descrição da atualização
Disponibilizamos o módulo Notificações de Novos Pedidos no Telegram, desenvolvido para enviar alertas automáticos sempre que um novo pedido é gerado na loja.
O módulo permite que a equipe seja informada em tempo real sobre novos pedidos, facilitando a agilidade no atendimento, separação e envio, especialmente em operações com entrega rápida ou alto volume de vendas.
A solução foi projetada para funcionar de forma segura e resiliente, utilizando uma fila de envio e processamento via cron, garantindo que notificações não sejam perdidas mesmo em situações de instabilidade momentânea do servidor ou da API do Telegram.
O que o módulo faz
Envia automaticamente uma notificação no Telegram sempre que um novo pedido é criado;
Permite personalizar a mensagem enviada através de um template configurável;
Suporta placeholders para incluir informações do pedido, como número, total e link para o painel administrativo;
Utiliza uma fila de envio com tentativas automáticas em caso de falha;
Executa o envio via agendamento, evitando impacto no checkout da loja;
Realiza a limpeza automática da fila, impedindo crescimento desnecessário da tabela no banco de dados.
Funcionamento do envio
O módulo executa o envio seguindo o fluxo abaixo:
Detecta a criação de um novo pedido;
Registra o pedido em uma fila de notificações no banco de dados;
Um agendamento periódico verifica a fila e processa os envios pendentes;
Caso o envio falhe, o sistema realiza novas tentativas automaticamente;
Após o envio com sucesso, o registro é marcado como concluído;
Registros antigos são removidos automaticamente por uma rotina de limpeza diária.
Esse processo garante que o envio seja confiável, mesmo em cenários de instabilidade temporária.
Onde fica
Sistema → Configuração → Vendas → Notificações de Pedidos no Telegram
Configurações disponíveis (resumo)
Habilitar
Ativa ou desativa o envio automático de mensagens.
Token do Bot Telegram
Token gerado pelo BotFather, utilizado para autenticar a comunicação com a API do Telegram.
ID do Chat Telegram
Identificador do chat ou grupo onde as notificações serão enviadas.
Template da mensagem
Permite definir o conteúdo da mensagem enviada.
Placeholders disponíveis:
-
{{var order.increment_id}}→ Número do pedido -
{{var order.grand_total}}→ Total do pedido -
{{var customer.name}}→ Nome do cliente -
{{var admin.order_url}}→ Link direto para o pedido no painel administrativo
Principais vantagens
Notificações em tempo real sobre novos pedidos;
Maior agilidade no atendimento e separação de pedidos;
Envio seguro, com fila e retentativas automáticas;
Não impacta o checkout da loja;
Configuração simples diretamente pelo painel;
Limpeza automática da fila, evitando crescimento desnecessário do banco;
Compatível com operações de alto volume.
Observações importantes
O módulo não interfere no processo de criação de pedidos nem altera regras de checkout;
O envio das mensagens ocorre via agendamento, podendo levar alguns instantes após a criação do pedido;
Em caso de falha temporária no envio, o sistema realiza novas tentativas automaticamente;
Registros enviados são removidos automaticamente por rotina de limpeza diária;
Registros com falha podem permanecer armazenados por um período para fins de diagnóstico;