Chatbot AI Telegram: gruppi e chat private senza codice

Un chatbot AI per Telegram può rispondere usando le conoscenze della tua attività in un gruppo o in una conversazione privata. Quickchat AI collega un AI Agent a Telegram tramite un bot condiviso: aggiungilo al gruppo e conferma il collegamento nella dashboard. I membri potranno menzionarlo per fare domande. Questo percorso non richiede codice né un token BotFather.

Questa guida realizza Saltmarsh Sailing School, una scuola fittizia con un gruppo di soci e richieste private. Due Agents ricevono gli stessi fatti: Saltmarsh Group risponde alle domande pubbliche, mentre Saltmarsh Sailing School gestisce richieste private di lezioni di prova e coinvolge una persona per i rimborsi. La richiesta è una pratica per la segreteria, non una prenotazione confermata.

Due Agents separano le responsabilità. Quello del gruppo non dispone di Action di passaggio o raccolta; quello privato gestisce richieste e risposte del personale.

Segui il percorso seguente. L’estensione Google Sheets è facoltativa: puoi prima completare le risposte e il passaggio a una persona.

Scarica il kit Telegram Saltmarsh con le conoscenze esatte, il Main Prompt, la configurazione dell’Action, i criteri di valutazione e i messaggi di test. Sono file modificabili per i passaggi seguenti, non un’importazione dell’Agent con un clic.

Modelli eseguibili, messaggi di test e screenshot restano in inglese per rendere riproducibili i risultati. Anche le etichette dei comandi corrispondono all’app in inglese.

Cosa serve per creare un chatbot Telegram?

Servono un account Quickchat AI, due Agents e un account Telegram autorizzato ad aggiungere un bot a un gruppo di test. Il passaggio facoltativo per registrare richieste richiede anche un account Google che possa autorizzare Google Sheets.

1. Crea un account Quickchat AI e verifica l’e-mail se richiesto. Free consente apprendimento personale e non commerciale. I piani si applicano per Agent: un’attività che li usa entrambi necessita quindi della copertura commerciale appropriata per ciascuno. Preview e Simulation consumano crediti AI. Consulta i piani attuali.
2. Crea un gruppo Telegram chiamato Saltmarsh Members. Usa un gruppo di test per verificare menzioni, silenzio e messaggi successivi prima di invitare clienti.
3. Usa il tuo account Telegram per il tutorial, anche per i messaggi del visitatore. Puoi gestire anche l’Inbox di Quickchat AI. Prima di invitare clienti, chiedi a un collega di verificare l’esperienza da un altro account.
4. Estrai il kit. Tieni insieme i dati di esempio della scuola e sostituiscili con le tue regole verificate prima della pubblicazione.

Gli screenshot di Quickchat App mostrano un’app eseguita in locale con la configurazione fittizia di Saltmarsh; i dati di esempio delle connessioni sono identificati nelle didascalie. Gli screenshot di Telegram e Google Sheets mostrano le risposte effettive e la richiesta salvata della demo collegata. I dati personali degli account sono esclusi dal ritaglio o esplicitamente nascosti. Usa la checklist finale per ripetere le verifiche con le tue conoscenze e i tuoi account collegati.

Passaggio 1: come insegni al chatbot Telegram le conoscenze della tua attività?

Inserisci i fatti aziendali nella Knowledge Base e le istruzioni operative nel Main Prompt. Separare questi compiti permette di correggere una risposta senza cambiare il comportamento dell’Agent.

Prezzi e regole sono fatti delle fonti. Brevità, incertezza e instradamento sono istruzioni.

Creare l’Agent e aggiungere conoscenze

