Telegram AI -chatbot: ryhmät ja yksityisviestit ilman koodia

Telegram AI -chatbot voi vastata kysymyksiin yrityksesi tietojen perusteella ryhmässä tai yksityiskeskustelussa. Quickchat AI yhdistää AI Agentin Telegramiin yhteisen botin kautta: lisää botti ryhmään, vahvista yhteys hallintapaneelissa, ja jäsenet voivat esittää kysymyksiä mainitsemalla botin. Tähän tapaan et tarvitse koodia tai BotFather-tokenia.

Tässä oppaassa rakennamme Saltmarsh Sailing Schoolin, kuvitteellisen purjehduskoulun, jolla on jäsenryhmä ja yksityisiä tiedusteluja. Kaksi agenttia käyttää samoja koulun tietoja: Saltmarsh Group vastaa julkisiin kysymyksiin, kun taas Saltmarsh Sailing School käsittelee yksityisiä kokeilutuntipyyntöjä ja ottaa ihmisen mukaan palautusasioihin. Pyyntö on tiedustelu toimistolle, ei vahvistettu varaus.

Kaksi agenttia pitää vastuut erillään. Ryhmäagentilla ei ole siirto- tai tiedonkeruu-Actionia; yksityisagentti käsittelee pyynnöt ja henkilökunnan vastaukset.

Seuraa alla olevaa polkua. Google Sheets -laajennus on valinnainen; voit ensin toteuttaa vastaamisen ja siirron ihmiselle.

Lataa Saltmarsh Telegram -paketti, joka sisältää tarkat tiedot, Main Promptin, Action-asetukset, arviointikriteerit ja testiviestit. Ne ovat muokattavia tiedostoja seuraaviin vaiheisiin, eivät agentin tuonti yhdellä napsautuksella.

Suoritettavat tiedostot, tarkat testiviestit ja kuvakaappaukset ovat englanniksi, jotta voit toistaa vaiheet ja tulokset.

Mitä tarvitset Telegram-chatbotin luomiseen?

Tarvitset Quickchat AI -tilin, kaksi agenttia ja Telegram-tilin, jolla on lupa lisätä botti testiryhmään. Valinnainen pyyntöjen tallennus vaatii myös Google-tilin, jolla voi valtuuttaa Google Sheetsin.

1. Luo Quickchat AI -tili ja vahvista sähköpostiosoite pyydettäessä. Free tukee henkilökohtaista, ei-kaupallista oppimista. Tilaukset koskevat yhtä agenttia kerrallaan, joten molempia käyttävä yritys tarvitsee kummallekin sopivan kaupallisen tilauksen. Preview ja Simulation kuluttavat AI-krediittejä. Katso nykyiset tilaukset.
2. Luo Telegram-ryhmä nimeltä Saltmarsh Members. Käytä testiryhmää, jotta voit tarkistaa maininnat, vastaamatta jättämisen ja jatkoviestit ennen asiakkaiden kutsumista.
3. Käytä tässä oppaassa omaa Telegram-tiliäsi myös kävijän viestien lähettämiseen. Voit samalla käyttää Quickchat AI:n Inboxia. Pyydä ennen asiakkaiden kutsumista kollegaa tarkistamaan käyttökokemus toiselta tililtä.
4. Pura paketti. Pidä koulun esimerkkitiedot yhdessä; korvaa ne omilla tarkistetuilla käytännöilläsi ennen käyttöönottoa.

Quickchat Appin kuvakaappaukset näyttävät paikallisesti toimivan sovelluksen, jossa on kuvitteellinen Saltmarsh-kokoonpano; yhteyksien esimerkkitiedot on merkitty kuvateksteihin. Telegramin ja Google Sheetsin kuvakaappaukset näyttävät yhdistetyn demon todelliset vastaukset ja tallennetun tiedustelun. Henkilökohtaiset tilitiedot on rajattu pois tai peitetty selvästi. Toista tarkistukset lopun tarkistuslistan avulla omilla tiedoillasi ja yhdistetyillä tileilläsi.

Vaihe 1: Miten opetat Telegram-chatbotille yrityksesi tiedot?

Anna agentille yrityksen faktat Knowledge Base -osiossa ja toimintaohjeet Main Prompt -kentässä. Näiden tehtävien erottaminen helpottaa vastauksen korjaamista muuttamatta agentin toimintatapaa.

Hinnat ja käytännöt ovat lähdetietoja. Tiiviys, epävarmuus ja keskustelun ohjaus ovat ohjeita.

Luo agentti ja lisää sen tiedot

