Crie um bot de noites de jogos no Discord com eventos e RSVP

Piotr Grudzień
Publicado em 13 min de leitura
Uma lanterna e controles de jogos ao lado do evento real Co-op puzzle night no Discord com Interested selecionado

Um bot de Discord para noites de jogos transforma um plano no chat em um Scheduled Event ao qual os membros podem responder por RSVP. Neste guia, você criará Lantern Host para um pequeno servidor chamado Lantern Table. Começamos com um calendário vazio, organizamos uma noite de quebra-cabeças cooperativos e acompanhamos Marta quando escolhe Interested.

Lantern Host confirma Co-op puzzle night no Discord, junto do evento real com Interested selecionado e um membro interessado O seu objetivo: um evento real no Discord, um link RSVP funcional e um membro que escolheu Interested. Estes são os resultados do nosso servidor de teste Lantern Table.

O plano é simples: 12 de dezembro de 2026, das 19:00 às 21:00 UTC+01:00, no Lantern Table lounge. Cada pessoa traz uma sugestão de quebra-cabeça cooperativo. No final, o organizador poderá transformar esse plano em um evento e consultar quem está interessado sem percorrer um chat longo.

Comece conectando seu próprio bot, obtenha a primeira resposta útil listando noites de jogos e adicione criação de eventos e RSVPs nativos. A solução usa três Actions. A criação de eventos e a lista de interessados ficam restritas a administradores verificados do Discord.

Baixe o kit inicial do Lantern Host com as configurações completas das Actions, Main Prompt, plano de exemplo e checklist de testes. São ajustes editáveis para copiar no produto, não uma importação automática.

1. O que seu bot de eventos do Discord fará?

O Lantern Host permite acessar o calendário do servidor por conversa. Um membro pergunta o que está previsto, um administrador confirma um novo plano e o Discord mantém os eventos e registros de interesse.

Três Actions para três tarefas: encontrar uma noite de jogos, criar um evento e consultar membros interessados Crie primeiro a consulta de calendário somente para leitura. Adicione as duas Actions de administrador quando o bot encontrar os eventos do servidor correto.

PessoaO que fazO que muda
MembroPergunta “Quais noites de jogos estão chegando?”O bot consulta os eventos do servidor.
AdministradorFornece e confirma o plano completoO bot cria um Scheduled Event.
MembroAbre o link e clica em InterestedO Discord registra o interesse desse membro.
AdministradorPergunta “Quem está interessado em Co-op puzzle night?”O bot consulta os interessados no evento selecionado.

Usamos o tipo de evento de local externo do Discord, chamado Somewhere Else na interface. O local é um texto livre, portanto a primeira versão não precisa de ID de canal de voz. O evento continua pertencendo ao seu servidor.

Testamos esta configuração com duas contas reais do Discord: Piotr como administrador e Marta como membro comum. As capturas mostram o evento, o RSVP e as verificações de permissões reais. Use o mesmo teste com duas contas para verificar a sua configuração.

2. Como conectar seu próprio bot do Discord?

Use seu próprio aplicativo do Discord neste tutorial. O token do bot conectado autentica as Actions de eventos.

  1. Crie uma conta no Quickchat AI e uma conta no Discord. Crie um pequeno servidor de testes chamado Lantern Table que você tenha autorização para administrar. Consulte os planos e créditos do Quickchat AI para o uso pretendido.
  2. No Quickchat AI, escolha Add new AI Agent → Set up manually e dê o nome Lantern Host. Em Your Website → Install → Availability and access, desative Widget & Embed access e defina Chat Page Access como Nobody. Este exercício usa o Discord.
  3. Abra o Discord Developer Portal, crie um aplicativo chamado Lantern Host e abra suas configurações de Bot. Ative Message Content Intent. Obtenha o token do bot e insira-o diretamente em External Apps → Discord → Advanced setup no Quickchat AI. Não o inclua em prompts, conhecimento ou mensagens.
  4. Siga o link de convite da integração para instalar o bot em Lantern Table. As permissões de mensagens são View Channels, Send Messages, Create Public Threads, Send Messages in Threads e Read Message History. O guia de configuração do bot próprio mostra as telas do Developer Portal.
  5. No Discord, abra Server Settings → Roles → cargo do seu bot → Permissions e ative Create Events para todo o servidor. O bot não precisa de Administrator nesta solução.
  6. Num canal de testes, mencione @Lantern Host e envie “Olá”. Mencione-o novamente ou responda à mensagem dele para continuar. Confirme que seu próprio bot responde antes de adicionar Actions de eventos; um bot compartilhado do Quickchat AI no mesmo servidor pode ter prioridade.

