Practice French Roleplay
Engage in daily French roleplay conversations with gentle corrections to improve B1-level skills via Telegram.
Telegram Roleplay Bot
This workflow sets up a friendly Telegram bot to help intermediate French learners (B1 level) practice conversational skills through daily roleplay scenarios. The bot simulates characters in common situations, responding in simple French, offering gentle corrections, and encouraging progress.
What the workflow does
- Listens for new messages from users on Telegram.
- Extracts message text and user details from Telegram updates.
- Retrieves the daily roleplay scenario from a Google Sheets spreadsheet.
- Combines user info with the scenario to establish conversational context.
- Sends this information to an AI agent that replies in character using simple French, correcting mistakes gently.
- Sends the AI’s response back to the user on Telegram and handles any errors smoothly.
Requirements
- A Telegram bot token.
- A Google Sheets spreadsheet with roleplay scenarios.
- A Needle platform account to run the workflow.
- Access to an AI model capable of generating dialogue and corrections.
Workflow nodes overview
| Node | Purpose |
|---|---|
| Telegram Bot API Message Updates | Triggers on new Telegram messages from users. |
| Parse Telegram Message | Extracts chat ID, user message, and recognizes commands like /start or /fin. |
| Get Roleplay Scenarios from Google Sheets | Retrieves scenario data for the day. |
| Merge User and Scenario Data | Combines user info with scenario details for context. |
| Prepare Scenario Object | Prepares the scenario to send to the AI. |
| AI Node | Generates French replies in character with gentle corrections. |
| Handle AI Errors | Provides fallback messages if AI returns errors. |
| Send Message to Telegram | Sends the AI-generated reply back to the user. |
Output
Users receive natural, context-aware French responses tailored to the daily scenario. The bot gently corrects errors and provides encouragement at conversation end.
Additional notes
- Scenarios cycle daily based on the day of the year from your Google Sheet.
- The AI always replies in simple French fit for B1 learners and stays in character.
- Commands like
/startintroduce the bot and scenario,/finends the conversation with a summary. - You can customize the AI prompt to adapt for other languages or skill levels.
- Ensure your Telegram token and Google Sheets connector are correctly set up in Needle for smooth operation.
Want to showcase your own workflows?
Become a Needle workflow partner and turn your expertise into recurring revenue.
