Blogikirjoituksen 9 taustakuva

Ota tekoälybotti käyttöön Discordissa

Haluatko luoda älykkään keskustelevan tekoälybotin Discord-palvelimellesi? Tämä vaiheittainen opas näyttää, miten se onnistuu vain 10 minuutissa ilman koodausta!

Katso video


5 helppoa vaihetta tekoälybotin luomiseen

Näillä vaiheilla saat Discord-palvelimellesi täysin toimivan tekoälybotin:

  1. Luo Discord-palvelin
  2. Luo Discord-sovellus
  3. Lisää botti palvelimelle
  4. Luo Quickchat AI -tili
  5. Yhdistä botti Quickchat AI:hin

Tältä tekoälybottisi näyttää

Kun määritykset on tehty, botti on verkossa Discordissa ja valmis käymään luontevia keskusteluja palvelimen jäsenten kanssa.

Lopputulos: älykäs keskusteleva tekoäly


Nopein tapa: käyttöönotto yhdellä napsautuksella

Jos sinulla on jo Quickchat AI -tili, voit ohittaa Developer Portalin kokonaan. Avaa hallintapaneelin vasemmasta sivupalkista External Apps, valitse Discord ja napsauta Connect-kohdassa Add to your Discord server.

Quickchat AI:n Discord-yhteyden näkymä ja Add to your Discord server -painike Yhden napsautuksen yhteys kohdassa External Apps → Discord.

Discord pyytää valtuuttamaan jaetun Quickchat AI -sovelluksen ja valitsemaan palvelimen. Napsauta Authorize, niin botti on käytössä ja jäsenet voivat @mainita sen missä tahansa kanavassa. Tarvitset valitulla palvelimella Hallitse palvelinta -oikeuden.

Uudet Quickchat AI -käyttäjät saavat Discordin ilmeeseen mukautetun aloitusnäkymän, joka vie suoraan tähän käyttöönottoon.

Discordin ilmeeseen mukautettu aloitusnäkymä uusille Quickchat AI -käyttäjille Uusien käyttäjien aloitusnäkymä ohjaa yhdistämiseen yhdellä napsautuksella.

Alla olevat vaiheet kuvaavat manuaalisen vaihtoehdon Use your own Discord app: luot oman Discord-sovelluksen ja yhdistät sen botin tokenilla. Käytä tätä tapaa, jos haluat oman nimen ja avatarin, yksityisviestit, Discord AI Actions -toiminnot tai useita botteja samalle palvelimelle. Discord Actions tarvitsee oman bottisi yhteyden, koska siitä saadaan Discordin API-pyyntöihin käytettävä token.


1. Luo Discord-palvelin

Jos sinulla ei ole Discord-tiliä, luo sellainen osoitteessa discord.com. Luo sitten ensimmäinen palvelimesi:

Luo ensimmäinen palvelimesi


2. Luo Discord-sovellus

Avaa Discord Developer Portal ja luo uusi sovellus.

Luo uusi sovellus


3. Lisää botti Discord-palvelimelle

Muista sallia botille viestien sisällön vastaanottaminen ottamalla alla oleva asetus käyttöön:

Ota viestien sisältö käyttöön

Kun botti on luotu, lisää se palvelimelle. Muodosta Discord-URL ja liitä se selaimeen:

https://discord.com/api/oauth2/authorize?client_id=<YOUR CLIENT ID>&permissions=309237713920&scope=bot

Mistä käyttöoikeusnumero tulee?

Numero (309237713920) vastaa seuraavia käyttöoikeuksia:

  • View Channels
  • Send Messages
  • Create Public Threads
  • Send Messages in Threads
  • Read Message History

Ne ovat botin toiminnan edellyttämät vähimmäisoikeudet. Voit tarkistaa ne osoitteessa discord.com/developers/applications: valitse sovelluksesi, napsauta vasemmalta Bot ja vieritä alas:

Discord-botin käyttöoikeudet

Mistä löydät YOUR CLIENT ID -tunnuksen?

Helpoin tapa on kopioida selaimen osoiterivillä näkyvä pitkä numero:

https://discord.com/developers/applications/<YOUR CLIENT ID>/bot

Oma client ID -tunnuksesi

Tässä client ID on 1234567890123456789, joten koko osoite botin lisäämiseen on:

https://discord.com/api/oauth2/authorize?client_id=1234567890123456789&permissions=309237713920&scope=bot