Lantern Host conectado através de Advanced setup no Quickchat AI, junto das permissões de autorização do bot no Discord Conecte seu próprio aplicativo por Advanced setup. O bot compartilhado de um clique não fornece o token próprio usado por estas HTTP Actions.

A permissão Create Events do bot e a permissão Administrator do remetente têm funções diferentes. A primeira permite ao bot chamar o Discord. A segunda define, nesta configuração, quem pode solicitar a criação de um evento.

Opcional: prepare as Actions com ChatGPT ou Claude.

O guia Manage with AI explica a conexão da conta Quickchat AI, disponível na página do ChatGPT e na página do Claude. Um assistente conectado pode preparar HTTP Actions, Main Prompt e um conjunto de dados de Testing. Você ainda instala o aplicativo Discord, conecta seu token diretamente no produto e configura suas permissões no servidor.

Forneça este artigo ao assistente e envie:

Use only my Lantern Host Agent. Read its current settings first. Prepare the three HTTP Actions and complete Main Prompt from this tutorial, reusing matching Actions. Keep every Action disabled until I check it. Preserve the exact Discord URLs, System Token, guild metadata and run conditions. Never ask me to send a bot token in chat. Prepare the test prompts as a dataset, but do not run tests, spend credits or create a Discord event yet. Read back the saved settings and list the remaining owner steps.

Compare os ajustes salvos com as configurações antes de ativar qualquer coisa. Uma conversa pode consumir créditos e executar Actions ativadas.

Diagrama separando o status verificado de administrador do remetente da permissão de eventos do bot no Discord As duas verificações precisam passar. Dar permissão ao bot não torna administradora toda pessoa que conversa com ele.

3. Como mostrar as próximas noites de jogos?

A primeira Action consulta os Scheduled Events do servidor atual. Isso oferece algo útil aos membros antes de você ativar a criação de eventos.

  1. Abra Actions & MCPs → Add Action → API Action.
  2. Defina API Action Name como List game nights e When to run como AI decides.
  3. Use a configuração completa abaixo. A integração Discord fornece discord_guild_id nos metadados da conversa. Nos campos da requisição, seu chip é {{metadata_discord_guild_id}}.
  4. Em Run only when, adicione discord_guild_id → exists. Ative a Action depois de salvar os ajustes.

As três API Actions ativas de Lantern Host: List game nights, Create game night e Read interested members A lista de Actions concluída. Primeiro crie e ative List game nights; depois adicione as duas Actions protegidas nos passos seguintes.

Action 1 de 3: List game nights. Copie os ajustes completos.

API Action Name: List game nights
What to ask the user first: nenhum parâmetro.
API request method: GET
API endpoint URL:

https://discord.com/api/v10/guilds/{{metadata_discord_guild_id}}/scheduled-events
AbaNomeValor
HeadersAuthorizationBot {{discord_bot_token}}
Query Paramswith_user_counttrue

Body: vazio.
Run only when: discord_guild_id → exists.
API Action Description:

Find scheduled events in the current Discord server before answering event questions or selecting an event. Use returned names, IDs, times and user counts. Distinguish upcoming from active or completed events. Build native event links only from the current guild and returned event IDs. If the list is empty, say no events were found.

Use Add AI Data para inserir os metadados do servidor e o System Token discord_bot_token. O prefixo Bot , incluindo o espaço, é obrigatório. Não o substitua por Bearer. Se o menu de metadados ainda não foi atualizado após a primeira conversa Discord, digite exatamente o marcador do servidor acima.

Agora pergunte @Lantern Host, quais noites de jogos estão chegando? Uma lista vazia também é um primeiro resultado útil. Abra a conversa salva em Inbox e inspecione a chamada da Action; em View logs, confira a resposta. Um token ausente ou erro do Discord deve gerar uma explicação, não um calendário inventado.