1. Valitse uudella tilillä Set up manually. Valitse olemassa olevalla tilillä ensin Add new AI Agent ja sitten manuaalinen tapa.
2. Kirjoita Identity-sivun Name your AI Agent -kenttään Saltmarsh Group. Liitä paketin group-main-prompt.txt kohtaan Describe what you want your agent to do.
3. Jatka asetuksia yhdistämättä vielä ulkoisia sovelluksia. Viimeistele tilausvaihe ja käytä Skip for now -valintaa, jos aloitat oppimiseen tarkoitetulla tilillä.
4. Avaa Knowledge Base > Add Article. Kirjoita Courses and trial enquiries kohtaan Create custom article, valitse Create article, liitä saltmarsh-courses.txt kohtaan Content ja valitse Save.
5. Toista tämä artikkelille Weather, parking and personal enquiries käyttäen tiedostoa saltmarsh-policies.txt. Odota, kunnes molemmissa artikkeleissa näkyy Ready.
6. Avaa Saltmarsh Group -agentin Actions & MCPs. Pidä Human Handoff poissa käytöstä äläkä lisää kokeilutuntipyyntöjen Actionia.
7. Valitse Add new AI Agent ja toista manuaalinen käyttöönotto agentille Saltmarsh Sailing School käyttäen tiedostoa main-prompt.txt ja samoja kahta tietotiedostoa. Toinen agentti käsittelee yksityiskeskustelut. Valitse oikea agentti tilivalitsimesta ennen asetusten muuttamista.

Kaksi lyhyttä lähdettä osoittaa selvästi, mitä tietoja agentilla on. Ready on tarkistuspiste ennen tietotestiä.

Märkäpukujen vuokrausta koskeva tieto puuttuu tarkoituksella. Oikea vastaus on, ettei agentti voi vahvistaa asiaa, ei keksitty kyllä tai ei. Sääkäytäntö ei myöskään kerro tämän päivän ennustetta, eikä yksityistunnin hinta määritä kokeilutunnin hintaa.

Määritä Main Prompt ja tarkista vastaus

1. Avaa kummankin agentin Identity > Main Prompt ja tarkista vastaava Saltmarsh-prompt. Ryhmäprompt vastaa yleisiin kysymyksiin ja ohjaa ryhmään kiinnitettyyn yksityislinkkiin; yksityisprompt kerää tiedusteluja ja käyttää Human Handoffia.
2. Avaa AI Preview ja kysy How much is Start Sailing?. Tarkista, että vastaus kertoo kaksi päivää ja EUR 240.
3. Kysy Do you rent wetsuits?. Tarkista, että vastaus myöntää tiedon puuttuvan.

Yksityisagentin prompt määrittää tiedonkeruun ja siirron. Ryhmäagentti käyttää erillistä promptia ja pitää molemmat Actions-toiminnot poissa käytöstä.

Kaksi rajausta ryhmäagentin todellisista asetuksista. Se voi vastata tietokysymyksiin, mutta sillä ei ole suoritettavaa tiedonkeruu- tai siirto-Actionia.

Kaksi agenttia tekee ohjauksesta selkeän. Ryhmäagentti ei voi käynnistää siirtoa vahingossa; yksityisagentti voi siirtää palautuspyynnön pysäyttämättä ryhmää. Preview tarkistaa koulun tiedot, ja seuraavat vaiheet varmistavat kummankin Telegram-yhteyden.

Vaihe 2: Miten lisäät AI-chatbotin Telegram-ryhmään?

Avaa External Apps > Telegram, lisää yhteinen botti ryhmääsi ja palaa Quickchat AI:hin valitsemaan ryhmälle Confirm. Agentti pysyy ryhmässä hiljaa, kunnes vahvistat sen.

Telegram-jäsenyys ja Quickchat AI -vahvistus ovat erilliset vaiheet.

1. Valitse agenttivalitsimesta Saltmarsh Group. Avaa External Apps, valitse Telegram ja etsi Quickchat AI bot.
2. Valitse Add to a Telegram group. Valitse Telegramissa Saltmarsh Members ja hyväksy botin lisääminen.
3. Palaa Quickchat AI:hin. Tarkista ryhmän nimi ja Added by -tiedot kohdassa Waiting for your confirmation.
4. Valitse odotetulle ryhmälle Confirm. Sen pitäisi siirtyä Connected chats -kohtaan kytkin päällä.
5. Kirjoita Telegramissa @ ja valitse botti mainintaluettelosta. Kysy How much is Start Sailing?. Yhteisen botin käyttäjätunnus on yleensä @QuickchatAI_bot; käytä ryhmässäsi näkyvää todellista käyttäjätunnusta.
6. Vastaa suoraan tähän vastaukseen viestillä What should I bring?. Lähetä sitten erillinen viesti ilman mainintaa: Does anyone know the gate code?. Yhteisen botin pitäisi vastata vastaukseen ja pysyä hiljaa tavallisen viestin kohdalla.

Valitse Telegramissa Saltmarsh Members ja palaa sitten Quickchat AI:hin vahvistamaan yhteys.

Todellinen paikallinen käyttöliittymä ja ennalta luotu ryhmätestidata näyttävät Confirm-painikkeen sijainnin. Kuva havainnollistaa toimintoa; se ei todista Telegramin liittyneen oikeaan ryhmään.

Vahvistettu ryhmä sai odotetun vastauksen kurssista. Mainitse botti sen todellisella käyttäjänimellä.

Botin viestiin vastaaminen toimii ilman uutta mainintaa. Vastaus luettelee annetut varustetiedot.

