Steg 2: Anslut Google Sheets

Definiera enkätmetadata och koppla alla Google Sheets-operationer som läser kolumner, slår upp deltagare och skriver svar.

1. I Assign Survey Variables ställer ni in title till Product Satisfaction Survey, gsheetId till [YOUR_ID] och cacheKey till =survey_user_{{ $json.sessionId }}.
2. I Retrieve Sheet Columns ställer ni in Document ID till {{ $('Assign Survey Variables').first().json.gsheetId }} och Sheet Name till Sheet1.
3. I Lookup Participant Record ställer ni in Lookup Value till {{ $('Telegram Entry Trigger').first().json.message.from.id }} och Document ID till {{ $('Assign Survey Variables').first().json.gsheetId }}.
4. I Create Session Record och Upsert Participant Row behåller ni Operation som appendOrUpdate och mappar ID till {{ $('Telegram Entry Trigger').first().json.message.from.id }}.
5. Autentisering krävs: Anslut era googleSheetsOAuth2Api-autentiseringsuppgifter till alla Google Sheets-noder (inklusive Retrieve Sheet Columns, Lookup Participant Record, Create Session Record, Upsert Participant Row, Write Interim Answer och Write Final Answer).

Steg 3: Konfigurera Redis-session och minne

Spara sessionstillstånd och konversationshistorik i Redis och koppla in minnesbuffertar för AI-konversationen.

1. I Initialize Session State ställer ni in Key till {{ $('Assign Survey Variables').first().json.cacheKey }} och Value till JSON-objektet som innehåller "current_question_idx": 0.
2. I Fetch Session State och Load Session State ställer ni in Key till {{ $('Assign Survey Variables').first().json.cacheKey }} och Operation till get.
3. I Advance Question Index ställer ni in Key till {{ $('Assign Survey Variables').first().json.cacheKey }} och behåller Value-uttrycket som uppdaterar current_question_idx.
4. I Chat Memory Buffer och Extended Chat Memory ställer ni in Session Key till {{ $('Assign Survey Variables').first().json.cacheKey }}_history och behåller Context Window Length som 10 respektive 100.
5. Autentisering krävs: Anslut era redis-autentiseringsuppgifter till alla Redis-noder (inklusive Fetch Session State, Initialize Session State, Load Session State, Advance Question Index, Fetch Last Bot Reply, Chat Memory Buffer och Extended Chat Memory).

Steg 4: Konfigurera kommandorouting

Klassificera inkommande meddelanden, extrahera botkommandon och routa åtgärder för nya sessioner, nästa frågor eller ogiltiga kommandon.

1. I Classify Message Type behåller ni regeluttrycket {{ ['/start','/next', '/reset'].includes($('Telegram Entry Trigger').first().json.message.text) }} och noterar att Classify Message Type skickar utdata till både Extract Bot Command och Lookup Participant Record parallellt.
2. I Extract Bot Command ställer ni in command till {{ $('Telegram Entry Trigger').first().json.message.text.slice($('Telegram Entry Trigger').first().json.message.entities[0].offset, $('Telegram Entry Trigger').first().json.message.entities[0].length ) }}.
3. I Route Bot Actions behåller ni de två villkoren för /start och /next så att utdata routas till Create Session Record eller Load Session State.
4. I Check Missing Record behåller ni villkoret empty med {{ $json }} för att avgöra om en deltagarrad ska skapas.

Steg 5: Konfigurera enkättillstånd och meddelanden

Bygg den aktiva enkätkontexten, avgör om enkäten är klar och skicka rätt meddelanden till deltagaren.

1. I Assemble Survey State behåller ni uttrycken för num_questions, next_question_idx och is_survey_complete baserat på Load Session State.
2. I Survey Continuation Check behåller ni villkoret som kontrollerar {{ $('Advance Question Index').item.json.is_survey_complete }} för att routa till Reset Conversation Memory eller Send Completion Notice.
3. I Send Welcome Message behåller ni meddelandetexten och chatId inställt på {{ $('Telegram Entry Trigger').first().json.message.chat.id }}.
4. I Dispatch Next Query ställer ni in text till {{ $('Assemble Survey State').first().json.next_question_idx }}. {{ Object.values($('Retrieve Sheet Columns').first().json)[$('Assemble Survey State').first().json.next_question_idx+1] }} och chatId till {{ $('Telegram Entry Trigger').first().json.message.chat.id }}.
5. Autentisering krävs: Anslut era telegramApi-autentiseringsuppgifter till alla Telegram-åtgärdsnoder (inklusive Send Welcome Message, Dispatch Next Query, Reply With Agent Output, Send Invalid Command och Send Completion Notice).