1. In un nuovo account scegli Set up manually. In un account esistente seleziona prima Add new AI Agent, poi il percorso manuale.
2. In Identity, inserisci Saltmarsh Group in Name your AI Agent. Incolla group-main-prompt.txt del kit in Describe what you want your agent to do.
3. Prosegui senza collegare ancora app esterne. Completa la scelta del piano, usando Skip for now se inizi con l’account di apprendimento.
4. Apri Knowledge Base > Add Article. Inserisci Courses and trial enquiries in Create custom article, seleziona Create article, incolla saltmarsh-courses.txt in Content, quindi Save.
5. Ripeti con Weather, parking and personal enquiries, usando saltmarsh-policies.txt. Attendi che entrambi gli articoli mostrino Ready.
6. Apri Actions & MCPs su Saltmarsh Group. Mantieni Human Handoff disabilitato e non aggiungere l’Action per le richieste di prova.
7. Seleziona Add new AI Agent e ripeti la configurazione manuale per Saltmarsh Sailing School, con main-prompt.txt e gli stessi due file di conoscenze. Questo secondo Agent gestirà le conversazioni private. Seleziona quello corretto nel selettore dell’account prima di modificarne le impostazioni.

Due fonti brevi rendono chiari i fatti disponibili all’Agent. Ready è il controllo da fare prima di un test delle conoscenze.

Il noleggio di mute è assente di proposito. L’Agent deve dire di non poterlo confermare, senza inventare un sì o un no. La regola meteorologica non fornisce la previsione di oggi e il prezzo della lezione privata non determina quello della prova.

Impostare Main Prompt e verificare una risposta

1. Apri Identity > Main Prompt su ogni Agent e verifica il relativo prompt Saltmarsh. Quello del gruppo risponde a domande generali e rimanda al link privato fissato; quello privato raccoglie richieste e usa Human Handoff.
2. Apri AI Preview e chiedi How much is Start Sailing?. Verifica che compaiano due giorni e 240 EUR.
3. Chiedi Do you rent wetsuits?. Verifica che la risposta ammetta l’informazione mancante.

Il prompt dell’Agent privato definisce raccolta e passaggio. L’Agent del gruppo usa un prompt distinto e ha entrambe le Actions disabilitate.

Due ritagli delle vere impostazioni dell’Agent del gruppo. Può rispondere su ciò che sa, ma non eseguire Action di raccolta o passaggio.

Due Agents rendono esplicito l’instradamento. Quello del gruppo non può attivare accidentalmente un passaggio; quello privato può trasferire una richiesta di rimborso senza fermare il gruppo. Preview controlla i fatti della scuola; i passaggi successivi verificano ogni collegamento Telegram.

Passaggio 2: come aggiungi il chatbot AI a un gruppo Telegram?

Apri External Apps > Telegram, aggiungi il bot condiviso al gruppo, poi torna in Quickchat AI e seleziona Confirm. L’Agent resta silenzioso in quel gruppo fino alla conferma.

L’appartenenza al gruppo Telegram e la conferma in Quickchat AI sono passaggi distinti.

1. Seleziona Saltmarsh Group nel selettore dell’Agent. Apri External Apps, seleziona Telegram e trova Quickchat AI bot.
2. Seleziona Add to a Telegram group. In Telegram scegli Saltmarsh Members e approva l’aggiunta del bot.
3. Torna in Quickchat AI. In Waiting for your confirmation, controlla il nome del gruppo e le informazioni Added by.
4. Seleziona Confirm per il gruppo atteso. Dovrebbe passare in Connected chats, con l’interruttore attivo.
5. In Telegram digita @ e scegli il bot dal selettore delle menzioni. Chiedi How much is Start Sailing?. Il nome utente del bot condiviso è normalmente @QuickchatAI_bot; usa quello effettivamente mostrato nel gruppo.
6. Rispondi direttamente a quella risposta con What should I bring?. Poi invia un messaggio separato senza menzione: Does anyone know the gate code?. Il bot condiviso deve rispondere alla risposta diretta e restare silenzioso sul messaggio normale.

Scegli Saltmarsh Members in Telegram, poi torna in Quickchat AI per confermare il collegamento.

Interfaccia locale reale con dati dimostrativi del gruppo, che mostra dove compare Confirm. Illustra il comando, non dimostra l’ingresso in un gruppo Telegram reale.

Il gruppo confermato ha ricevuto la risposta prevista sul corso. Menziona il bot usando il suo vero nome utente.

Rispondere al messaggio del bot funziona senza menzionarlo di nuovo. La risposta elenca le informazioni fornite sull’attrezzatura.