Vahvistus on tärkeä, koska kutsun tiedot näkyvät ryhmässä. Quickchat AI vaatii tilin puolelta päätöksen ennen kuin se käsittelee ryhmää agenttisi kohteena. Älä vahvista ryhmää, jota et tunnista. Telegram-yhteyden dokumentaatio selittää saman rajan.

Tee vahvistus loppuun ennen kuin poistut asetuksista. Jos botti poistuu vahvistamattomasta ryhmästä, luo uusi linkki valitsemalla Add to a Telegram group, lisää botti uudelleen ja vahvista odottava ryhmä heti Quickchat AI:ssa. Botin lisääminen Telegramin jäsenhaulla ei korvaa tätä yhdistämistapaa.

Admin-merkki kertoo botin tilan Telegramissa. Sitä ei vaadita yhteisen botin tavallisiin vastauksiin. Yhteisen botin tekeminen ylläpitäjäksi ei myöskään muuta maininta- tai vastaussääntöä.

Vaihe 3: Miten otat yksityiset Telegram-keskustelut käyttöön?

Ota Direct message link käyttöön ja jaa koko luotu URL. Linkki valitsee agenttisi yhteisen Telegram-botin sisällä, joten asiakkaat voivat kysyä yksityisesti lisäämättä sitä ryhmään.

Ryhmä on yhteinen keskustelu. Siirrä henkilötiedot ja siirrot henkilökunnalle yksityisviesteihin.

1. Valitse yksityisagentti Saltmarsh Sailing School. Avaa External Apps > Telegram ja ota Direct message link käyttöön. Jätä sen ryhmäyhteydet tyhjiksi.
2. Kopioi luotu linkki. Säilytä sen start=-parametri; pelkkä yhteisen botin linkki ei yksilöi agenttiasi.
3. Avaa se Telegramissa ja paina Start, jos sitä pyydetään.
4. Kysy How much is Start Sailing? mainitsematta bottia. Varmista koulun vastaus ja etsi keskustelu Inbox-osiosta.
5. Kiinnitä linkki ryhmän tervetuloviestiin, jotta ihmiset löytävät sen ennen henkilötietojen jakamista.

Käytä omalle agentillesi luotua linkkiä. Tässä näkyvä paikallinen kokoonpano ei ole vahvistus Telegram-toimituksesta.

Telegram toimitti Saltmarshin tervetuloviestin Start-valinnan jälkeen. Tarkista seuraavaksi tietoihin perustuva vastaus; pelkkä tervehdys ei testaa tiedonhakua.

Kaksi rajausta samasta Telegram-näkymästä näyttää kiinnitetyn kutsun. Demolinkin start-arvo on jätetty pois; kiinnitä oma kokonainen luotu linkkisi.

Yksityiskeskustelu yhteisen botin kanssa on sidottu yhteen agenttiin kerrallaan. Toisen agentin yksityislinkin avaaminen voi vaihtaa sidonnan. Jos haluat oman Telegram-identiteetin ja erillisen bottikeskustelun, käytä oman botin tapaa.

Kun Direct message link poistetaan käytöstä, linkin kautta ei synny uusia yhteyksiä. Lopeta jo olemassa oleva yhdistetty keskustelu sen omalla kytkimellä tai Disconnect-toiminnolla. Pidä linkkiä julkisena sisäänkäyntinä, älä luottamuksellisten tietojen pääsyrajoituksena.

Vaihe 4: Miten tallennat kokeilutuntipyynnön Google Sheetsiin?

Google Sheets -integraatio luo laskentataulukon ja rivejä lisäävän Actionin. Muokkaa Action tallentamaan kolme pakollista kokeilutuntipyynnön kenttää ja tarkista sitten todellinen rivi. Tämä vaihe on valinnainen ja toimii yhteisen Telegram-botin kanssa.

Tuloksena on pyyntö ihmisen jatkokäsittelyyn. Se ei varaa paikkaa eikä määritä kokeilutunnin hintaa.

Yhdistä Sheets ja määritä yksi Action

1. Avaa Saltmarsh Sailing School -agentin Actions & MCPs > Add Action > Google Sheets ja valitse Connect Google Sheets. Kirjaudu oikealle Google-tilille ja hyväksy pyydetty käyttöoikeus.
2. Avaa luotu Quickchat Leads -laskentataulukko. Säilytä välilehden nimi Leads, koska luotu Action-URL osoittaa tähän välilehteen.
3. Korvaa otsikkorivi tässä järjestyksessä arvoilla Name, Preferred weekday, Sailing experience, Conversation link, Channel.
4. Avaa Actions & MCPs ja muokkaa luotua Actionia log_lead_to_google_sheet. Käytä alla olevaa ohjetta. Muuta parametreja, pyynnön sisältöä ja taulukon otsikoita yhdessä, jotta niiden järjestys täsmää.

API Action Name

Record trial-lesson request

What to ask the user first