Jos tässä vaiheessa tulee ongelmia:

  • “Integration requires code grant”: sovelluksessa on käytössä Require OAuth2 Code Grant. Avaa sovellus Developer Portalissa, siirry kohtaan Bot, poista asetus käytöstä, tallenna ja avaa kutsulinkki uudelleen. (lisätietoja)
  • Näkyviin tulee kakku / “baked”-näkymä: se on Discordin onnistumisilmoitus. Botti on lisätty. Tarkista kohdasta Palvelimen asetukset → Integraatiot → Botit ja sovellukset.
  • Vinkki: kun liität botin tokenin Quickchat AI:hin vaiheessa 5, Discord-integraatio muodostaa kutsulinkin puolestasi ja näyttää tarkistuslistan. Silloin URL:ää ei tarvitse rakentaa käsin.

4. Luo Quickchat AI -tili

Rekisteröidy Quickchat AI:hin ja anna botillesi ihmismäisesti keskusteleva tekoäly.

Quickchat AI:n avulla voit luoda tekoälyagentteja, joilla on omat tietopohjat, AI Actions -toiminnot ja paljon muuta. Ne sopivat Discord-boteiksi, verkkosivuille ja muihin kanaviin.


5. Yhdistä botti Quickchat AI:hin

Hae Discord Bot Token Developer Portalista, jotta voit yhdistää botin Quickchat AI:hin.

  1. Avaa Bot SettingsReset TokenCopy Token

Nollaa token

  1. Avaa Quickchat AI:n hallintapaneelissa External Apps → Discord, valitse Use your own Discord app ja liitä token. Quickchat AI käynnistää botin ja näyttää sen tilan käynnistyksen aikana.

Liitä token

Jos botti ei tule verkkoon

Jos käynnistys epäonnistuu, Discord-integraatio näyttää tarkan virheen ja linkin ratkaisuun. Kaksi tavallisinta syytä ovat:

  • Virheellinen token: token on väärä tai luotu uudelleen. Nollaus mitätöi aiemman tokenin. Avaa botti Developer Portalissa, valitse Bot → Reset Token, kopioi uusi token ja liitä se Quickchat AI:ssa Reconnect-painikkeella. Katso tarkka kuvakaappaus kohdasta Virheellinen botin token.
  • Message Content Intent ei ole käytössä (virhe PrivilegedIntentsRequired): botti on yhdistetty, mutta ei voi lukea viestejä. Avaa botti Developer Portalissa, siirry kohtaan Bot → Privileged Gateway Intents, ota Message Content Intent käyttöön ja tallenna. Katso oikea asetus kohdasta Message Content Intent.

Botti käynnistyy uudelleen, kun tokenia tai asetuksia muutetaan. Odota enintään minuutti, että se tulee verkkoon.

Jos oma bottisi on verkossa mutta ei koskaan vastaa

Tarkista, onko samalla palvelimella edelleen yhdellä napsautuksella lisätty jaettu Quickchat AI -botti. Kun molemmat ovat palvelimella, jaettu botti vastaa ja oma bottisi pysyy hiljaa, vaikka token, intentit ja oikeudet olisivat kunnossa. Avaa External Apps, etsi palvelin yhden napsautuksen asetusten Connected servers -kohdasta ja poista se sieltä. Oma bottisi ottaa heti vastuun. Katso Molemmat botit samalla palvelimella.


Tekoälybottisi on käytössä!

Palaa Discordiin. Botti on nyt verkossa ja valmis keskustelemaan. Aloita @mainitsemalla se.

Aktiivinen botti

Kun botti @mainitaan, se vastaa oletuksena kanavassa. Jos valitset Reply in -asetukseksi Thread, botti luo ketjun, jossa keskustelua voi jatkaa mainitsematta sitä uudelleen.

Keskustelu ketjussa


Miten botti vastaa

Botin voi aktivoida useilla tavoilla, jotka käsittelevät keskusteluhistoriaa eri tavoin:

TilanneAktivointiKeskusteluhistoria
@maininta kanavassa@Mainitse botti tekstikanavassaRiippuu Reply in -asetuksesta (katso alla)
Viesti botin ketjussaKirjoita botin luomaan ketjuunKoko ketjun historia säilyy
Vastaus botin viestiinKäytä Discordin vastaustoimintoa botin viestiinUusi keskustelu joka kerta
/ask-komentoKirjoita /ask ja kysymys, vain jaetulla botillaUusi keskustelu joka kerta
YksityisviestiLähetä botille DM, vain omalla sovelluksellaSäilyy koko yksityisviesti-istunnon ajan

Tavallinen kanavaviesti ei aktivoi mitään. Se on tarkoituksellista, jotta botti pysyy hiljaa vilkkaalla palvelimella, ja yleisin syy siihen, että juuri lisätty botti vaikuttaa rikkinäiseltä. /ask on osin helpommin löydettävä vaihtoehto: kirjoita / kanavaan, niin komento näkyy. Se toimii myös silloin, kun viestien sisältö on rajoitettu. Komento on rekisteröity jaetulle botille, joten omalla sovelluksella käytetään @mainintoja.