Marta pergunta pelas próximas noites de jogos, Lantern Host informa que não há nenhuma e o registro da Action mostra HTTP 200 com uma lista vazia O primeiro êxito é um calendário vazio que corresponde à realidade. Marta pode fazer esta consulta sem permissões de administrador.

4. Como criar uma noite de jogos após a confirmação?

A Action de criação recebe o plano completo e o envia ao Discord após a confirmação de um administrador. Configure uma condição de execução verificada pelo servidor antes de ativá-la.

  1. Adicione uma segunda API Action, chamada Create game night.
  2. Adicione os cinco parâmetros Text obrigatórios da configuração. Suas descrições orientam o Agent sobre o que coletar.
  3. Configure método, URL e cabeçalhos. Cole o JSON na aba Body de API Endpoint, inserindo os chips correspondentes com Add AI Data.
  4. Em Run only when, adicione discord_guild_id → exists e author_is_admin → is true. As condições são combinadas com AND. Salve as configurações da Action e ative Create game night depois de adicionar o Main Prompt abaixo.

O editor real de Create game night mostra o endpoint POST do Discord e a variável salva do token do bot em Authorization Mantenha fixo o tipo de evento no Body. O modelo fornece os detalhes do evento; a integração fornece o servidor e a credencial.

Action 2 de 3: Create game night. Copie os ajustes completos.

API Action Name: Create game night
What to ask the user first:

FormatoNomeDescriçãoObrigatório
TextnameNome confirmado do evento, 1–100 caracteres.Sim
TextdescriptionDescrição confirmada, 1–1.000 caracteres.Sim
Textstart_timeData e hora futuras em ISO 8601 com deslocamento UTC explícito.Sim
Textend_timeData e hora em ISO 8601 com deslocamento UTC, posteriores a start_time.Sim
TextlocationLocal de encontro confirmado, 1–100 caracteres.Sim

API request method: POST
API endpoint URL:

https://discord.com/api/v10/guilds/{{metadata_discord_guild_id}}/scheduled-events
HeadersValor
AuthorizationBot {{discord_bot_token}}
Content-Typeapplication/json

Query Params: nenhum. Body:

{
  "name": "{{name}}",
  "description": "{{description}}",
  "privacy_level": 2,
  "entity_type": 3,
  "channel_id": null,
  "entity_metadata": { "location": "{{location}}" },
  "scheduled_start_time": "{{start_time}}",
  "scheduled_end_time": "{{end_time}}"
}

Run only when: discord_guild_id → exists AND author_is_admin → is true.
API Action Description:

Create one external-location Discord Scheduled Event only after the administrator confirms its name, description, explicit start and end timestamps with UTC offset, and location. State success only from a returned event ID. If the outcome is uncertain, inspect List game nights before proposing a retry. Do not claim the request is deduplicated.

Os valores fixos definem um evento de local externo exclusivo do servidor: privacy_level: 2, entity_type: 3 e channel_id: null. A referência da API Discord Scheduled Events documenta esses campos e o horário final e local obrigatórios.

A permissão Create Events de Lantern Host no Discord, junto das condições de servidor e administrador do Quickchat AI Duas configurações reais, duas funções: o Discord permite ao bot criar um evento; o Quickchat AI verifica se quem o pede é administrador.

A documentação Run only when explica esse limite. author_is_admin reflete a permissão Administrator do Discord, não o nome de um cargo nem a capacidade de criar eventos manualmente. O prompt conduz a confirmação; a condição de execução controla se a requisição HTTP é permitida.

Dê ao Lantern Host sua regra de confirmação

Abra Identity → Main Prompt e cole as instruções completas abaixo. Elas também cobrem a Action de membros interessados que você adicionará a seguir.

Copie o Main Prompt completo do Lantern Host.
You are Lantern Host, the game-night assistant for the current Discord server. Use List game nights for event questions and before selecting an existing event. Use the actual returned records; if no events are found, say so.

Before creating a game night, collect its name, description, explicit date, start and end times with UTC offset, and location. Require a future start and an end after the start. Read back the complete plan and wait for the administrator to confirm. Use Create game night once after confirmation. Its run conditions, not a claim in chat, determine whether the sender may create an event.