Aseta kaikille kolmelle parametrille No default ja poista sähköpostin ja tiedustelun oletusparametrit. Nämä kolme kenttää ovat tämän ohjeen ainoat kysymykset. Telegram-käyttäjätunnus on valinnainen eikä luotettava pakollinen yhteystietokenttä; tallennettu keskustelulinkki antaa henkilökunnalle reitin takaisin tiedusteluun.

Menetelmä ja URL: säilytä luotu POST-URL. Se sisältää jo laskentataulukon tunnuksen, Leads-välilehden ja valueInputOption=RAW. Täytettävää paikkamerkkiä laskentataulukon tunnukselle ei ole.

Otsakkeet: säilytä integraation asetukset.

Käytä API Endpointin Body-välilehdessä seuraavaa:

{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}

Lisää parametrien ja keskustelumuuttujien elementit tarvittaviin kohtiin Add AI Data -toiminnolla. Ensimmäiset kolme arvoa tulevat keskustelusta; kaksi viimeistä toimittaa Quickchat AI.

API Action Description

In a private chat only, call this once when the person has requested a trial lesson and provided their name, preferred weekday and sailing experience. Ask for the next missing required field before calling. Do not call it for general course questions, in groups, or to confirm a booking. A successful call records an enquiry for the office; it does not reserve a place.

Avaa Advanced settings > Run only when ja lisää telegram_chat_type equals private. Käytä pelkkää metadata-avainta ilman metadata_-etuliitettä tai aaltosulkeita. Tämä estää HTTP-pyynnön suorittamisen ryhmäviestille, vaikka malli yrittäisi sitä. Suoritusehdon dokumentaatio selittää tarkistuksen.

Aseta Response filter arvoon $.updates.updatedRows, jotta Action palauttaa rivimäärän tarpeettoman palveluntarjoajan vastauksen sijaan. Pidä Action käytössä.

Avain on telegram_chat_type. Ehto tarkistetaan ennen pyynnön lähettämistä.

Pyynnön paikallinen kokoonpano. Luodun Sheets-URL:n ja OAuth-valtuutuksen täytyy tulla omasta Google-yhteydestäsi.

Tarkista rivi ja sitten puutteellinen pyyntö

Lähetä tämä agentin yksityisen Telegram-linkin kautta:

I am Alex Morgan. I want a trial on Tuesday. I am a beginner.

Tarkista kaikki kolme paikkaa: vastaus kuvaa pyyntöä, Inboxin Action-kortti näyttää annetut arvot ja todellinen Leads-välilehti sisältää vastaavan rivin. Rauhoittava vastaus tai korkea Simulation-pistemäärä ei todista, että Google Sheets vastaanotti kirjoituksen.

Agent tallensi annetun nimen, tiistaitoiveen ja aloittelijan kokemustason. Toimiston on vielä vahvistettava saatavuus ja tarkka hinta.

Saman tallennetun rivin kaksi yksityiskohtaa pitävät kaikki viisi saraketta luettavina. Tilikohtainen keskustelulinkki on peitetty; muut neljä arvoa ovat ennallaan.

Aloita erillinen testi viestillä I would like a trial lesson. Agentin pitäisi kysyä puuttuvat kentät yksi kerrallaan ennen Actionin suorittamista. Kokeile myös How much is Start Sailing?; tavallinen kurssikysymys ei saa luoda riviä. Prompt pyytää yhtä kirjoitusta pyyntöä kohti, mutta tämä rivejä lisäävä ohje ei ole idempotentti varausjärjestelmä. Tarkista kaksoiskappaleet ennen käyttöä päivittäisten pyyntöjen vastaanottoon.

Vaihe 5: Miten siirrät Telegram-keskustelun ihmiselle?

Määritä Human Handoff ja varmista sitten keskustelun vastuutaho Inbox-osiossa. Prompt, jossa sanotaan toimiston vastaavan, ei itsessään siirrä vastuuta tai keskeytä AI:n toimintaa.

Vastuutahon muutos on tarkistuspiste. Anna ihmisen hoitaa asia loppuun; varmista mahdollinen palautus AI:lle erikseen.

1. Valitse Saltmarsh Sailing School, avaa Actions & MCPs > Human Handoff ja ota se käyttöön. Pidä tämä Action poissa käytöstä Saltmarsh Group -agentissa.
2. Valitse Handoff Rules -kohdassa +. Anna Rule Name -arvoksi Private enquiries, liitä handoff-rule.txt Description-kenttään ja kytke State päälle. Uudet rivit ovat aluksi pois käytöstä. Sääntö kattaa palautukset, valitukset, pyynnöt ihmisestä ja ihmisen avun hyväksymisen tässä yksityisagentissa.
3. Tyhjennä Keywords ja poista tämän esimerkin valmiit säännöt käytöstä, jotta vain yksi oma sääntö jää aktiiviseksi. Tallenna sitten. Ryhmän eristys perustuu siihen, että Human Handoff on pois käytöstä erillisessä ryhmäagentissa; oma sääntö kuvaa, milloin yksityisagentin pitäisi siirtää keskustelu.
4. Aseta Confirmation arvoon I have passed this private conversation to the Saltmarsh office. A member of staff can reply here. Määritä Human Agents’ availability tiimin todellisten palveluaikojen mukaan ja anna rehellinen viesti niiden ulkopuolelle.
5. Lähetä yksityisestä Telegram-keskustelusta I want a refund for last week. Can I speak to a person?.
6. Etsi keskustelu Inbox-osiosta, tarkista vastuutaho, valitse Assign to me ja lähetä Hi, I’m Alex from the office. I’ll review your request. Tarkista, että viesti saapuu Telegramiin.
7. Lähetä uusi asiakasviesti ihmisen ollessa keskustelun vastuuhenkilö. AI:n pitäisi pysyä hiljaa. Anna työntekijän hoitaa asia loppuun ja ratkaista se Inboxissa. Käsittele palautus AI:lle erillisenä testinä.