La conferma conta perché i dati dell’invito compaiono nel gruppo. Quickchat AI richiede una decisione dall’account prima di considerare quel gruppo una destinazione dell’Agent. Non confermare gruppi sconosciuti. La documentazione del collegamento Telegram spiega lo stesso limite.

Completa la conferma prima di uscire dalla configurazione. Se il bot lascia un gruppo non confermato, genera un nuovo link con Add to a Telegram group, aggiungilo di nuovo e conferma subito il gruppo in attesa in Quickchat AI. Aggiungere il bot tramite la ricerca dei membri di Telegram non sostituisce questo percorso di connessione.

Il badge Admin indica lo stato del bot in Telegram. Non serve per le normali risposte del bot condiviso. Promuoverlo ad amministratore non cambia la sua regola di rispondere solo a menzioni o risposte dirette.

Passaggio 3: come attivi le chat private di Telegram?

Attiva Direct message link e condividi l’URL generato completo. Il link seleziona il tuo Agent nel bot Telegram condiviso, così i clienti possono chiedere in privato senza aggiungerlo a un gruppo.

Il gruppo è una conversazione condivisa. Sposta dati personali e passaggi al personale nei messaggi privati.

1. Seleziona Saltmarsh Sailing School, l’Agent privato. Apri External Apps > Telegram e attiva Direct message link. Lascia vuote le sue connessioni ai gruppi.
2. Copia il link generato conservando il parametro start=. Un semplice link al bot condiviso non identifica il tuo Agent.
3. Aprilo in Telegram e premi Start se richiesto.
4. Chiedi How much is Start Sailing? senza menzionare il bot. Verifica la risposta della scuola e trova la conversazione in Inbox.
5. Fissa il link nel messaggio di benvenuto del gruppo, così i membri lo trovano prima di condividere dati personali.

Usa il link generato per il tuo Agent. La configurazione locale mostrata non è una prova di consegna reale su Telegram.

Telegram ha consegnato il benvenuto di Saltmarsh dopo Start. Controlla poi una risposta basata sulle conoscenze; il solo saluto non verifica il recupero delle informazioni.

Due ritagli della stessa schermata Telegram mostrano l’invito fissato. Il valore start del link dimostrativo è omesso; fissa il tuo link generato completo.

Una chat privata con il bot condiviso è associata a un Agent alla volta. Aprire il link privato di un altro Agent può cambiare l’associazione. Per un’identità Telegram e un thread dedicati, usa il percorso del bot personale.

Disattivare Direct message link impedisce nuove connessioni tramite quel link. Per fermare una chat già collegata, usa il suo interruttore o Disconnect. Considera il link un ingresso pubblico, non una restrizione d’accesso per conoscenze riservate.

Passaggio 4: come salvi una richiesta di prova in Google Sheets?

L’integrazione Google Sheets crea un foglio e un’Action che aggiunge righe. Adattala per registrare tre campi obbligatori della richiesta, poi verifica la riga reale. Questo passaggio è facoltativo e funziona con il bot Telegram condiviso.

Il risultato è una richiesta da seguire personalmente. Non riserva un posto e non stabilisce il prezzo della prova.

Collegare Sheets e configurare un’Action

1. Su Saltmarsh Sailing School, apri Actions & MCPs > Add Action > Google Sheets e scegli Connect Google Sheets. Accedi all’account Google previsto e approva gli accessi richiesti.
2. Apri il foglio generato Quickchat Leads. Mantieni la scheda Leads, perché l’URL dell’Action punta a quella scheda.
3. Sostituisci la riga d’intestazione, in ordine, con Name, Preferred weekday, Sailing experience, Conversation link, Channel.
4. Apri Actions & MCPs e modifica l’Action generata log_lead_to_google_sheet. Usa la configurazione seguente. Modifica insieme parametri, corpo della richiesta e intestazioni, mantenendo la stessa posizione.

API Action Name

Record trial-lesson request

What to ask the user first

Imposta i tre parametri su No default ed elimina quelli predefiniti per e-mail e richiesta. Questi tre campi sono le uniche domande della configurazione. Il nome utente Telegram è facoltativo e non è un contatto obbligatorio affidabile; il link della conversazione registrato consente al personale di tornare alla richiesta.