Reply in -asetus

Quickchatin kohdassa Channels > External Apps > Discord on “Reply in:“-valikko, jossa on kaksi vaihtoehtoa:

  • Channel (oletus): botti vastaa kanavassa, jossa se mainittiin. Jokainen @maininta aloittaa uuden keskustelun ilman aiempien vuorovaikutusten muistia.
  • Thread: botti luo ketjun jokaista @mainintaa varten. Ketju nimetään botin ja käyttäjän mukaan, esimerkiksi “Aria & john_doe”. Siinä botti vastaa kaikkiin viesteihin ilman @mainintaa ja säilyttää koko historian.

Yksityisviestit

DM-viestit vaativat oman Discord-sovelluksen. Jaettu botti vastaa vain palvelimilla, sillä yhteiseen identiteettiin lähetettyihin pyytämättömiin yksityisviesteihin vastaaminen vaikuttaisi kaikkiin sen palvelemiin palvelimiin.

Omalla sovelluksella DM ei vaadi @mainintaa. Botti vastaa kaikkiin viesteihin, ja historia säilyy istunnon ajan. Vastatessaan yksityisviesteihin botti ei pääse palvelinkanavien historiaan.

Huomautus: botti vastaa vain itse luomissaan ketjuissa. Jos joku luo ketjun käsin ja kirjoittaa siihen, botti ei vastaa.


Miten botti ymmärtää kanavan asiayhteyden

Kun joku @mainitsee botin, se ei näe vain mainintaviestiä. Botti hakee automaattisesti kanavan tuoreimmat viestit ja lisää ne tekoälyn kehotteeseen aikaleimattuna keskusteluna. Näin se ymmärtää meneillään olevan keskustelun ja voi viitata aiempaan.

Tältä asiayhteys voi näyttää tekoälylle:

Most recent messages on the #general channel:
[2026-02-19 14:01] alice: Has anyone tried the new API endpoint?
[2026-02-19 14:03] bob: Yeah, I got a 429 back after about 50 requests
[2026-02-19 14:05] alice: @QuickchatBot what's the rate limit for the v2 API?

Botti lukee myös kanavan aktiivisten ja arkistoitujen ketjujen viestejä, joten niiden keskustelut ovat mukana.

Kun joku vastaa tiettyyn viestiin Discordin vastaustoiminnolla, botti rajaa asiayhteyden heti sen ympärillä oleviin viesteihin koko tuoreen historian sijasta. Se saa täsmällistä taustaa juuri käyttäjän tarkoittamaan keskusteluun.

Erikoissisällöt, kuten tarrat, GIF-kuvat, kuvat, upotukset ja reaktiot, esitetään merkintöinä. Botti tietää niistä, vaikka se ei näe niitä kuvallisesti keskustelutekstissä. @mainintojen tunnisteet korvataan luettavilla näyttönimillä.

Asetuksia ei tarvita. Kanavan asiayhteys on oletuksena käytössä kaikilla Quickchat AI:n Discord-boteilla.

Botti vastaa jatkokysymykseen kanavan asiayhteyden avulla

Älykäs tekoälyhaku palvelimen historiasta

Oletuksena botti lukee vain kanavaa, jossa se mainittiin. Kun Smart AI search over server history on käytössä, tekoäly voi hakea viestejä mistä tahansa palvelimen tekstikanavasta. Se valitsee kanavan kysymyksen perusteella.

Jos joku kysyy #general-kanavassa “mihin #engineering-kanavassa päädyttiin siirron suhteen?”, botti voi lukea #engineering-kanavaa ja vastata löytämänsä perusteella.

Toiminto tukee aikavälisuodatusta ja sivutusta, joten tekoäly voi tarvittaessa hakea kauempaa historiasta.

TilaLaajuusSopii parhaiten
OletusVain nykyinen kanavaYleiskäyttöinen yhteisöbotti
Smart AI search over server historyKaikki palvelimen kanavatTukibotit ja tiedonhaku kanavien välillä

Huomautus: Smart AI search over server history on beetavaiheessa. Jos olet kiinnostunut, ota yhteyttä sähköpostitse tai Quickchatin Discord-palvelimella.

Smart AI search over server history Discord-integraation asetuksissa


Kuvien lähettäminen botille

Käyttäjä voi liittää kuvan @mainitessaan botin. Tekoäly käsittelee sen kuvantunnistuskyvyillään. Tuettuja ovat PNG, JPG, JPEG, GIF ja WebP. Jos kuvia on useita, botti käsittelee ensimmäisen.

Kuvan URL Discordin CDN:stä lähetetään viestitekstin kanssa mallille monimuotoisena syötteenä. Tekoäly näkee tekstin ja kuvan samalla vuorolla. Asetuksia ei tarvita: kuvien ymmärtäminen on oletuksena käytössä.