Oman säännön State on päällä. Valmiit laukaisimet ovat pois käytöstä, joten tarkistettavana on yksi sääntö.

Todellinen Telegram-pyyntö käynnisti Handoffin. Inboxin vastuun määritys ja työntekijän lähettämä vastaus tarkistettiin erikseen.

Todellisessa tarkistuksessa keskustelu siirtyi Unassigned-tilaan odottamaan ihmistä. Työntekijä valitsi Assign to me, lähetti toimiston vastauksen, ja Telegram hyväksyi sen. Yllä oleva kuvakaappaus näyttää siirtovastauksen, ei työntekijän myöhempää viestiä. Tarkista sekä vastuun määritys että toimitus, kun toistat testin.

Pidä asia työntekijällä, kunnes se on ratkaistu. Paikallisessa palautustestissämme palautus AI Agent -tilaan mahdollisti yhden vastauksen ennen kuin Handoff käynnistyi uudelleen. Paluu AI:lle tarvitsee oman onnistuneen jatkotestinsä; se ei kuulu tämän työnkulun valmistumiskriteereihin. Ihmiselle siirtämisen opas käsittelee henkilöstöä ja vastuuta tarkemmin.

Vaihe 6: Miten testaat koko Telegram-chatbotin?

Käytä Testing-toimintoa toistettaviin vastaustarkistuksiin ja varmista sitten todelliset Telegram-polut ja ulkoiset vaikutukset erikseen. Malli voi vastata oikein, vaikka ryhmäyhteys, laskentataulukkoon kirjoittaminen tai viestin toimitus siirron jälkeen toimisi väärin.

Tarkista tuloksesta vastaava järjestelmä: tietolähteet faktoille, Action-lokit pyynnöille, Sheets riveille ja Telegram toimitukselle.

Suorita toistettava vastaustestien aineisto

1. Avaa Testing, luo aineisto nimeltä Saltmarsh: knowledge checks ja valitse Paste messages.
2. Liitä simulation-messages.txt. Säilytä tapausten väliset erilliset ----erottimet.
3. Avaa Evaluation criteria, liitä paketin evaluation-criteria.txt ja tallenna.
4. Valitse Run > Start Run ja tarkastele yksittäisiä vastauksia pisteiden lisäksi.

Säilytä samat kysymykset, kun muutat yhtä ohjetta, jotta vertailu pysyy hyödyllisenä.

Lue vastaukset pisteiden lisäksi. Nämä ovat paikallisia tietotestejä, eivät Telegram-toimitustestejä.

Arvioija tarvitsee koulun faktat arvioidakseen oikeellisuutta. Sen on myös tiedettävä, ettei keskusteluteksti todista laskentataulukon riviä, Telegram-toimitusta tai vastuutahon muutosta. Tavallinen tekstipohjainen Simulation ei anna Telegram-keskustelun metadataa, joten yksityiskeskusteluihin rajaavaa Action-ehtoa ei pidä tulkita rikkoutuneeksi metadatan puuttuessa. Suorita kanavasta riippuvat tarkistukset oikeassa yksityiskeskustelussa.

Mitä paikalliset testit muuttivat?

Alkuperäinen toteutus käytti yhtä Agentia molemmille sisääntuloille. Paikallinen testi osoitti, että ryhmän palautuspyyntö siirsi yhteisen keskustelun Human Handoffiin. Erottelimme Agentit ja poistimme ryhmä-Agentilta sekä Handoffin että pyyntöjä tallentavat Actions-toiminnot. Kun toistimme ryhmän palautus- ja kokeilutuntitestit, vastaukset ohjasivat kiinnitettyyn yksityislinkkiin ja keskustelu pysyi AI:n vastuulla. Siksi vaihe 1 erottaa keskustelut sekä asetuksilla että ohjeilla.

Kymmenen viimeistä paikallista tietotestiä sai kukin 5/5 pistettä, ja molemmat pilvipalvelun Agentit läpäisivät samat kymmenen tapausta. Nämä pienet testiajot eivät arvioi tuotantokäytön tarkkuutta. Todellinen ryhmä vastasi myös kurssin hintaa ja pakkauslistaa koskeviin kysymyksiin ja jätti sen jälkeen märkäpukujen vuokrauksen vahvistamatta. Säilytä nämä puuttuvien tietojen tapaukset, kun mukautat pakettia; pelkät oikeat hintavastaukset eivät testaa Agentin pidättyvyyttä.