Metodo e URL: conserva l’URL POST generato. Contiene già l’ID del foglio, la scheda Leads e valueInputOption=RAW. Non devi compilare alcun ID segnaposto.

Intestazioni: conserva la configurazione dell’integrazione.

Nella scheda Body dell’API Endpoint usa:

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

Usa Add AI Data per inserire i riferimenti a parametri e variabili della conversazione. I primi tre valori arrivano dalla conversazione; gli ultimi due sono forniti da 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.

Apri Advanced settings > Run only when e aggiungi telegram_chat_type equals private. Usa la sola chiave dei metadati, senza metadata_ o parentesi graffe. Ciò impedisce la richiesta HTTP per i messaggi del gruppo anche se il modello tenta di eseguirla. La documentazione delle condizioni di esecuzione spiega il controllo.

Imposta Response filter su $.updates.updatedRows per restituire il numero di righe invece di una risposta superflua del fornitore. Mantieni l’Action attiva.

La chiave semplice è telegram_chat_type. La condizione viene verificata prima dell’invio della richiesta.

Configurazione locale della richiesta. L’URL Sheets generato e l’autorizzazione OAuth devono provenire dal tuo collegamento Google.

Verificare la riga, poi una richiesta incompleta

Invia questo messaggio tramite il link Telegram privato dell’Agent:

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

Verifica tutte e tre le superfici: la risposta descrive una richiesta, la scheda Action di Inbox mostra i valori forniti e la vera scheda Leads contiene la riga corrispondente. Una risposta rassicurante o un punteggio Simulation alto non dimostrano una scrittura in Google Sheets.

L’Agent ha registrato il nome fornito, la preferenza per martedì e l’esperienza da principiante. Disponibilità e prezzo esatto richiedono ancora la conferma dell’ufficio.

Due dettagli della stessa riga salvata rendono leggibili tutte e cinque le colonne. Il link alla conversazione specifico dell’account è nascosto; gli altri quattro valori sono invariati.

Avvia un test distinto con I would like a trial lesson. L’Agent deve chiedere i campi mancanti, uno alla volta, prima di eseguire l’Action. Prova anche How much is Start Sailing?: una normale domanda sul corso non deve creare una riga. Il prompt richiede una scrittura per richiesta, ma questa configurazione di aggiunta non è un sistema di prenotazione idempotente. Controlla i duplicati prima dell’uso operativo.

Passaggio 5: come passi una conversazione Telegram a una persona?

Configura Human Handoff, poi verifica l’assegnazione della conversazione in Inbox. Un prompt che dice «risponderà la segreteria» non trasferisce da solo la responsabilità e non mette in pausa l’AI.

Il punto di controllo è il cambio di assegnazione. Fai terminare il caso a una persona e verifica separatamente ogni ritorno all’AI.

1. Seleziona Saltmarsh Sailing School, apri Actions & MCPs > Human Handoff e attivalo. Lascia questa Action spenta su Saltmarsh Group.
2. In Handoff Rules, seleziona +. Inserisci Private enquiries come Rule Name, incolla handoff-rule.txt in Description e attiva State. Le nuove righe sono inizialmente inattive. La regola copre rimborsi, reclami, richieste di una persona e accettazione di aiuto umano per questo Agent privato.
3. Svuota Keywords e disabilita le regole predefinite dell’esempio, lasciando attiva solo quella personalizzata, quindi salva. Il gruppo è isolato perché Human Handoff è spento sul suo Agent separato; la regola descrive quando il privato deve trasferire.
4. Imposta Confirmation su I have passed this private conversation to the Saltmarsh office. A member of staff can reply here. Configura Human Agents’ availability secondo gli orari effettivamente coperti dal team e inserisci un messaggio veritiero per gli altri orari.
5. Dalla chat privata Telegram invia I want a refund for last week. Can I speak to a person?.
6. In Inbox, trova la conversazione, verifica l’assegnazione, scegli Assign to me e invia Hi, I’m Alex from the office. I’ll review your request. Controlla che arrivi su Telegram.
7. Invia un altro messaggio cliente mentre la persona è responsabile della conversazione. L’AI deve restare silenziosa. Lascia che l’operatore termini il caso e lo risolva in Inbox. Considera il ritorno all’AI un test separato.

