Avaliação de atendimento

Depois que um ticket é encerrado, o bot pode pedir uma nota de 1 a 5 estrelas pra quem foi atendido — uma forma simples de acompanhar a qualidade do suporte do servidor.

Como ativar

Em Avaliação de atendimento, ative o recurso e escolha:

• A categoria onde o bot cria o canal privado de avaliação
• Quais painéis recebem o pedido de avaliação (nenhum marcado = nenhum ticket é avaliado)
• O nome do canal de avaliação (padrão ⭐avaliação-{count}), aceita {count} (número do ticket) e {user} (quem abriu)
• O texto e a cor da mensagem de pedido de avaliação (aceita {user} e {staff})
• O texto e a cor da mensagem de agradecimento, mostrada depois que a pessoa avalia (aceita {stars})
• O canal de logs (opcional): toda vez que a equipe apaga um canal de avaliação, o bot registra nele o número do ticket, a nota dada (ou “Não avaliou”), quem avaliou, quem atendeu e quem apagou, com um botão “Ver transcript do ticket avaliado” que abre a conversa que gerou a nota

Ranking de avaliações

Na aba Ranking de Avaliação de atendimento, cada servidor tem seu próprio painel com as notas recebidas:

• Média geral do atendimento, total de avaliações, porcentagem de avaliações positivas (4 e 5 estrelas) e quantos atendentes já foram avaliados
• Distribuição das notas, de 1 a 5 estrelas
• Ranking de atendentes, ordenado pela maior média (no empate, quem tem mais avaliações fica na frente), com a quantidade de avaliações e a data da última
• Últimas avaliações, com o ticket, quem avaliou, quem atendeu e a nota

As abas Ranking e Exibir avaliações só aparecem com a avaliação de atendimento ligada — se você desligar, elas somem (e as estatísticas públicas saem do ar até ligar de novo).

Dá pra filtrar por período: 7, 30 ou 90 dias, ou todo o histórico. A mensagem final do canal de avaliação e o registro no canal de logs têm um botão “Ver ranking de avaliações” que abre essa página direto.

Mostrar as estatísticas no seu site, jogo ou Discord

Na aba Exibir avaliações de Avaliação de atendimento, você pode liberar o resumo das avaliações (a mesma parte de cima do Ranking: média geral, total de avaliações, % positivas, atendentes avaliados e distribuição das notas) pra qualquer pessoa ver, sem precisar de login. Fica desligado por padrão — só aparece pra fora depois que você marcar “Liberar as estatísticas das avaliações publicamente” e salvar.

Com a opção ligada, a aba pergunta onde você quer mostrar — No Discord, No site ou No jogo — e mostra só o passo a passo daquele lugar, com os links e códigos prontos pra copiar. Por baixo, existem três formas de mostrar os mesmos números:

• Widget — a tela pronta (cards + gráfico de notas), pra colocar dentro de um site ou jogo.
• Imagem — um card em PNG com o resumo, ótimo pro Discord e pra qualquer site.
• API (JSON) — os números crus, pra você montar o visual do seu jeito (fica em “Avançado”).

No Discord

Em No Discord, escolha um canal e clique em Salvar. O bot posta ali uma imagem com o resumo das avaliações e confere os números a cada 10 minutos. Se mudaram, ele posta uma imagem atualizada e apaga a anterior, então o canal fica sempre com uma só. Se nada mudou, a mensagem continua igual.

• O bot precisa poder ver o canal, enviar mensagens e anexar arquivos.
• A imagem é enviada assim que você salva, e só existe quando há pelo menos uma avaliação.
• Trocar de canal ou desligar apaga a mensagem antiga. Desligar a avaliação de atendimento (ou a opção de exibir publicamente) também tira a mensagem do canal.

Também dá pra colar o link do widget numa mensagem: o Discord mostra o card como prévia e quem clicar vê os números ao vivo. Em mensagens de bot ou webhook, use o link da imagem no campo de imagem do embed — ela é uma foto do momento e o Discord guarda em cache; pra renovar, acrescente ?v=2 no fim do link.

No site

Cole no HTML da página, no lugar onde o resumo deve aparecer (troque ID_DO_SERVIDOR pelo ID que aparece nos links da aba Exibir avaliações):

<iframe
  src="https://horizontool.xyz/embed/avaliacoes/ID_DO_SERVIDOR?tema=escuro&fundo=transparente"
  width="100%"
  height="440"
  style="border:0"
  loading="lazy"
></iframe>

O widget atualiza os números sozinho, a cada minuto, enquanto a página estiver aberta.

Ajustes no fim do link do widget:

No jogo (FiveM e outros)

Se o jogo tem interface em HTML (como o NUI do FiveM), use o mesmo código do widget dentro dela. Se o jogo bloquear páginas externas, use a API e desenhe os números no seu visual. Exemplo no servidor do jogo (Lua):

PerformHttpRequest("https://horizontool.xyz/api/public/ratings/ID_DO_SERVIDOR", function(status, body)
  if status ~= 200 then return end
  local stats = json.decode(body)
  print(("Média %.1f · %d avaliações"):format(stats.average, stats.total))
end, "GET")

O que a API devolve

GET https://horizontool.xyz/api/public/ratings/ID_DO_SERVIDOR (aceita ?periodo=7|30|90|tudo):

{
  "guildId": "123456789012345678",
  "period": "tudo",
  "total": 55,
  "average": 3.49,
  "label": "Regular",
  "positive": 21,
  "positivePercent": 38.2,
  "ratedStaffCount": 2,
  "distribution": [
    { "stars": 5, "count": 13, "percent": 23.6 },
    { "stars": 4, "count": 8, "percent": 14.5 },
    { "stars": 3, "count": 26, "percent": 47.3 },
    { "stars": 2, "count": 7, "percent": 12.7 },
    { "stars": 1, "count": 1, "percent": 1.8 }
  ],
  "updatedAt": "2026-11-05T19:00:00.000Z"
}

Os números ficam em cache por cerca de 1 minuto, então pode consultar à vontade. Se o servidor não existir, ou o compartilhamento estiver desligado, a resposta é 404. A API aceita chamadas de qualquer site (CORS liberado).

Como funciona na prática

1. O ticket é encerrado (por !close ou por inatividade).
2. O bot cria um canal privado chamado ⭐avaliação-{número}, na categoria configurada. Quem abriu o ticket só consegue ver e ler esse canal (não consegue enviar mensagem — só clicar nos botões); o cargo de suporte também enxerga o canal desde o início, pra acompanhar.
3. A pessoa clica numa nota de 1 a 5 estrelas, ou em “Prefiro não avaliar”.
4. Se avaliar, aparece uma pequena animação preenchendo as estrelas e, em seguida, a mensagem de agradecimento.
5. Em qualquer um dos dois casos (avaliou ou pulou), o acesso da pessoa ao canal é removido — ela deixa de enxergar o canal, mas o canal continua existindo. Quem está na equipe de suporte vê um botão “Deletar” na mensagem final e precisa apagar o canal manualmente quando quiser.