Puuttuva tieto tuottaa vastauksen ”en voi vahvistaa”. Erillinen porttikoodiviesti ei ole osoitettu botille, eikä siihen näy vastausta tässä kuvakaappauksessa.

Todellinen yksityinen kokeilutuntipyyntö tuotti yhden onnistuneen Sheets-Action-kutsun arvoilla Alex Morgan, Tuesday ja beginner. Google palautti HTTP 200:n ja yhden päivitetyn rivin; tallennettu rivi sisälsi myös keskustelulinkin ja telegram-kanavan. Erillinen Action-testi ryhmäkeskustelun metatiedoilla ei lähettänyt HTTP-pyyntöä. Tarkista sekä hyväksytty yksityinen pyyntö että estetty ryhmäkonteksti, kun mukautat ehtoa.

Tarkista kanava ja sen sivuvaikutukset

Kirjaa omat havaintosi paketin tyhjään test-matrix.csv-tiedostoon. Yllä olevat kuvakaappaukset näyttävät osoitetut tulokset; taulukossa on myös omalla kokoonpanolla tehtäviä tarkistuksia. Kirjaa kulunut aika, kun testaat hiljaisuutta, ja tarkista ihmisen haltuunotto erillään mahdollisesta myöhemmästä paluusta AI:lle.

Jos tarkistus epäonnistuu, muuta yhtä olennaista asetusta ja suorita sama viesti uudelleen. Korjaa puuttuva lähdetieto Knowledge Basessa; korjaa liian aikainen Action-kutsu sen kuvauksessa tai pakollisissa parametreissa; tarkista hiljaisen ryhmän vahvistus ja kohdistus ensin. Säilytä epäonnistunut tulos, jotta parannus näkyy.

Milloin kannattaa luoda oma botti BotFatherilla?

Luo oma Telegram-botti, kun tarvitset oman botin nimen ja kuvan, Telegram Bot API Actions -toimintoja tai ryhmän, joka vastaanottaa tavallisia viestejä. Yhteinen botti riittää edellä kuvattuihin ryhmä- ja yksityisvastauksiin.

Valitse tarvitsemasi identiteetti ja viestikäyttäytyminen ennen toisen botin lisäämistä.

1. Avaa Telegramin vahvistettu BotFather-tili ja lähetä /newbot.
2. Valitse näyttönimi ja sitten vapaa käyttäjätunnus, joka päättyy merkkijonoon bot. BotFather palauttaa tokenin. Pidä se salassa.
3. Valitse Saltmarsh Group, jos tämä botti lisätään ryhmään. Käytä Saltmarsh Sailing School -agenttia vain yksityiskeskusteluissa. Avaa External Apps > Telegram -kohdasta Your own bot ja valitse Connect to Telegram.
4. Liitä token Bot Token -kenttään ja viimeistele yhteys. Tarkista, että Enable your own bot on päällä.
5. Avaa botin Telegram-linkki ja lähetä /start sekä sen jälkeen sama kysymys kurssin hinnasta.
6. Jos haluat vastaanottaa tavallisia ryhmäviestejä, käytä BotFatherissa komentoa /setprivacy, valitse bottisi ja Disable, poista botti testiryhmästä ja lisää se uudelleen. Ylläpitäjäbotti vastaanottaa myös tavallisia viestejä. Telegramin yksityisyystilan dokumentaatio selittää toimitussäännöt.

Liitä token vain Bot Token -kenttään. Kenttä näytetään tyhjänä, jotta tunnistetietoja ei julkaista.

Pidä yhteinen botti ja oma bottisi eri ryhmissä. Molempien käyttö samassa ryhmässä voi tuottaa kaksoisvastauksia. Jos seuraava tehtäväsi on ilmoitusten kiinnittäminen tai jäsenten moderointi, seuraa erillistä Telegram-ryhmän hallinnan opasta, mukaan lukien vain ylläpitäjille sallitut Action-suoritusehdot.

Voivatko ChatGPT tai Claude auttaa Telegram-chatbotin asetuksissa?

Yhdistetty Quickchat AI -tilinhallintasovellus voi auttaa luomaan agentin, lisäämään tietoja, määrittämään tuetut asetukset ja suorittamaan testejä. Jos asiakasohjelma tarjoaa Telegram-asetukset, se voi ottaa yhteisen botin Direct message link -linkin käyttöön. Ryhmän valinta ja vahvistus hallintapaneelissa kuuluvat edelleen omistajalle. Jotkin asiakasohjelmat vaativat hallintapaneelia myös yksityislinkin käyttöönottoon ja Human Handoff -asetuksiin, joten pyydä avustajaa tarkistamaan ensin käytettävissä olevat työkalunsa.

Yhdistä Quickchat AI ChatGPT -liitännäinen tai Claude-yhteys ja anna paketin tiedostot tällä promptilla:

Use my connected Quickchat AI account to create two Agents from the attached kit: Saltmarsh Group with group-main-prompt.txt and Saltmarsh Sailing School with main-prompt.txt. Add both knowledge files to each. Keep Actions and Human Handoff off on Saltmarsh Group. Prepare the supplied knowledge-test dataset. Check the tools available in this client before changing settings. Show me the configuration and ask before running credit-consuming tests or writing to Google Sheets. Where supported, enable only Saltmarsh Sailing School's shared-bot direct-message link and return the complete link. Leave group selection, dashboard confirmation, BotFather setup, Google OAuth and unsupported settings for me, with exact dashboard steps. Report what was configured, what was actually tested and what remains to verify in Telegram.

Työkalujen saatavuus vaihtelee asiakasohjelman ja tilin oikeuksien mukaan. Kirjaudu tilinhallinnan käyttöönotto-ohjeen avulla. Tämä yhdistää avustajan Quickchat AI -tiliisi; se ei muuta henkilökohtaista ChatGPT- tai Claude-keskustelua Telegram-botin ylläpidetyksi taustajärjestelmäksi.

Miksi Telegram-chatbot ei vastaa?

Tarkista yhteys ja viestin kulku ennen promptin kirjoittamista uudelleen. Näillä oireilla on eri syyt.

Ennen asiakkaiden kutsumista korvaa kuvitteelliset tiedot, tarkista ryhmän ja yksityiskeskustelun erottelu ja järjestä henkilöstö käsittelemään siirretyt keskustelut. Pyydä kollegaa tarkistamaan julkiset sisääntulot toiselta tililtä viimeisenä tarkistuksena ennen käyttöönottoa. Toista yhteisökanavaa varten Discord-chatbotin opas seuraa vastaavaa rakennus- ja testipolkua. Hahmokeskusteluihin voit käyttää Telegram-roolipeliopasta.

Valinnaiset asetustarkistukset: Vertaa käyttöönottotapoja ilmoittamiesi vaatimusten mukaan tai vertaa vastauksia krediittibudjettia kohti annetulla budjetilla. Nämä laskurit eivät tutki tiliäsi, verkkosivustoasi tai saldoasi.

Kopioitavat Saltmarsh-asetukset

Nämä ovat oppaassa käytetyt täydelliset lähdetiedot ja ohjeet. Lataus sisältää myös Action-asetukset, arviointikriteerit ja testit.

Ryhmäagentti: Main Prompt

Liitä tämä Saltmarsh Group -agentin Identity > Main Prompt -kohtaan. Pidä Human Handoff ja omat Actions-toiminnot poissa käytöstä tässä agentissa.

You answer general questions in the Saltmarsh Sailing School members' group. Use only the Knowledge Base and keep each reply to two or three sentences. Do not add facts or requirements the sources do not contain. If a fact is missing, say that you cannot confirm it.

For trial requests, refunds, complaints, personal details or a request for a person, direct the member to the school's private link pinned in the group; do not invent a link. Do not collect personal details in this group. You cannot record requests, confirm bookings, approve refunds or transfer a conversation to staff. Do not claim you did any of these things. The private Agent records an enquiry; it cannot check live availability or confirm a trial. Only the office confirms availability and price.

Yksityisagentti: Main Prompt

Liitä tämä Saltmarsh Sailing School -agentin Identity > Main Prompt -kohtaan. Pidä nimetty Action yhdenmukaisena ohjeen kanssa.

You are the private-chat assistant of Saltmarsh Sailing School. Answer school questions from the Knowledge Base. Do not add plausible details that are not in the sources, including extra clothing or footwear requirements. Keep replies to two or three sentences and ask at most one question per message. If a fact is missing, say that you cannot confirm it; do not invent dates, availability, gate codes or wetsuit rental. Explain weather policy without claiming to know the current forecast.

When a person requests a trial lesson, collect their name, preferred weekday and sailing experience. Ask for only the next missing field. When all three are present, use Record trial-lesson request once. Say the request was recorded only after the Action succeeds. Explain that the office still needs to confirm availability and price; never say a lesson is booked. If the Action is unavailable or fails, say the request has not been recorded and offer a person.

Use Human Handoff for a current unresolved refund request, complaint or explicit request for a person. After a staff member has resolved the enquiry and returned the conversation to AI, answer new general questions normally; do not hand off again solely because an earlier message mentioned a refund or asked for a person. Do not approve refunds or promise a response time. For a missing fact, say what is unknown and offer a person; do not treat uncertainty as a negative answer about the service.

Tiedot: kurssit ja kokeilutuntipyynnöt

Liitä tämä ensimmäisen tietoartikkelin Content-kenttään.

Saltmarsh Sailing School demonstration information

This fictional school is used only for a tutorial. It contains no real customer data.

Start Sailing is a two-day course costing EUR 240. Day Skipper theory runs across five evenings and costs EUR 310. A private lesson lasts 90 minutes and costs EUR 95.

Courses run from April to October. Course dates are published on the school's website one month ahead. This source does not contain the next available date or live availability.

Bring a waterproof jacket, non-marking shoes and a change of clothes. The school provides buoyancy aids.