State è attivo per la regola personalizzata. I trigger predefiniti sono spenti, lasciando una sola regola da controllare.

La richiesta reale in Telegram ha attivato Handoff. L’assegnazione in Inbox e la risposta in uscita dell’operatore sono state verificate separatamente.

Nella verifica reale, la conversazione è passata a Unassigned, pronta per essere presa in carico. L’operatore ha selezionato Assign to me, ha inviato la risposta dell’ufficio e Telegram l’ha accettata. Lo screenshot sopra mostra la risposta di passaggio, non il successivo messaggio dell’operatore. Verifica sia l’assegnazione sia la consegna quando ripeti il test.

Lascia il caso all’operatore fino alla risoluzione. Nel nostro test locale di rimborso, il ritorno ad AI Agent ha consentito una risposta prima che Handoff si attivasse di nuovo. Il ritorno all’AI richiede un proprio test successivo riuscito; non rientra nei criteri di completamento di questo flusso. La guida al passaggio a una persona approfondisce la gestione del personale e delle responsabilità.

Passaggio 6: come testi il chatbot Telegram completo?

Usa Testing per verifiche ripetibili delle risposte, poi controlla separatamente i percorsi Telegram reali e gli effetti esterni. Il modello può rispondere correttamente mentre il collegamento al gruppo, la scrittura nel foglio o la consegna dopo il passaggio funzionano male.

Controlla il sistema responsabile: conoscenze per i fatti, log delle Actions per le richieste, Sheets per le righe e Telegram per la consegna.

Eseguire un dataset di risposte ripetibile

1. Apri Testing, crea un dataset chiamato Saltmarsh: knowledge checks e scegli Paste messages.
2. Incolla simulation-messages.txt. Conserva i separatori --- su righe autonome tra i casi.
3. Apri Evaluation criteria, incolla evaluation-criteria.txt del kit e salva.
4. Seleziona Run > Start Run, poi esamina le singole risposte oltre ai punteggi.

Mantieni le stesse domande quando cambi un’istruzione, così il confronto resta utile.

Leggi le risposte oltre al punteggio. Sono test locali delle conoscenze, non di consegna Telegram.

Il valutatore ha bisogno dei fatti della scuola per giudicare l’accuratezza. Deve anche sapere che il testo della conversazione non prova una riga nel foglio, la consegna Telegram o un cambio di assegnazione. La Simulation testuale standard non fornisce metadati Telegram: la condizione che limita l’Action al privato non è necessariamente guasta quando mancano. Esegui i controlli dipendenti dal canale nella chat privata reale.

Cosa hanno cambiato i test locali?

Il progetto iniziale usava un solo Agent per entrambi gli ingressi. Un test locale ha mostrato che una richiesta di rimborso nel gruppo trasferiva la conversazione condivisa a Human Handoff. Abbiamo separato gli Agents e disattivato Handoff e le Actions di raccolta delle richieste sull’Agent del gruppo. Ripetendo le verifiche di rimborso e lezione di prova nel gruppo, le risposte hanno indirizzato al link privato fissato, mantenendo la conversazione assegnata all’AI. Per questo il passaggio 1 usa la configurazione, oltre alle istruzioni, per separare le due conversazioni.

Le dieci verifiche locali finali delle conoscenze hanno ottenuto 5/5 ciascuna, ed entrambi gli Agents ospitati hanno superato gli stessi dieci casi. Questi piccoli test non stimano l’accuratezza in produzione. Il gruppo reale ha anche risposto alle domande sul prezzo del corso e sull’attrezzatura, per poi non confermare il noleggio delle mute. Mantieni questi casi di informazioni mancanti quando adatti il kit; i prezzi corretti da soli non verificano la prudenza dell’Agent.

Le conoscenze mancanti producono «non posso confermare». Il messaggio separato sul codice del cancello non si rivolge al bot e in questa cattura non è visibile alcuna risposta.