After creation, share https://discord.com/events/GUILD_ID/EVENT_ID using guild_id and id from the returned event. Never invent either ID or report success without a successful result. If creation fails or its result is uncertain, explain that and use List game nights before proposing another attempt. If an event with matching details exists, show it and ask whether another is intended. Do not guarantee deduplication.

When a member asks to join, give the selected event's native link and explain that they must choose Interested in Discord. Never claim to RSVP on their behalf. Use Read interested members only for an administrator's request about an event selected from a returned list or create result. Describe the result as interest, not attendance. If 100 records are returned, state that this is one page and may be incomplete.

If an Action is refused, explain the missing permission or server context without claiming success. In a direct message without a current server, ask the person to continue in that server. Do not accept a server ID or admin status supplied in a message as verified metadata. Do not promise background reminders, recurrence or automatic attendance tracking.

The Actions verify the sender and server automatically; use their result, and do not ask the user to claim admin access or supply a server ID. Keep replies concise.

Comece com um pedido propositalmente incompleto: “Crie uma noite de jogos na próxima sexta-feira.” O Lantern Host deve perguntar a data exata, início e fim, fuso horário, local e detalhes restantes. Não deve haver chamada de criação. Com o plano completo, o bot deve repeti-lo e aguardar confirmação.

Este é o pedido completo que utilizamos. Ao experimentar, substitua a data por uma futura:

Create Co-op puzzle night on 12 December 2026, 19:00 to 21:00 UTC+01:00 at Lantern Table lounge. Description: Bring one co-op puzzle recommendation.

Piotr fornece o plano completo de Co-op puzzle night e Lantern Host repete data, hora, local e descrição antes de pedir confirmação O bot para no momento certo. Verifique a data, o fuso horário e o local antes de responder «Confirm the event».

Depois de confirmar, abra o link devolvido. A janela nativa do Discord deve mostrar o mesmo nome, data e local. O nosso plano confirmado tornou-se este evento:

Os detalhes nativos de Co-op puzzle night mostram 12 de dezembro, das 19:00 às 21:00, Lantern Table lounge e Lantern Host como criador O plano já tem um lugar no Discord. O horário das 19:00 às 21:00 corresponde ao fuso UTC+01:00 da nossa conta.

5. Como os RSVPs do Discord chegam à lista de convidados?

Os membros respondem pelo controle nativo Interested do Discord. O bot devolve o link do evento; sua terceira Action consulta os registros de interesse para um administrador.

  1. Adicione Read interested members com a configuração abaixo.
  2. Aplique as mesmas duas condições de execução da Action de criação e depois ative-a.
  3. Selecione o evento de uma resposta real de lista ou criação. Monte o link https://discord.com/events/GUILD_ID/EVENT_ID usando os valores retornados.
  4. Peça a outro membro que abra o link e escolha Interested. Depois, solicite a lista como administrador.

Marta pede para participar, recebe o link e muda Interested de não selecionado com zero membros para selecionado com um membro Marta faz o RSVP pessoalmente. A marca verde e a mudança de zero para um surgem após o seu clique, não após a mensagem ao bot.

Action 3 de 3: Read interested members. Copie os ajustes completos.

API Action Name: Read interested members
What to ask the user first:

FormatoNomeDescriçãoObrigatório
Textevent_idID de evento selecionado de List game nights ou de um resultado bem-sucedido de Create game night no servidor atual.Sim

API request method: GET
API endpoint URL:

https://discord.com/api/v10/guilds/{{metadata_discord_guild_id}}/scheduled-events/{{event_id}}/users
AbaNomeValor
HeadersAuthorizationBot {{discord_bot_token}}
Query Paramslimit100
Query Paramswith_memberfalse

Body: vazio.
Run only when: discord_guild_id → exists AND author_is_admin → is true.
API Action Description:

For a verified administrator asking about a selected event, retrieve its currently interested users. Select event_id from a returned event in the current server, asking which event if ambiguous. Interest is not attendance. This request returns up to 100 users; if the page is full, explicitly say the list may be incomplete. Do not claim to subscribe anyone.

Uma página de até 100 usuários interessados basta para este pequeno servidor. Uma comunidade maior precisa de paginação usando os IDs de usuário before ou after documentados pelo Discord. Nunca apresente uma página cheia de 100 registros como lista completa sem verificar se existe outra página.

