• Receba alertas automáticos no Telegram sempre que um novo pedido for realizado na sua loja Magento 1
• As mensagens chegam em um grupo com as principais informações do pedido: número, valor total, nome do cliente e link direto para o admin
• A configuração exige a criação de um bot no Telegram e a obtenção do token de acesso e do ID do grupo
• Compatível com grupos comuns e supergrupos do Telegram

#Passo a Passo em vídeo

#Passo a Passo por Escrito

#1. Crie um bot no Telegram

Abra o Telegram e pesquise por BotFather. Verifique o selo de conta oficial antes de iniciar a conversa. Envie o comando /newbot e siga as instruções:

1. Informe o nome de exibição do bot (ex: Notificações Minha Loja)
2. Informe o nome de usuário — deve terminar obrigatoriamente com a palavra bot (ex: minhaloja_notify_bot)

Ao final, o BotFather enviará uma mensagem com o token de acesso do bot. Copie esse token — você vai precisar dele na configuração do admin.

#2. Crie o grupo e adicione o bot

No Telegram, crie um novo grupo (ou use um grupo existente da sua equipe) e adicione o bot pelo nome de usuário criado na etapa anterior.

Em seguida, envie qualquer mensagem no grupo para registrar a atividade recente do chat — isso ajuda na próxima etapa.

#3. Obtenha o ID do grupo

Para que o bot saiba para qual grupo enviar as mensagens, você precisa do ID do chat. Acesse a URL abaixo no navegador, substituindo <TOKEN> pelo token obtido no passo 1:

https://api.telegram.org/bot<TOKEN>/getUpdates

Na resposta, localize o campo "chat" e copie o valor do campo "id". O ID pode ser um número negativo — copie-o completo, incluindo o sinal de menos.

{
  "chat": {
    "id": -1001234567890,
    "title": "Notificações Loja",
    "type": "supergroup"
  }
}

#4. Configure o módulo no admin da loja

No painel administrativo, acesse Sistema → Configuração → Vendas → Notificações de Pedidos no Telegram e preencha os campos:

• Habilitar: selecione Sim
• Token do Bot Telegram: cole o token obtido no passo 1
• ID do Chat Telegram: cole o ID do grupo obtido no passo 3

Clique em Salvar configuração.

#Validação e Testes

Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.

Teste 1 — Notificação de novo pedido

Ação: Realize um pedido de teste na sua loja. Aguarde alguns segundos e verifique o grupo do Telegram.

Teste 2 — Dados corretos na mensagem

Ação: Abra a mensagem recebida no Telegram e verifique se todas as informações estão preenchidas: número do pedido, valor total, nome do cliente e link para o admin.

Teste 3 — Módulo desabilitado não envia mensagem

Ação: Acesse Sistema → Configuração → Vendas → Notificações de Pedidos no Telegram, altere Habilitar para Não, salve e limpe o cache. Realize outro pedido de teste.

Se não funcionar, verifique:

• Se o token foi copiado corretamente, sem espaços extras no início ou no fim
• Se o ID do chat foi copiado completo, incluindo o sinal de menos quando presente
• Se o bot foi adicionado ao grupo
• Se o cache foi limpo após salvar as configurações
• Se a URL https://api.telegram.org/bot<TOKEN>/getUpdates retornou dados — se não retornou, o token pode estar incorreto

#Observações Importantes

• Escopo global: a configuração vale para toda a loja. Não é possível definir grupos diferentes por store view.
• Variáveis disponíveis na mensagem: o template suporta {{var order.increment_id}} (número do pedido), {{var order.grand_total}} (valor total), {{var customer.name}} (nome do cliente) e {{var admin.order_url}} (link do pedido no admin).
• Momento do disparo: a notificação é enviada no momento em que o pedido é criado na loja, independentemente do status de pagamento.
• Canais do Telegram: o módulo foi validado com grupos e supergrupos. Para usar um canal, lembre-se de que o bot precisa ser administrador do canal.

#Referências e Relacionados

• Como atualizar o cache da loja: após salvar as configurações do módulo, é necessário limpar o cache para que as notificações comecem a funcionar.
• Notificações por e-mail (SMTP): alternativa ou complemento ao Telegram para avisar a equipe sobre novos pedidos.
• Gerenciamento de pedidos: depois de receber o alerta no Telegram, o pedido segue o fluxo normal de gestão no admin.

• Receba alertas automáticos no Telegram sempre que um novo pedido for criado na sua loja Magento 2
• As mensagens chegam em um grupo (ou canal) com as informações do pedido: número, cliente, valor, forma de pagamento, itens e mais
• Você acompanha o histórico de envios por um painel próprio no admin, com status de cada notificação
• Tudo acontece no admin e no Telegram — o cliente final não percebe nada na loja

#Passo a Passo por Escrito

#1. Crie um bot no Telegram

Abra o Telegram e pesquise por BotFather. Verifique o selo de conta oficial antes de iniciar a conversa. Envie o comando /newbot e siga as instruções:

1. Informe o nome de exibição do bot (ex: Notificações Minha Loja)
2. Informe o nome de usuário — deve terminar obrigatoriamente com a palavra bot (ex: minhaloja_notify_bot)

Ao final, o BotFather enviará uma mensagem com o token de acesso do bot. Copie esse token.

#2. Adicione o bot ao grupo (ou canal)

No Telegram, crie um novo grupo (ou use um existente) e adicione o bot pelo nome de usuário criado na etapa anterior. Em seguida, envie qualquer mensagem no grupo para registrar a atividade recente do chat.

#3. Obtenha o ID do chat

Para que o bot saiba para onde enviar as mensagens, você precisa do ID do chat. Acesse a URL abaixo no navegador, substituindo <TOKEN> pelo token obtido no passo 1:

https://api.telegram.org/bot<TOKEN>/getUpdates

Na resposta, localize o campo "chat" e copie o valor do campo "id". Copie o número completo, incluindo o sinal de menos quando houver.

{
  "chat": {
    "id": -1001234567890,
    "title": "Notificações Loja",
    "type": "supergroup"
  }
}

#4. Ative o módulo e informe o token e o chat

No painel administrativo, acesse Lojas → Configurações → Vendas → Telegram Order Notifier. Na seção General Settings (configurações gerais), preencha:

• Enable Notifications (ativar notificações): selecione Yes (Sim)
• Bot Token (token do bot): cole o token obtido no passo 1
• Chat ID (ID do chat): cole o ID obtido no passo 3

Clique em Save Config (salvar configuração).

#5. Escolha o modo de entrega (Delivery Mode)

Ainda em General Settings, defina o campo Delivery Mode (modo de entrega), que controla quando a notificação é enviada:

• After purchase (após a compra): envia a notificação na hora em que o pedido é finalizado.
• Cron only (somente por agendamento): coloca a notificação em fila, e o agendador automático de tarefas da loja envia em lotes. É o padrão.
• Both (ambos): tenta enviar na hora e, se falhar, o agendador reenvia depois — a opção mais resiliente.

#6. Personalize a mensagem (opcional)

Na seção Message (mensagem), você pode ajustar:

• Message Template (modelo da mensagem): o texto enviado no Telegram. Aceita emojis e os marcadores abaixo, que são substituídos automaticamente pelos dados de cada pedido.
• Date Format (formato da data): define como a data e a hora aparecem no marcador {created_at} (padrão d/m/Y H:i:s).

Marcadores disponíveis: {increment_id} (número do pedido), {customer_name} (nome do cliente), {customer_email} (e-mail do cliente), {grand_total} (valor total), {payment_method} (forma de pagamento), {shipping_method} (forma de envio), {items_count} (quantidade de itens), {product_names} (nomes dos produtos), {status} (status do pedido), {store_name} (nome da loja) e {created_at} (data e hora do pedido).

#7. Ajuste reenvio e limpeza do histórico (opcional)

Para a maioria das lojas, os valores padrão já funcionam bem. Se quiser ajustar, use as seções Delivery Settings e Retention Settings:

• Batch Size (tamanho do lote): quantas notificações o agendador processa por vez (padrão 20).
• Max Attempts (máximo de tentativas): quantas vezes tentar enviar antes de marcar como falha (padrão 5).
• Keep Sent Records (days) (manter enviadas por X dias): por quanto tempo guardar o histórico de mensagens enviadas (padrão 30). Use 0 para nunca apagar.
• Keep Failed Records (days) (manter falhas por X dias): por quanto tempo guardar o histórico de falhas (padrão 90).

#8. Envie uma mensagem de teste (Send Test Message)

Ainda nas configurações, use o botão Send Test Message (enviar mensagem de teste). Ele dispara uma mensagem para o chat configurado usando a configuração já salva, sem precisar criar um pedido de teste.

#Validação e Testes

Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.

Teste 1 — Mensagem de teste

Ação: Clique em Send Test Message nas configurações do módulo e verifique o grupo no Telegram.

Teste 2 — Notificação de novo pedido

Ação: Realize um pedido de teste na loja. Aguarde alguns instantes (no modo Cron only, aguarde o próximo ciclo do agendador) e verifique o grupo.

Teste 3 — Histórico no painel de notificações

Ação: Acesse Vendas → Operações → Telegram Notifications e localize a linha do pedido de teste.

Se não funcionar, verifique:

• Se o Bot Token e o Chat ID foram colados corretamente, sem espaços extras
• Se o ID do chat foi copiado completo, incluindo o sinal de menos quando presente
• Se o bot é membro do grupo (ou administrador, no caso de canal)
• Se o Delivery Mode é Cron only ou Both e o agendador automático da loja está em execução
• No painel Vendas → Operações → Telegram Notifications, qual o status da notificação (pending, sent ou failed)

#Observações Importantes

• Sem impacto na loja: o módulo não altera nada na vitrine. O cliente final não vê nem percebe as notificações.
• Painel de auditoria: em Vendas → Operações → Telegram Notifications você acompanha cada notificação e seu status. É possível selecionar registros e usar Send Now (reenviar agora) ou Delete (excluir).
• Modo de entrega é global: o Delivery Mode vale para a loja inteira — não é possível definir um modo diferente por store view.
• Dependência do agendador: nos modos Cron only e Both, sem o agendador automático de tarefas da loja em execução, as notificações ficam paradas como pending e não são entregues.
• Mensagem "congelada" no envio: ao alterar o modelo da mensagem, os pedidos já registrados continuam com o texto antigo. O novo modelo vale apenas para pedidos a partir da alteração.
• Limpeza automática: o histórico de enviadas e de falhas é removido automaticamente após os prazos definidos em Retention Settings. As notificações ainda pendentes nunca são apagadas.
• Destino único: o módulo envia para um único Chat ID. Para enviar a vários grupos ou destinos diferentes por loja, seria necessária uma customização — fale com o suporte.
• Mensagem de teste genérica: o botão Send Test Message mostra apenas uma confirmação genérica na tela. Se o teste falhar e você não identificar o motivo, entre em contato com o suporte para verificarmos o detalhe do erro.

#Referências e Relacionados

• Como atualizar o cache da loja: após salvar as configurações, limpar o cache ajuda a garantir que as mudanças entrem em vigor.
• Agendamento automático de tarefas (cron) da loja: nos modos Cron only e Both, as notificações dependem do agendador da loja estar funcionando.
• Gerenciamento de pedidos: depois do alerta no Telegram, o pedido segue o fluxo normal de gestão no admin.