La richiesta privata reale di una lezione di prova ha prodotto una chiamata riuscita all’Action di Sheets con Alex Morgan, Tuesday e beginner. Google ha restituito HTTP 200 e una riga aggiornata; la riga salvata conteneva anche il link alla conversazione e il canale telegram. Un test separato dell’Action con metadati di chat di gruppo non ha inviato alcuna richiesta HTTP. Verifica sia la richiesta privata accettata sia il contesto di gruppo rifiutato quando adatti la condizione.

Controllare il canale e i suoi effetti

Usa il file vuoto test-matrix.csv del kit per registrare le tue osservazioni. Gli screenshot sopra mostrano i risultati dimostrati; la tabella include anche verifiche da eseguire con la tua configurazione. Registra il tempo trascorso nei test del silenzio e tieni distinta la presa in carico umana da un eventuale ritorno successivo all’AI.

Quando una verifica fallisce, cambia un’impostazione pertinente e ripeti lo stesso messaggio. Correggi i fatti mancanti nella Knowledge Base, le chiamate premature nella descrizione o nei parametri obbligatori dell’Action e i gruppi silenziosi controllando prima conferma e indirizzamento. Conserva l’esito fallito per rendere visibile il miglioramento.

Quando dovresti creare un bot personale con BotFather?

Crea un bot Telegram personale se servono nome e immagine propri, Actions Telegram Bot API o ricezione dei normali messaggi di gruppo. Il bot condiviso basta per i percorsi di risposta pubblica e privata precedenti.

Scegli identità e comportamento dei messaggi prima di aggiungere un secondo bot.

1. Apri l’account verificato BotFather in Telegram e invia /newbot.
2. Scegli un nome visualizzato, poi un nome utente disponibile che termini in bot. BotFather restituisce un token. Mantienilo privato.
3. Seleziona Saltmarsh Group se questo bot verrà aggiunto a un gruppo. Usa Saltmarsh Sailing School solo per le chat private. In External Apps > Telegram, apri Your own bot e seleziona Connect to Telegram.
4. Incolla il token in Bot Token e completa il collegamento. Verifica che Enable your own bot sia attivo.
5. Apri il link Telegram del bot e invia /start, poi la stessa domanda sul prezzo.
6. Per ricevere i normali messaggi del gruppo, usa /setprivacy in BotFather, seleziona il bot e Disable, poi rimuovilo dal gruppo di test e aggiungilo di nuovo. Anche un bot amministratore riceve quei messaggi. La documentazione della modalità privacy spiega le regole di consegna Telegram.

Incolla il token soltanto in Bot Token. Il campo è vuoto per non pubblicare credenziali.

Tieni il bot condiviso e quello personale in gruppi separati. Nello stesso gruppo possono produrre risposte duplicate. Per fissare annunci o moderare membri, segui il tutorial di gestione dei gruppi Telegram, comprese le condizioni delle Actions riservate agli amministratori.

ChatGPT o Claude possono aiutare a configurare il chatbot Telegram?

Un’app collegata per la gestione dell’account Quickchat AI può aiutare a creare un Agent, aggiungere conoscenze, configurare le impostazioni supportate ed eseguire test. Quando il client offre la configurazione di Telegram, può attivare il Direct message link del bot condiviso. La scelta del gruppo e la conferma nella dashboard restano compiti del proprietario. Alcuni client richiedono la dashboard anche per attivare il link diretto e configurare Human Handoff: chiedi quindi all’assistente di controllare prima gli strumenti disponibili.

Collega il plugin Quickchat AI per ChatGPT o il connettore Claude, poi fornisci i file del kit con questo prompt:

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.

Gli strumenti disponibili dipendono dal client e dai permessi dell’account. Segui la documentazione di gestione dell’account per l’accesso. Questo collega un assistente al tuo account Quickchat AI; non trasforma una chat personale ChatGPT o Claude nel backend ospitato del bot Telegram.

Perché il chatbot Telegram non risponde?

Controlla collegamento e percorso dei messaggi prima di riscrivere il prompt. Questi sintomi hanno cause diverse.