Käytännön esimerkkejä Discord-yhteisöille:

  • Kehittäjäyhteisö: käyttäjä lähettää kuvakaappauksen pinolistauksesta tai virheilmoituksesta ja pyytää selitystä.
  • Suunnitteluyhteisö: käyttäjä jakaa käyttöliittymäluonnoksen ja pyytää palautetta.
  • Peliyhteisö: käyttäjä lähettää kuvan pelin asetuksista ja pyytää optimointivinkkejä.
  • Verkkokaupan tuki: asiakas lähettää tukibotille kuvan viallisesta tuotteesta.

Käyttäjä lähettää kuvakaappauksen, jonka botti analysoi vastatakseen kysymykseen


AI Actions -toimintojen yhdistäminen Discordiin

AI Actions antaa botin kutsua ulkoisia API-rajapintoja ja työkaluja keskustelun aikana. Toiminnot määritetään kerran Quickchatin kohdassa AI Agent > Actions & MCPs, ja ne toimivat kaikissa kanavissa, kuten Discordissa, verkkosivuwidgetissä, WhatsAppissa ja Telegramissa.

Saatavilla on kaksi toimintotyyppiä:

TyyppiMitä se tekee
API ActionLähettää HTTP-pyyntöjä (GET, POST, PUT, DELETE) ulkoisiin päätepisteisiin määritettävillä parametreilla, otsakkeilla ja rungolla
Remote MCPYhdistää Model Context Protocol -palvelimeen ulkoisia työkaluja ja tietolähteitä varten

Esimerkkejä toteutuksista Discordiin:

  • Tilausseuranta: yhdistä API Action verkkokaupan taustajärjestelmään, jotta jäsenet voivat kysyä “missä tilaus #12345 on?” ja saada ajantasaisen tilan.
  • GitHub-botti: yhdistä Remote MCP repositorioosi, jotta kehittäjät voivat kysyä “onko avoimia virheitä tunnisteella critical?” suoraan Discordissa.
  • Tukipyyntöbotti: vastaa dokumentaatiosta ja avaa yksityinen tukipyyntöketju, jossa mainitaan tukirooli, vain ratkaisemattomille asioille.
  • Moderointiapu: valitse timeout-, kick-, ban- ja slowmode-mallit, jotta moderaattorit voivat käyttää niitä luonnollisella kielellä.
  • Tapaamisten varaus: yhdistä Remote MCP Cal.comiin tai Google Calendariin, jotta käyttäjät voivat varata tapaamisia Discordissa.
  • CRM-integraatio: yhdistä HubSpot liidien kirjaamiseen tai tukipyyntöjen luomiseen keskusteluista.
  • Liidit ja palaute: yhdistä Google Sheets, jotta botti tallentaa liidit, vastaamattomat kysymykset ja demopyynnöt tiimin käyttämään taulukkoon.

API Action -toiminnon määrittäminen

  1. Avaa Quickchatissa AI Agent > Actions & MCPs.
  2. Napsauta Add Action. Valitse tuettua Discord-operaatiota varten Discord Action ja malli. Tukimalli kysyy palvelimen, kanavan ja roolin; moderointimallit asentuvat suoraan. Quickchat luo muokattavan pyynnön, kuvauksen, parametrit, vastauksen käsittelyn ja suoritusehdot.
  3. Valitse mukautettu HTTP Request vain, jos tarvitsemasi päätepiste puuttuu galleriasta. Nimeä toiminto esimerkiksi “Tarkista tilauksen tila” ja kuvaa käyttö: “Käytä, kun käyttäjä kysyy tilauksen tilaa. Pyydä ensin tilausnumero.”
  4. Määritä HTTP-metodi, esimerkiksi GET, päätepisteen URL ja parametrit, ja tallenna.

Toiminto on nyt käytettävissä tuetuissa kanavissa. Gallerian Discord Actions -toiminnot ovat tavallisia muokattavia HTTP Request -toimintoja, joten tarkista valtuutus, kohteet ja parametrit muutosten jälkeen. Lue lisää HubSpot AI Actions -oppaasta, Discordin moderointibottioppaasta, joka käsittelee timeoutia, poistamista, porttikieltoja, rooleja ja slowmodea, tai Actions-dokumentaatiosta.

Quickchatin Actions & MCPs -sivu, jossa on määritetty API Action


Lue lisää

Nämä oppaat käsittelevät aiheeseen liittyviä toimintoja tarkemmin:


Rekisteröidy Quickchat AI:hin ja aloita tekoälyagenttisi luominen tai liity Discord-yhteisöön: discord.gg/KqkHwvPRNH