Steg 6: Konfigurera AI-bearbetning

Konfigurera den konversationsbaserade agenten och klassificeraren och säkerställ att rätt språkmodeller och minnesverktyg är anslutna.

1. I Conversational Agent ställer ni in Text till {{ $('Telegram Entry Trigger').first().json.message.text }} och behåller Prompt Type som define.
2. Öppna Primary Language Model och bekräfta att Model är gpt-4o-mini; den här modellen är ansluten som språkmodell för Conversational Agent—säkerställ att autentiseringsuppgifter är tillagda i Primary Language Model.
3. I Determine Followup Need behåller ni Input Text som =AI: {{ $('Fetch Last Bot Reply').item.json.data?.first().parseJson().data.content ?? ''}} USER: {{ $('Telegram Entry Trigger').first().json.message.text }} och de två kategorierna för uppföljningsbeslut.
4. Öppna Classifier Language Model och bekräfta att Model är gpt-4o-mini; den här modellen är ansluten till Determine Followup Need—säkerställ att autentiseringsuppgifter är tillagda i Classifier Language Model.
5. I Reset Conversation Memory behåller ni Mode som insert med Insert Mode inställt på override; lägg till Redis-autentiseringsuppgifter i minnesnoderna (Chat Memory Buffer / Extended Chat Memory), inte i Reset Conversation Memory.

Steg 7: Konfigurera utdata och skrivningar till Sheet

Bygg svars-payloaden, avgör om en uppföljning behövs och spara enkätsvar tillbaka till Google Sheets.

1. I Build Response Payload behåller ni payload som {{ [ Object.values($('Lookup Participant Record').first().json)[Number($('Fetch Session State').first().json.data.current_question_idx || 0) + 1], 'User: ' + $('Telegram Entry Trigger').first().json.message.text, ].join('\n\n').trim() }}.
2. I Build Response Payload ställer ni in cell till {{ 'abcdefghijklmnopqrstuvxyz'.toUpperCase().split('')[$('Classify Message Type').first().json.data.current_question_idx] }}{{ $('Lookup Participant Record').first().json.row_number }}.
3. I Write Interim Answer ställer ni in URL till https://sheets.googleapis.com/v4/spreadsheets/{{ $('Assign Survey Variables').first().json.gsheetId }}/values/Sheet1!{{ $('Build Response Payload').first().json.cell }} och behåller JSON Body med values inställt på [[$('Build Response Payload').first().json.payload]].
4. I Write Final Answer använder ni samma URL och behåller JSON Body som lägger till Agent: {{ $('Conversational Agent').first().json.output }}.
5. I Reply With Agent Output ställer ni in text till {{ $('Conversational Agent').first().json.output }} och chatId till {{ $('Telegram Entry Trigger').first().json.message.chat.id }}.

Steg 8: Testa och aktivera ert arbetsflöde

Validera Telegram-enkätflödet från början till slut innan ni aktiverar det för produktion.

1. Klicka på Test Workflow och skicka /start till er Telegram-bot för att bekräfta att Send Welcome Message triggas efter Initialize Session State.
2. Svara med /next för att verifiera att Dispatch Next Query skickar nästa enkätfråga och att Advance Question Index uppdaterar Redis.
3. Skicka ett vanligt svar för att bekräfta att Determine Followup Need routar till Write Interim Answer eller Conversational Agent och att Write Final Answer loggar svaret i Google Sheets.
4. När enkäten är klar, säkerställ att Send Completion Notice levereras och att sessionstillståndet återställs av Reset Conversation Memory.
5. Slå på arbetsflödet med Activate-reglaget för användning i produktion.