GitHub
Verifique a conta GitHub de um membro dentro de um ticket com a etapa de Autenticação GitHub.
Etapa de Autenticação GitHub
A etapa de Autenticação GitHub conecta um membro do Discord a uma conta GitHub verificada — perfeita para comunidades de desenvolvedores, projetos de código aberto e qualquer pessoa que venda ou ofereça suporte a código.
Este tipo de etapa é um recurso premium. Você não precisa criar nenhum GitHub App ou aplicação OAuth.
Quem Deve Usar
- Projetos de código aberto que querem associar um relatório de bug a um usuário real do GitHub
- Equipes que oferecem um nível de suporte diferente para patrocinadores ou contribuidores
- Vendedores que liberam acesso a repositórios privados após uma compra
- Comunidades que usam um cargo de "desenvolvedor verificado"
O Que É Armazenado
| Field | Example | Description |
|---|---|---|
github_id | 1234567 | O ID numérico permanente do usuário no GitHub |
github_username | octocat | O nome de login do GitHub no momento da verificação |
> GitHub Verification: `octocat` (`1234567`)Um nome de usuário do GitHub pode ser alterado e até mesmo ser assumido por outra pessoa. O ID numérico nunca muda — use-o sempre que precisar armazenar algo a longo prazo.
Como o Membro Vive Isso
A etapa mostra um botão Login com o logo do GitHub.
A página de autorização do GitHub é aberta e pede para conceder ao TicketWave o escopo read:user.
Depois que o membro autoriza, o GitHub o envia de volta e o TicketWave lê o perfil público.
A página de confirmação aparece e o ticket continua com a próxima etapa.
read:user é um escopo somente leitura para dados de perfil. O TicketWave não pode ler repositórios privados, não pode enviar código e não pode agir em nome do membro.
Configurar a Etapa
Abra o módulo Ticket Steps
Painel do servidor → Settings → Ticket Steps → Configure.
Crie a etapa
| Field | Suggestion |
|---|---|
| Step Title | Connect your GitHub account |
| Step Description | We use your GitHub account to link this ticket to your issues and contributions. |
| Step Type | GitHub Authentication |
| Required Step | Depende — para um relatório de bug, sim; para uma pergunta geral, não |
Torne-a opcional quando fizer sentido
Desative Required Step e o TicketWave adiciona um botão ⏭️ Skip. Membros sem conta GitHub ainda podem abrir o ticket, e o resumo mostra ⏭️ Skipped para que a equipe saiba por que o campo está vazio.
Teste
Abra um ticket e percorra o fluxo uma vez.
Solução de Problemas
| Problem | Cause | Fix |
|---|---|---|
| A etapa não aparece | Premium inativo ou etapa acima do limite gratuito | Verifique a página Premium e a ordem das etapas |
| "Token invalid or expired" | Mais de 10 minutos se passaram | 🔁 Renew Token, depois Login novamente |
| O GitHub mostra "already authorized" e pula a tela | O membro já autorizou o TicketWave antes | Totalmente normal — o login só fica mais rápido |
| O membro não quer autorizar | Nada é armazenado | Torne a etapa opcional para que ele possa pular |
Próximos Passos
- Authentication Overview
- Button Steps (Pergunte a versão afetada logo após o login)
- LunAI (Deixe a IA resumir relatórios de bug longos)
How is this guide?