Novo Módulo Magento 2 – Notificações de Novos Pedidos no Telegram
Patch Notes – Notificações de Novos Pedidos no Telegram
Novo
O módulo Notificações de Pedidos no Telegram avisa você e sua equipe automaticamente sempre que um novo pedido é criado na sua loja virtual. A cada venda, uma mensagem com os dados do pedido — número, cliente, valor, forma de pagamento e itens — chega a um grupo ou canal do Telegram. Você ainda acompanha o histórico de todos os envios por um painel próprio no admin, sem precisar ficar verificando o e-mail.
O que o módulo faz
- Envia uma mensagem ao Telegram a cada novo pedido, seja ele feito na loja ou criado pelo painel administrativo.
- Inclui na mensagem os dados do pedido: número, cliente, valor total, forma de pagamento, frete e itens.
- Permite personalizar o texto da mensagem com marcadores automáticos e emojis.
- Oferece três modos de entrega: na hora da compra, por agendamento ou os dois combinados.
- Registra todas as notificações em um painel de histórico no admin, com o status de cada uma.
- Reenvia automaticamente as notificações que falharam, respeitando um limite de tentativas.
- Permite reenviar ou excluir notificações manualmente pelo painel, em lote.
- Limpa o histórico antigo de forma automática, conforme os prazos definidos.
- Disponibiliza um botão de mensagem de teste para validar a configuração sem precisar criar um pedido.
Onde fica
Configurações: Lojas → Configuração → Vendas → Telegram Order Notifier
Painel de notificações: Vendas → Operações → Telegram Notifications
Configurações disponíveis
Configurações Gerais
Enable Notifications
Ativa ou desativa o envio de notificações. Padrão: desativado.
Delivery Mode
Define quando a notificação é enviada: na hora da compra, por agendamento ou ambos. Vale para a loja inteira.
Bot Token
Token de autenticação do bot, gerado pelo BotFather no Telegram. Armazenado de forma criptografada.
Chat ID
Identificador do grupo ou canal de destino. Costuma ser um número negativo, como -1001234567890.
Send Test Message
Botão que dispara uma mensagem de teste usando a configuração já salva, sem precisar criar um pedido.
Entrega e Reenvio
Cron Frequency
Frequência com que o agendador entrega e reenvia as notificações pendentes. Padrão: a cada 5 minutos.
Batch Size
Quantas notificações são processadas por execução do agendador. Padrão: 20.
Max Attempts
Número de tentativas de envio antes de marcar a notificação como falha. Padrão: 5.
Retenção do Histórico
Purge Frequency
Frequência da limpeza automática do histórico. Padrão: diária, às 3h.
Keep Sent Records (days)
Por quantos dias manter o histórico de notificações enviadas. Padrão: 30. Use 0 para nunca apagar.
Keep Failed Records (days)
Por quantos dias manter o histórico de falhas. Padrão: 90.
Mensagem
Message Template
Modelo do texto enviado. Aceita emojis e marcadores como {increment_id}, {customer_name} e {grand_total}, preenchidos com os dados de cada pedido.
Date Format
Define como a data e a hora aparecem no marcador {created_at}. Padrão: d/m/Y H:i:s.
Principais vantagens
- Acompanhe cada venda em tempo real, direto no celular, sem precisar abrir o painel.
- Mantenha toda a equipe alinhada: todos veem os mesmos pedidos no mesmo grupo ou canal.
- Reduza o risco de perder vendas por não conferir o e-mail a tempo.
- Tenha um histórico organizado e auditável, com o status de cada notificação enviada.
- Conte com reenvio automático para que nenhuma notificação se perca por uma falha momentânea.
Observações importantes
- O Delivery Mode é uma configuração única para a loja inteira — não é possível definir um modo diferente por visão de loja (store view).
- Nos modos por agendamento (Cron only) e combinado (Both), as notificações dependem do agendador automático de tarefas da loja estar em execução.
- Em canais do Telegram, o bot precisa ser administrador; em grupos, basta ser membro.
- Ao alterar o modelo da mensagem, os pedidos já registrados mantêm o texto antigo — o novo modelo vale apenas para pedidos a partir da alteração.
- O módulo envia para um único Chat ID; para múltiplos destinos por loja, é necessária uma customização.
Quer receber notificações de pedidos no Telegram?
Fale com a equipe da mageshop e disponibilizamos o módulo no seu Magento 2.
Falar com a mageshop