A trial-lesson request is an enquiry, not a confirmed booking. The office needs the person's name, preferred weekday and sailing experience, then confirms availability and price. Do not collect payment details. Do not infer a trial price from the private-lesson price.

Tiedot: käytännöt ja jäsentiedot

Liitä tämä toisen artikkelin Content-kenttään.

Saltmarsh Sailing School demonstration policies

If the forecast shows more than 25 knots of wind or thunderstorms, the session moves to the next available date at no extra cost. The instructor decides on the morning of the session. This source is a policy, not a live weather forecast or a cancellation decision.

Parking is free at the clubhouse. The gate code is sent to enrolled students the day before their course. The code itself is not in this Knowledge Base.

Refunds and complaints are handled by the office. An AI answer cannot approve a refund. A member of staff must decide each case.

The Telegram members' group is for general questions. Trial requests, refunds and other personal details belong in a private conversation with the school's Agent, opened from the school's direct-message link.

Human Handoff -sääntö

Liitä tämä kohtaan Human Handoff > Handoff Rules ja määritä todelliset saatavuusasetukset.

Transfer this private conversation to a person when the visitor has a current unresolved refund request, complaint, explicit request for a person, or accepts an offer of human help. After a staff member resolves the enquiry and returns it to AI, earlier refund or handoff messages must not trigger a new transfer for a general course question. Explain that a staff member can review the case here without approving a refund or promising a response time. This Agent is used only for private enquiries; the separate group Agent has Human Handoff disabled.

Usein kysytyt kysymykset

Miten lisään AI-chatbotin Telegram-ryhmään?

Avaa Quickchat AI:ssa External Apps, valitse Telegram ja Add to a Telegram group. Valitse ryhmäsi Telegramissa, palaa Quickchat AI:hin ja valitse Confirm. Jäsenet voivat kysyä mainitsemalla yhteisen botin tai vastaamalla sen viestiin.

Vastaako Telegram AI -chatbot jokaiseen viestiin?

Yhteinen Quickchat AI -botti vastaa ryhmäviesteihin, jotka mainitsevat sen tai vastaavat sille. Tavallinen ryhmäkeskustelu ei käynnistä vastausta. Oma bottisi voi vastaanottaa tavallisia ryhmäviestejä, kun Telegramin yksityisyystila on pois käytöstä tai botti on ylläpitäjä. Testaa tämä kokoonpano erillisessä ryhmässä.

Tarvitsenko BotFatherin tai Telegram-botin tokenin?

Et tarvitse BotFatheria tai tokenia yhteiseen bottiin ja sen yksityislinkkiin. Luo oma botti BotFatherilla, kun tarvitset oman Telegram-nimen ja kuvan tai Actions-toimintoja, jotka kutsuvat Telegram Bot API:a. Tavalliset Google Sheets Actions -toiminnot voivat toimia yhteisen botin kanssa.

Voivatko asiakkaat lähettää Telegram-chatbotille yksityisviestejä?

Kyllä. Ota Direct message link käyttöön Quickchat AI:ssa ja jaa koko luotu linkki. Asiakas avaa sen ja painaa tarvittaessa Start. Linkki valitsee agenttisi yhteisen botin sisällä. Linkin poistaminen käytöstä estää uudet yhteydet; olemassa olevilla yksityiskeskusteluilla on erilliset käyttöönotto- ja katkaisutoiminnot.

Onko Telegram AI -chatbot ilmainen?

Botin luominen BotFatherilla ei itsessään lisää AI-palvelua. Quickchat AI tarjoaa Free-tilauksen henkilökohtaiseen, ei-kaupalliseen oppimiseen rajatulla AI-krediittimäärällä. Kaupallinen käyttö vaatii maksullisen tilauksen. Vastaukset, Preview ja Simulation käyttävät AI-krediittejä, ja ulkoisilla palveluilla voi olla omat kustannuksensa.

Onko Telegramissa AI-chatbotteja?

Telegram tukee kolmansien osapuolten AI-botteja ja AI-integraatioita. Tämä opas yhdistää Quickchat AI Agentin, joka vastaa yrityksesi omien tietojen perusteella. BotFather luo botin identiteetin; se ei toimita näitä tietoja eikä määritä asiakastukesi työnkulkua.

Voiko chatbot ymmärtää kuvia ja tiedostoja?

Telegram-integraatio voi vastaanottaa valokuvia ja analysoida niiden visuaalista sisältöä. Muut tiedostot voivat tulla keskusteluun liitteinä, mutta niiden sisältöä ei lueta automaattisesti. Testaa asiakkaidesi käyttämät todelliset tiedostotyypit ja tarkista sekä Telegram että Inbox.

Voinko luoda Telegram-botin roolipeliin tai hahmokeskusteluun?

Kyllä. Sama Telegram-yhteys voi palvella agenttia, jolla on hahmon identiteetti ja sopivat ohjeet. Tämä opas käyttää yritystuen esimerkkiä; roolipeliagentti tarvitsee oman promptinsa ja omat testinsä.