Acompanhar entregas
Encontre uma entrega, entenda por que ela falhou e reprocesse, conclua, cancele ou reenvie pelo painel.
Todas as entregas da loja ficam em Entregas › Todas as entregas: comandos no Minecraft, cargos, convites, downloads, chaves de licença e serviços externos. Falhas temporárias são repetidas sozinhas; esta página mostra o que fazer quando a entrega precisa de você.
Visão geral
No topo da página, os números mostram:
| Indicador | O que conta |
|---|---|
| Na fila | Entregas esperando a vez ou esperando o cliente (entrar no servidor, vincular a conta). |
| Em processamento | Entregas em execução, incluindo serviços externos que ainda não confirmaram. |
| Novas tentativas agendadas | Entregas que falharam por um motivo temporário e vão ser repetidas. |
| Tentativas esgotadas | Entregas que precisam de ação. |
| Entregues em 24 horas | Entregas concluídas no último dia. |
Use os filtros para encontrar uma entrega:
- Buscar entregas: cliente, e-mail, nick ou número do pedido;
- Situação: Na fila, Em processamento, Entregue, Nova tentativa agendada, Tentativas esgotadas ou Cancelada;
- Canal: Minecraft, Discord, Telegram, Serviço externo, E-mail, Download ou Chave de licença.
As entregas de um servidor Minecraft específico também aparecem em Histórico de comandos, na página do servidor.
Detalhe da entrega
Clique em uma entrega para abrir o detalhe. Ele tem:
- Execução: situação, número de tentativas, quando foi criada, próxima tentativa (ou quando foi concluída), destino (servidor, cargo, chat ou serviço) e, no Minecraft, o jogador. Quando há erro, a mensagem explica a causa. Em serviços externos, aparecem a referência do serviço e o link de download personalizado, quando houver.
- Cliente e acesso: cliente, pedido, benefício, situação do acesso liberado e o período em que ele vale.
- Ações: o que você pode fazer com a entrega (veja abaixo).
- Histórico deste acesso: todas as entregas do mesmo benefício para o mesmo cliente: concessão, reenvios e revogação.
- Revogar acesso: encerra o benefício para o cliente.
Ações
As ações aparecem para Proprietários, Administradores e Editores da loja. Cada uma fica registrada nos logs de auditoria.
| Ação | Quando aparece | O que faz |
|---|---|---|
| Reprocessar entrega | Nova tentativa agendada, Tentativas esgotadas ou Cancelada | Coloca a entrega de volta na fila e recomeça as tentativas do zero. Em comandos do Minecraft, cria uma entrega nova (o plugin nunca repete um comando já executado) e abre a página dela. |
| Marcar como entregue | Em processamento, Nova tentativa agendada ou Tentativas esgotadas | Conclui a entrega sem executar nada. A MinePag não tenta mais. |
| Cancelar entrega | Na fila, Nova tentativa agendada ou Tentativas esgotadas | Para de tentar. O acesso do cliente continua ativo. |
| Reenviar pelo canal | Acesso ativo, exceto em e-mail e serviço externo | Cria uma entrega nova no mesmo canal: comandos de novo, cargo de novo, convite novo do Telegram. |
| Reenviar por e-mail | Acesso ativo | Envia ao cliente um e-mail com as informações do acesso. |
| Revogar acesso | Acesso ativo | Encerra o benefício: remove o cargo, tira do chat, executa os comandos de revogação e bloqueia downloads e chaves. Exige digitar o e-mail do cliente. |
Reenviar pelo canal repete a entrega
No Minecraft, reenviar executa todos os comandos de novo: itens e dinheiro são entregues em dobro. Use só quando tiver certeza de que o cliente não recebeu.
Revogar o acesso não reembolsa o pedido. Para devolver o dinheiro, faça o reembolso em Vendas › Pedidos. Veja Reembolsos e contestações.
Reprocessar várias entregas
Quando há entregas com tentativas esgotadas, o botão Reprocessar falhas definitivas aparece no topo da página. Ele devolve à fila até 100 entregas de uma vez.
Antes, corrija a causa: permissões do bot, servidor online, estoque de chaves, serviço externo ativo. Comandos do Minecraft com resultado incerto ficam de fora: confira no jogo e reprocesse cada um na página da entrega.
Erros comuns
| Erro | Canal | Como resolver |
|---|---|---|
| "O cliente ainda não vinculou a conta do Discord na área do cliente." | Discord | Peça ao cliente para vincular a conta. A entrega roda sozinha depois. Veja Vincular contas. |
| "O cliente ainda não vinculou a conta do Telegram na área do cliente." | Telegram | O mesmo: o cliente vincula em Minha conta › Conexões. |
| "O bot não pode gerenciar este cargo…" | Discord | Suba o cargo do bot acima do cargo vendido e reprocesse. Veja Discord. |
| "O bot não tem permissão para convidar ou remover membros neste chat." | Telegram | Dê ao bot as permissões de administrador e reprocesse. Veja Telegram. |
| "O servidor recusou o comando: …" | Minecraft | Corrija o comando no produto ou instale o plugin que falta e reprocesse. |
| "O servidor parou durante a execução. Confira no jogo se a entrega aconteceu antes de reenviar." | Minecraft | Confira no jogo. Se o cliente recebeu, use Marcar como entregue; se não, Reprocessar entrega. |
| "O comando está na lista de comandos proibidos e não foi enviado ao servidor." | Minecraft | Troque o comando no produto. Veja Comandos bloqueados. |
| "O plugin não confirmou a execução dentro do prazo." | Minecraft | O servidor caiu ou perdeu a conexão. A MinePag tenta de novo sozinha. |
| "O serviço externo não confirmou a entrega dentro do prazo." | Serviço externo | O serviço não chamou a API em 24 horas. Confira os logs do serviço. Veja Serviços externos. |
| "O serviço externo está desativado. Reative o endpoint para retomar as entregas." | Serviço externo | Reative o serviço em Entregas › Serviços externos. |
| "Um dos arquivos ainda está sendo enviado ou processado." | Download | Aguarde o envio terminar em Catálogo › Arquivos. A MinePag tenta de novo. |
Avisos
Quando uma entrega esgota as tentativas, o proprietário e os administradores da loja recebem uma notificação "Entrega com tentativas esgotadas" com o link para o detalhe. Um servidor Minecraft que fica offline e um serviço externo com falhas seguidas também geram notificação.
Pela API
Para acompanhar as entregas no seu sistema, use Listar entregas e Consultar entrega com uma chave de escopo deliveries:read, ou assine os eventos delivery.completed e delivery.failed em um webhook.