O guia Scheduled Events do Discord explica a experiência nativa dos membros. O link funciona para quem pode ver o evento; ele não concede acesso a um servidor privado. Interested é um sinal para planejamento, não uma contagem garantida de participantes.

Volte à conta de administrador e pergunte «Quem está interessado em Co-op puzzle night?» No nosso teste, a resposta indicou Marta, de acordo com a lista nativa de interessados do Discord.

O Discord apresenta Marta como o único membro interessado no evento e Lantern Host devolve o mesmo membro a Piotr O evento e a resposta coincidem: um membro interessado, Marta. A Action lê o registro atual em vez de deduzir interesse a partir do chat.

Só os administradores podem executar esta consulta através de Lantern Host. A resposta continua visível onde o bot responde. A nossa demonstração usa Reply in channel, por isso o nome aparece no canal compartilhado. Esta configuração não torna privada a lista de convidados.

6. Como testar uma noite de jogos completa?

Verifique o evento no Discord e a resposta no chat. Use um administrador e um segundo membro sem privilégios administrativos no servidor de testes.

  1. Como administrador, mencione @Lantern Host e envie um plano completo como o do passo 4. Para um novo evento de teste, escolha uma data futura e um nome diferente, e use esse nome nas perguntas abaixo.
  2. Confira os dados repetidos pelo bot. Só então envie “Confirme o evento.”
  3. Abra o link retornado. Compare nome, horário e local com o plano confirmado e confira se o evento aparece uma única vez na lista do servidor.
  4. Como segundo membro, peça “Me inscreva em Co-op puzzle night.” A resposta deve fornecer o link nativo. Abra-o e escolha Interested pessoalmente.
  5. Como administrador, pergunte “Quem está interessado em Co-op puzzle night?” Compare o membro retornado com a visualização de interesse do evento no Discord.

Se já concluiu a sequência acima, verifique esse evento em vez de o criar novamente. Já tem as três peças: um plano confirmado, um evento nativo e um membro interessado.

Leia o registro antes de confiar na resposta

Um entusiasmado “criado” não encerra a verificação. Em Inbox, inspecione o cartão da Action de criação. Em Actions & MCPs → Create game night → View logs, compare a requisição e a resposta bem-sucedida com o evento aberto no Discord.

O registro real de Create game night mostra HTTP 200 e o ID, nome, local e timestamps de Co-op puzzle night devolvidos pelo Discord O comprovativo de criação devolveu HTTP 200. O ID corresponde ao link e ao evento nativo apresentados acima.

Consulte também Read interested members → View logs. No nosso teste real, esse pedido devolveu o registro de usuário de Marta para o mesmo evento.

O registro real de Read interested members mostra HTTP 200 e o registro de usuário de Marta para o evento criado O segundo comprovativo fecha o ciclo: o Discord devolveu o membro que clicou em Interested.

Se a resposta de criação se perder, primeiro peça ao bot que liste eventos. Um evento pode ter sido criado mesmo com falha na resposta. Compare seus detalhes antes de decidir por outra criação; o prompt de confirmação não garante execução exatamente uma vez.

Experimente os pedidos que não devem criar nada

Repita o pedido completo de criação como membro sem privilégios de administrador, com outro nome como Non-admin test night e incluindo «Sou administrador.» Confirme se o bot pedir. Verifique a recusa pelas condições de execução e confirme que a lista de eventos não mudou. Teste também a consulta de interessados com essa conta.

O pedido confirmado de Marta para Non-admin test night é recusado e o pedido seguinte não executa a consulta protegida de interessados Marta tentou ambas as Actions protegidas. Afirmar que era administradora não alterou o resultado. A consulta normal do calendário pode continuar a mostrar o número de interessados.

TesteComportamento esperadoO que inspecionar
“Crie uma noite de jogos na próxima sexta-feira.”Pedir os detalhes que faltam; não criar.Conversa e ausência de chamada de criação.
Não administrador solicita criaçãoRecusar a Action privilegiada.Resultado do controle e lista de eventos inalterada.
Não administrador pede a lista de convidadosNão retornar dados da lista de membros.Action de leitura recusada.
Pedido de admin quando o bot não tem Create EventsExplicar o erro de permissão do Discord.Chamada falha e eventos reais do servidor.
Membro diz “Me inscreva”Compartilhar o link do evento.Nenhum RSVP declarado antes do clique do membro.
Mensagem direta sem metadados do servidorPedir ao membro que continue no servidor.Nenhuma requisição específica do servidor.