Prima di invitare clienti, sostituisci i fatti fittizi, verifica la separazione gruppo/privato e assegna personale ai passaggi. Chiedi a un collega di verificare i punti di accesso pubblici da un altro account come controllo finale prima del lancio. Il tutorial del chatbot Discord segue un percorso simile per un altro canale comunitario. Per i personaggi usa la guida al gioco di ruolo Telegram.

Controlli facoltativi: Confronta i metodi di distribuzione in base ai requisiti dichiarati oppure le risposte per budget di crediti usando un budget fornito. Questi calcolatori non esaminano account, sito o saldo.

Configurazione Saltmarsh da copiare

Questi sono i fatti e le istruzioni completi della guida. Il download comprende anche configurazione dell’Action, criteri di valutazione e test.

Agent del gruppo: Main Prompt

Incolla questo in Identity > Main Prompt su Saltmarsh Group. Mantieni Human Handoff e Actions personalizzate disabilitati per questo Agent.

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.

Agent privato: Main Prompt

Incolla questo in Identity > Main Prompt su Saltmarsh Sailing School. Il nome dell’Action deve coincidere con la configurazione.

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.

Conoscenze: corsi e richieste di prova

Incolla questo nel campo Content del primo articolo di conoscenze.

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.

Conoscenze: regole e informazioni dei membri

Incolla questo nel campo Content del secondo articolo.

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.

Regola Human Handoff

Incolla questo in Human Handoff > Handoff Rules e configura la disponibilità effettiva.

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.

Domande frequenti

Come aggiungo un chatbot AI a un gruppo Telegram?

In Quickchat AI apri External Apps, seleziona Telegram e scegli Add to a Telegram group. Scegli il gruppo in Telegram, poi torna in Quickchat AI e seleziona Confirm. I membri possono fare domande menzionando il bot condiviso o rispondendo a uno dei suoi messaggi.

Un chatbot AI Telegram risponde a ogni messaggio?

Il bot condiviso Quickchat AI risponde ai messaggi del gruppo che lo menzionano o rispondono a un suo messaggio. Le normali conversazioni non attivano risposte. Il tuo bot può ricevere i messaggi ordinari quando la privacy Telegram è disattivata o il bot è amministratore. Prova questa configurazione in un gruppo separato.

Servono BotFather o un token di bot Telegram?

Non servono BotFather o token per il bot condiviso e il suo link privato. Crea un bot personale con BotFather per avere nome e immagine Telegram personalizzati o Actions che chiamano Telegram Bot API. Le normali Actions Google Sheets funzionano anche con il bot condiviso.

I clienti possono scrivere privatamente al chatbot Telegram?

Sì. Attiva Direct message link in Quickchat AI e condividi il link generato completo. Il cliente lo apre e preme Start se richiesto. Il link seleziona il tuo Agent nel bot condiviso. Disattivarlo impedisce nuove connessioni; le chat private esistenti hanno controlli separati per attivazione e disconnessione.

Un chatbot AI Telegram è gratuito?

Creare un bot con BotFather non aggiunge un servizio AI. Quickchat AI offre Free per apprendimento personale e non commerciale con crediti AI limitati. Un utilizzo commerciale richiede un piano a pagamento. Risposte, Preview e Simulation consumano crediti AI; i servizi esterni possono avere costi propri.

Telegram dispone di chatbot AI?

Telegram supporta bot AI e integrazioni AI di terze parti. Questa guida collega un Agent Quickchat AI che risponde dalle conoscenze della tua attività. BotFather crea l’identità del bot, ma non fornisce tali conoscenze né configura il flusso di assistenza clienti.

Il chatbot può comprendere foto e file?

L’integrazione Telegram può ricevere foto e analizzarne il contenuto visivo. Altri file possono arrivare come allegati, ma il contenuto non viene letto automaticamente. Prova i tipi di file realmente usati dai clienti e controlla sia Telegram sia Inbox.

Posso creare un bot Telegram per personaggi o gioco di ruolo?

Sì. Lo stesso collegamento Telegram può servire un Agent con identità di personaggio e istruzioni adatte. Questa guida usa un esempio di assistenza aziendale; un Agent per gioco di ruolo richiede prompt e test propri.