Integração com Discord

Caminho no backoffice: backoffice/settings/discord

Disponível para funções: Administrador do Sistema, Administrador

Visão Geral

A Integração com Discord conecta seu tenant Airspace a uma guilda (servidor) Discord, habilitando anúncios automatizados, canais de comunicação da equipe e vinculação opcional de contas de pilotos. Esta integração usa o bot Airspace para interagir com seu servidor Discord em nome da sua companhia aérea.

Configuração Inicial

Para conectar sua companhia aérea a um servidor Discord:

1. Navegue até backoffice/settings/discord.
2. Clique no botão Conectar (ou Autorizar) para iniciar o fluxo de autorização OAuth.
3. Você será redirecionado ao Discord para autorizar o bot Airspace a entrar na sua guilda.
4. Selecione o servidor Discord que deseja conectar e conceda as permissões solicitadas.
5. Após a autorização ser concluída, você é redirecionado de volta ao backoffice e a integração está vinculada.

O bot deve ter permissões suficientes no seu servidor Discord para ler canais, enviar mensagens e gerenciar cargos conforme necessário.

Configuração

Uma vez que o bot está conectado à sua guilda, configure as seguintes opções:

Canal de Anúncios

Selecione um canal da lista de canais da sua guilda onde o bot publicará anúncios automatizados. Mensagens publicadas neste canal incluem:

• Alertas de novo tenant -- Notificações relevantes para as operações da sua companhia aérea
• Envios de formulário de contato -- Quando alguém envia um formulário de contato, a mensagem é retransmitida para este canal

Canal da Equipe

Selecione um canal separado designado para comunicações exclusivas da equipe. Este canal é destinado a mensagens operacionais internas visíveis apenas à sua equipe administrativa.

Status Ativo

Alterne a integração entre ligada e desligada. Quando desativada, o bot permanece conectado à sua guilda mas para de enviar mensagens e processar eventos. Reativá-lo retoma a operação normal sem necessidade de re-autorização.

Desconectar

Clique no botão Desconectar para desvincular completamente o bot Airspace do seu servidor Discord. Isso remove a associação da guilda do seu tenant. Para reconectar, você deve passar pelo fluxo de autorização OAuth novamente.

Mensagens de Teste

Após configurar seus canais, use os botões de Mensagem de Teste para verificar se o bot tem as permissões corretas para publicar em cada canal selecionado.

• Uma mensagem de teste é enviada ao canal escolhido.
• Se o bot não tiver as permissões necessárias (ex.: Send Messages, Embed Links), uma mensagem de erro específica é exibida no backoffice indicando qual permissão está faltando.
• Resolva quaisquer problemas de permissão nas configurações do seu servidor Discord antes de confiar na integração para uso em produção.

Rankings Mensais

Caminho no backoffice: backoffice/settings/discord (role ate o cartao "Rankings Mensais")

A funcao de Rankings Mensais permite enviar manualmente uma mensagem de rankings para o canal de anuncios de um mes especifico. Isso e util para:

• Reenviar uma mensagem de rankings que falhou ou foi perdida
• Enviar rankings de um mes passado sob demanda

Para usar:

1. Selecione o Mes e o Ano nos menus suspensos.
2. Clique em Enviar Rankings.
3. Um embed rico com os 5 melhores pilotos por pontos, voos e horas daquele mes sera publicado no canal de anuncios.

observação

Os rankings tambem sao enviados automaticamente no 1o dia de cada mes as 12:00 UTC para o mes anterior. O envio manual e uma opcao adicional, nao um substituto.

Vinculação de Conta de Piloto

Pilotos podem opcionalmente vincular sua conta Discord a partir da página de configurações do perfil. Isso é separado da integração no nível do servidor e funciona da seguinte forma:

1. O piloto clica em um botão Vincular Discord na página de configurações do perfil.
2. Um fluxo OAuth é iniciado com os seguintes escopos:
   • identify -- Permite que a plataforma leia o nome de usuário e ID Discord do piloto.
   • guilds.join -- Permite que o bot adicione o piloto ao servidor Discord da sua companhia aérea automaticamente.
3. Após a autorização, o ID de usuário Discord do piloto é armazenado em seu registro de usuário.

observação

IDs de usuário Discord são armazenados criptografados no banco de dados para proteger a privacidade do piloto. A plataforma não armazena senhas Discord ou tokens de acesso além do necessário para o fluxo OAuth.

Gerenciamento de Cargos da Guilda

O bot pode gerenciar cargos da guilda para membros da equipe no seu servidor Discord. Isso habilita a atribuição automática de cargos baseada na função Airspace do usuário, mantendo a estrutura de cargos do seu servidor Discord sincronizada com a hierarquia da equipe da sua companhia aérea.

Permissões

Gerenciar a integração com Discord requer a função de Administrador do Sistema ou Administrador. A configuração faz parte do módulo de configurações e segue o mesmo modelo de permissões das outras configurações do sistema.