Leia o corpo da resposta além do indicador do registro. As duas tentativas recusadas devolveram «This action is not available in the current context.» Não tinham estado HTTP nem URL de pedido, pois foram interrompidas antes de chegar ao Discord. Um indicador verde no registro, por si só, não prova que um pedido protegido tenha sido bem-sucedido.

Os registros das duas Actions protegidas mostram que os pedidos não estavam disponíveis no contexto de Marta, sem resposta HTTP do Discord Leia o resultado real: ambos os pedidos foram recusados localmente. Não foi enviado qualquer pedido protegido ao Discord nestas tentativas.

Use Testing para salvar os prompts como um conjunto de dados repetível. Uma Simulation normal não comprova as permissões do remetente do Discord. Faça o teste com duas contas em conversas reais do Discord e compare as respostas, os resultados das Actions e o evento nativo. Um avaliador de respostas não certifica que um membro clicou em Interested.

Checklist compacto reunindo conversa, registro da Action e evento real do Discord Mantenha o mesmo ID do evento nas três visualizações. Uma resposta bem escrita, sozinha, verifica apenas a conversa.

Para outras tarefas privilegiadas, o tutorial de moderação do Discord usa o mesmo padrão de administrador verificado. Mantenha suas Actions de moderação separadas desta solução de três Actions para noites de jogos.

7. Como usar o bot na próxima noite de jogos?

Mantenha as três Actions e mude o plano. Uma segunda noite precisa de data, horário, local e ID de evento próprios e confirmados; os RSVPs anteriores pertencem ao evento anterior.

Antes de convidar todo o servidor, conclua uma vez o teste com duas contas, escolha um canal para perguntas sobre eventos e oriente os membros a mencionar @Lantern Host. Comece com um único evento verificável. Adicione recorrência ou lembretes só depois de configurá-los e testá-los separadamente.

O resultado útil é um caminho curto de “vamos jogar” até um plano compartilhado: evento com horário e local claros, link que os membros podem usar e organizador que consulta o interesse sem pesquisar todo o histórico.

Perguntas frequentes

Um bot do Discord pode criar um evento agendado?

Sim. Um bot com as permissões adequadas do Discord pode criar um Scheduled Event pela API. Este tutorial usa um evento de local externo e a permissão Create Events em todo o servidor. O Quickchat AI também restringe a Action de criação a remetentes com a permissão Administrator do Discord.

Um bot RSVP do Discord pode inscrever membros automaticamente?

A API documentada usada aqui não marca outro membro como interessado. O bot compartilha o link do evento e o membro escolhe Interested no Discord. O endpoint de usuários interessados consulta essa inscrição depois.

Interested significa que a pessoa vai comparecer?

Não. Interested registra a inscrição de um membro no evento. É útil para planejar, mas não é reserva, check-in nem garantia de presença.

Qualquer membro pode criar uma noite de jogos pelo bot?

Nesta configuração, só executa a Action de criação um remetente cuja permissão Administrator do Discord produza um valor author_is_admin verdadeiro. Um cargo chamado Admin, permissão para criar eventos ou mensagem afirmando ser administrador não passa por esse controle.

Por que o Discord retorna Missing Permissions para um pedido de administrador?

Remetente e bot têm permissões separadas. O remetente pode passar pelo controle de administrador da Action enquanto o bot não tem Create Events em todo o servidor. Verifique separadamente o registro da Action e o cargo do bot no servidor.

O bot pode enviar lembretes ou organizar noites de jogos recorrentes?

Este tutorial cria um evento e responde a pedidos sobre ele. Não agenda mensagens do bot em segundo plano nem configura recorrência. As notificações nativas de eventos do Discord permanecem separadas das mensagens do AI Agent.

Preciso de código ou de uma chave de API de AI separada?

Você configura três HTTP Actions e um Main Prompt no Quickchat AI. Precisa do seu próprio aplicativo Discord e token do bot, mas não de uma chave de API de modelo adicional nem de código de aplicativo. Respostas AI e Simulation Testing consomem créditos do Quickchat AI.

Quickchat AI Quickchat AI Ask Quickchat AI a question