This workflow follows the Agent → Chat Trigger recipe pattern — see all workflows that pair these two integrations.
The workflow JSON
Copy or download the full n8n JSON below. Paste it into a new n8n workflow, add your credentials, activate. Full import guide →
{
"id": "rtsvydad1MOCryia",
"name": "\ud83d\udc0b\ud83e\udd16 DeepSeek AI Agent + Telegram + LONG TERM Memory \ud83e\udde0",
"tags": [],
"nodes": [
{
"id": "23b50c07-39a8-4166-ab13-9683b3ee25e6",
"name": "Check User & Chat ID",
"type": "n8n-nodes-base.if",
"position": [
-80,
160
],
"parameters": {
"options": {},
"conditions": {
"options": {
"version": 2,
"leftValue": "",
"caseSensitive": true,
"typeValidation": "strict"
},
"combinator": "and",
"conditions": [
{
"id": "5fe3c0d8-bd61-4943-b152-9e6315134520",
"operator": {
"name": "filter.operator.equals",
"type": "string",
"operation": "equals"
},
"leftValue": "={{ $('Listen for Telegram Events').item.json.body.message.from.first_name }}",
"rightValue": "={{ $json.first_name }}"
},
{
"id": "98a0ea91-0567-459c-bbce-06abc14a49ce",
"operator": {
"name": "filter.operator.equals",
"type": "string",
"operation": "equals"
},
"leftValue": "={{ $('Listen for Telegram Events').item.json.body.message.from.last_name }}",
"rightValue": "={{ $json.last_name }}"
},
{
"id": "18a96c1f-f2a0-4a2a-b789-606763df4423",
"operator": {
"type": "number",
"operation": "equals"
},
"leftValue": "={{ $('Listen for Telegram Events').item.json.body.message.from.id }}",
"rightValue": "={{ $json.id }}"
}
]
},
"looseTypeValidation": "="
},
"typeVersion": 2.2
},
{
"id": "ecbc13fe-305d-4cdd-b35c-3e119e8e8b5d",
"name": "Error message",
"type": "n8n-nodes-base.telegram",
"position": [
160,
440
],
"parameters": {
"text": "=Unable to process your message.",
"chatId": "={{ $json.body.message.chat.id }}",
"additionalFields": {
"appendAttribution": false
}
},
"credentials": {
"telegramApi": {
"name": "<your credential>"
}
},
"typeVersion": 1.2
},
{
"id": "be722bc7-0b22-4892-967c-fdd398a7b129",
"name": "Sticky Note",
"type": "n8n-nodes-base.stickyNote",
"position": [
-540,
-20
],
"parameters": {
"color": 6,
"width": 949,
"height": 652,
"content": "# Receive Telegram Message with Webhook"
},
"typeVersion": 1
},
{
"id": "a3866585-bfee-4025-a8f4-f06fde16171a",
"name": "Listen for Telegram Events",
"type": "n8n-nodes-base.webhook",
"position": [
-480,
160
],
"parameters": {
"path": "wbot",
"options": {
"binaryPropertyName": "data"
},
"httpMethod": "POST"
},
"typeVersion": 2
},
{
"id": "f70571d5-3680-4616-90fa-3358b0883368",
"name": "Sticky Note1",
"type": "n8n-nodes-base.stickyNote",
"position": [
-1380,
-20
],
"parameters": {
"color": 7,
"width": 800,
"height": 860,
"content": "# How to set up a Telegram Bot WebHook\n\n## WebHook Setup Process\n\n**Basic Concept**\nA WebHook allows your Telegram bot to automatically receive updates instead of manually polling the Bot API.\n\n**Setup Method**\nTo set a WebHook, make a GET request using this URL format:\n```\nhttps://api.telegram.org/bot{my_bot_token}/setWebhook?url={url_to_send_updates_to}\n```\nWhere:\n- `my_bot_token`: Your bot token from BotFather\n- `url_to_send_updates_to`: Your HTTPS endpoint that handles bot updates\n\n\n**Verification**\nTo verify the WebHook setup, use:\n```\nhttps://api.telegram.org/bot{my_bot_token}/getWebhookInfo\n```\n\nA successful response looks like:\n```json\n{\n \"ok\": true,\n \"result\": {\n \"url\": \"https://www.example.com/my-telegram-bot/\",\n \"has_custom_certificate\": false,\n \"pending_update_count\": 0,\n \"max_connections\": 40\n }\n}\n```\n\n\nThis method provides a simple and efficient way to handle Telegram bot updates automatically through webhooks rather than manual polling."
},
"typeVersion": 1
},
{
"id": "2b6149d5-ffd6-46ef-9840-149508251a77",
"name": "Validation",
"type": "n8n-nodes-base.set",
"position": [
-260,
160
],
"parameters": {
"options": {},
"assignments": {
"assignments": [
{
"id": "0cea6da1-652a-4c1e-94c3-30608ced90f8",
"name": "first_name",
"type": "string",
"value": "FirstName"
},
{
"id": "b90280c6-3e36-49ca-9e7e-e15c42d256cc",
"name": "last_name",
"type": "string",
"value": "LastName"
},
{
"id": "f6d86283-16ca-447e-8427-7d3d190babc0",
"name": "id",
"type": "number",
"value": 12345667891
}
]
},
"includeOtherFields": true
},
"typeVersion": 3.4
},
{
"id": "41c965ea-b67d-4d6b-82e4-0e57f5fc13bb",
"name": "Sticky Note4",
"type": "n8n-nodes-base.stickyNote",
"position": [
-320,
100
],
"parameters": {
"color": 7,
"width": 420,
"height": 260,
"content": "## Validate Telegram User\n"
},
"typeVersion": 1
},
{
"id": "164f5e91-1958-4dc5-b38c-db1cec0579d4",
"name": "Message Router",
"type": "n8n-nodes-base.switch",
"position": [
160,
160
],
"parameters": {
"rules": {
"values": [
{
"outputKey": "audio",
"conditions": {
"options": {
"version": 2,
"leftValue": "",
"caseSensitive": true,
"typeValidation": "strict"
},
"combinator": "and",
"conditions": [
{
"operator": {
"type": "object",
"operation": "exists",
"singleValue": true
},
"leftValue": "={{ $json.body.message.voice }}",
"rightValue": ""
}
]
},
"renameOutput": true
},
{
"outputKey": "text",
"conditions": {
"options": {
"version": 2,
"leftValue": "",
"caseSensitive": true,
"typeValidation": "strict"
},
"combinator": "and",
"conditions": [
{
"id": "342f0883-d959-44a2-b80d-379e39c76218",
"operator": {
"type": "string",
"operation": "exists",
"singleValue": true
},
"leftValue": "={{ $json.body.message.text }}",
"rightValue": ""
}
]
},
"renameOutput": true
},
{
"outputKey": "image",
"conditions": {
"options": {
"version": 2,
"leftValue": "",
"caseSensitive": true,
"typeValidation": "strict"
},
"combinator": "and",
"conditions": [
{
"id": "ded3a600-f861-413a-8892-3fc5ea935ecb",
"operator": {
"type": "array",
"operation": "exists",
"singleValue": true
},
"leftValue": "={{ $json.body.message.photo }}",
"rightValue": ""
}
]
},
"renameOutput": true
}
]
},
"options": {
"fallbackOutput": "extra"
}
},
"typeVersion": 3.2
},
{
"id": "7947173d-39fa-4d4b-9b1e-60de809a9950",
"name": "AI Agent",
"type": "@n8n/n8n-nodes-langchain.agent",
"onError": "continueErrorOutput",
"position": [
860,
340
],
"parameters": {
"text": "={{ $('Message Router').item.json.body.message.text }}",
"options": {
"systemMessage": "=## ROLE \nYou are a friendly, attentive, and helpful AI assistant. Your primary goal is to assist the user while maintaining a personalized and engaging interaction. The current user's first name is **{{ $json.body.message.from.first_name }}**.\n\n---\n\n## RULES \n\n1. **Memory Management**: \n - When the user sends a new message, evaluate whether it contains noteworthy or personal information (e.g., preferences, habits, goals, or important events). \n - If such information is identified, use the **Save Memory** tool to store this data in memory. \n - Always send a meaningful response back to the user, even if your primary action was saving information. This response should not reveal that information was stored but should acknowledge or engage with the user\u2019s input naturally.\n\n2. **Context Awareness**: \n - Use stored memories to provide contextually relevant and personalized responses. \n - Always consider the **date and time** when a memory was collected to ensure your responses are up-to-date and accurate.\n\n3. **User-Centric Responses**: \n - Tailor your responses based on the user's preferences and past interactions. \n - Be proactive in recalling relevant details from memory when appropriate but avoid overwhelming the user with unnecessary information.\n\n4. **Privacy and Sensitivity**: \n - Handle all user data with care and sensitivity. Avoid making assumptions or sharing stored information unless it directly enhances the conversation or task at hand.\n\n5. **Fallback Responses**: \n - **IMPORTANT** If no specific task or question arises from the user\u2019s message (e.g., when only saving information), respond in a way that keeps the conversation flowing naturally. For example:\n - Acknowledge their input: \u201cThanks for sharing that!\u201d \n - Provide a friendly follow-up: \u201cIs there anything else I can help you with today?\u201d\n - DO NOT tell Jokes as a fall back response.\n\n---\n\n## TOOLS \n\n### Save Memory \n- Use this tool to store summarized, concise, and meaningful information about the user. \n- Extract key details from user messages that could enhance future interactions (e.g., likes/dislikes, important dates, hobbies). \n- Ensure that the summary is clear and devoid of unnecessary details.\n\n---\n\n## MEMORIES \n\n### Recent Noteworthy Memories \nHere are the most recent memories collected from the user, including their date and time of collection: \n\n**{{ $('Retrieve Long Term Memories').item.json.content }}**\n\n### Guidelines for Using Memories: \n- Prioritize recent memories but do not disregard older ones if they remain relevant. \n- Cross-reference memories to maintain consistency in your responses. For example, if a user shares conflicting preferences over time, clarify or adapt accordingly.\n\n---\n\n## ADDITIONAL INSTRUCTIONS \n\n- Think critically before responding to ensure your answers are thoughtful and accurate. \n- Strive to build trust with the user by being consistent, reliable, and personable in your interactions. \n- Avoid robotic or overly formal language; aim for a conversational tone that aligns with being \"friendly and helpful.\" \n"
},
"promptType": "define"
},
"typeVersion": 1.7,
"alwaysOutputData": true
},
{
"id": "6111c771-d8af-4586-8829-213d86dc4f47",
"name": "Merge",
"type": "n8n-nodes-base.merge",
"position": [
860,
100
],
"parameters": {
"mode": "combine",
"options": {},
"combineBy": "combineAll"
},
"typeVersion": 3
},
{
"id": "94a01b4f-549d-4e49-88e0-143c90dd200e",
"name": "Window Buffer Memory",
"type": "@n8n/n8n-nodes-langchain.memoryBufferWindow",
"position": [
920,
780
],
"parameters": {
"sessionKey": "={{ $json.id }}",
"sessionIdType": "customKey",
"contextWindowLength": 50
},
"typeVersion": 1.3
},
{
"id": "d1182e11-025e-4885-abb1-b76a9b617b84",
"name": "When chat message received",
"type": "@n8n/n8n-nodes-langchain.chatTrigger",
"disabled": true,
"position": [
-480,
420
],
"parameters": {
"options": {}
},
"typeVersion": 1.1
},
{
"id": "97d4cdcd-b016-44aa-882c-eb2ec38968eb",
"name": "Sticky Note10",
"type": "n8n-nodes-base.stickyNote",
"position": [
440,
-20
],
"parameters": {
"color": 5,
"width": 1033,
"height": 1029,
"content": "# Process Text Message"
},
"typeVersion": 1
},
{
"id": "73156ecc-af5f-4e3d-82c6-4668db52b511",
"name": "Telegram Response",
"type": "n8n-nodes-base.telegram",
"position": [
1240,
160
],
"parameters": {
"text": "={{ $json.output }}",
"chatId": "={{ $('Listen for Telegram Events').item.json.body.message.chat.id }}",
"additionalFields": {
"parse_mode": "HTML",
"appendAttribution": false
}
},
"credentials": {
"telegramApi": {
"name": "<your credential>"
}
},
"typeVersion": 1.2
},
{
"id": "5f342299-40fe-44cf-9b58-8a9d3bfac1df",
"name": "Save Long Term Memories",
"type": "n8n-nodes-base.googleDocsTool",
"position": [
1260,
780
],
"parameters": {
"actionsUi": {
"actionFields": [
{
"text": "= Memory: {{ $fromAI('memory') }} - Date: {{ $now }} ",
"action": "insert"
}
]
},
"operation": "update",
"documentURL": "[Google Doc ID]",
"descriptionType": "manual",
"toolDescription": "Save memories"
},
"credentials": {
"googleDocsOAuth2Api": {
"name": "<your credential>"
}
},
"typeVersion": 2
},
{
"id": "aba001a8-68f9-4870-9cd0-60a4c59ecd5b",
"name": "Sticky Note3",
"type": "n8n-nodes-base.stickyNote",
"position": [
460,
220
],
"parameters": {
"color": 4,
"width": 300,
"height": 340,
"content": "## Retrieve Long Term Memories\nGoogle Docs"
},
"typeVersion": 1
},
{
"id": "e5ec71ec-9527-4ccd-87c3-3aa2f09192e8",
"name": "Retrieve Long Term Memories",
"type": "n8n-nodes-base.googleDocs",
"position": [
560,
360
],
"parameters": {
"operation": "get",
"documentURL": "[Google Doc ID]"
},
"credentials": {
"googleDocsOAuth2Api": {
"name": "<your credential>"
}
},
"typeVersion": 2,
"alwaysOutputData": true
},
{
"id": "4764383a-3c4b-4e64-b391-5dc9fb4b9de6",
"name": "Sticky Note5",
"type": "n8n-nodes-base.stickyNote",
"position": [
820,
660
],
"parameters": {
"width": 280,
"height": 320,
"content": "## Save To Current Chat Memory (Optional)"
},
"typeVersion": 1
},
{
"id": "e11995b8-e061-4b40-b4b6-9ec03c7e5a06",
"name": "Sticky Note6",
"type": "n8n-nodes-base.stickyNote",
"position": [
1160,
660
],
"parameters": {
"color": 4,
"width": 280,
"height": 320,
"content": "## Save Long Term Memories\nGoogle Docs"
},
"typeVersion": 1
},
{
"id": "1b53aef2-ca99-409b-bd10-3fc1fd87f540",
"name": "Response Error message",
"type": "n8n-nodes-base.telegram",
"position": [
1240,
360
],
"parameters": {
"text": "=Unable to process your message.",
"chatId": "={{ $('Listen for Telegram Events').item.json.body.message.chat.id }}",
"additionalFields": {
"appendAttribution": false
}
},
"credentials": {
"telegramApi": {
"name": "<your credential>"
}
},
"typeVersion": 1.2
},
{
"id": "e5d79084-d7f1-44fd-a1db-73cc76a148ec",
"name": "Sticky Note12",
"type": "n8n-nodes-base.stickyNote",
"position": [
-60,
660
],
"parameters": {
"color": 7,
"width": 820,
"height": 600,
"content": "# DeepSeek API Call\n\nThe DeepSeek API uses an API format compatible with OpenAI. By modifying the configuration, you can use the OpenAI SDK or softwares compatible with the OpenAI API to access the DeepSeek API.\n\nhttps://api-docs.deepseek.com/\n\n## Configuration Parameters\n\n| Parameter | Value |\n|-----------|--------|\n| base_url | https://api.deepseek.com |\n| api_key | https://platform.deepseek.com/api_keys |\n\n\n\n## Important Notes\n\n- To be compatible with OpenAI, you can also use `https://api.deepseek.com/v1` as the base_url. Note that the v1 here has NO relationship with the model's version.\n\n- The deepseek-chat model has been upgraded to DeepSeek-V3. The API remains unchanged. You can invoke DeepSeek-V3 by specifying `model='deepseek-chat'`.\n\n- deepseek-reasoner is the latest reasoning model, DeepSeek-R1, released by DeepSeek. You can invoke DeepSeek-R1 by specifying `model='deepseek-reasoner'`."
},
"typeVersion": 1
},
{
"id": "af14e803-44a5-4b0e-a675-b1e860bf6d29",
"name": "DeepSeek-R1 Reasoning",
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"position": [
440,
880
],
"parameters": {
"model": "=deepseek-reasoner",
"options": {}
},
"credentials": {
"openAiApi": {
"name": "<your credential>"
}
},
"typeVersion": 1.1
},
{
"id": "e8be6a32-ba4c-4895-b34b-c5e7d0ded5e8",
"name": "DeepSeek-V3 Chat",
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"position": [
600,
880
],
"parameters": {
"model": "=deepseek-chat",
"options": {}
},
"credentials": {
"openAiApi": {
"name": "<your credential>"
}
},
"typeVersion": 1.1
}
],
"active": false,
"settings": {
"timezone": "America/Vancouver",
"callerPolicy": "workflowsFromSameOwner",
"executionOrder": "v1"
},
"versionId": "2e669c98-e6ad-42f0-a642-de05e372937e",
"connections": {
"Merge": {
"main": [
[
{
"node": "AI Agent",
"type": "main",
"index": 0
}
]
]
},
"AI Agent": {
"main": [
[
{
"node": "Telegram Response",
"type": "main",
"index": 0
}
],
[
{
"node": "Response Error message",
"type": "main",
"index": 0
}
]
]
},
"Validation": {
"main": [
[
{
"node": "Check User & Chat ID",
"type": "main",
"index": 0
}
]
]
},
"Message Router": {
"main": [
[],
[
{
"node": "Merge",
"type": "main",
"index": 0
},
{
"node": "Retrieve Long Term Memories",
"type": "main",
"index": 0
}
],
[],
[
{
"node": "Error message",
"type": "main",
"index": 0
}
]
]
},
"DeepSeek-V3 Chat": {
"ai_languageModel": [
[
{
"node": "AI Agent",
"type": "ai_languageModel",
"index": 0
}
]
]
},
"Check User & Chat ID": {
"main": [
[
{
"node": "Message Router",
"type": "main",
"index": 0
}
],
[
{
"node": "Error message",
"type": "main",
"index": 0
}
]
]
},
"Window Buffer Memory": {
"ai_memory": [
[]
]
},
"Save Long Term Memories": {
"ai_tool": [
[
{
"node": "AI Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"Listen for Telegram Events": {
"main": [
[
{
"node": "Validation",
"type": "main",
"index": 0
}
]
]
},
"When chat message received": {
"main": [
[]
]
},
"Retrieve Long Term Memories": {
"main": [
[
{
"node": "Merge",
"type": "main",
"index": 1
}
]
]
}
}
}
Credentials you'll need
Each integration node will prompt for credentials when you import. We strip credential IDs before publishing — you'll add your own.
googleDocsOAuth2ApiopenAiApitelegramApi
Pro
For the full experience including quality scoring and batch install features for each workflow upgrade to Pro
How this works
This workflow enables seamless, intelligent conversations with an AI agent via Telegram, preserving context across interactions through long-term memory for more personalised and coherent responses. It's ideal for developers, customer support teams, or hobbyists seeking to build responsive chatbots without managing complex state manually. The core step involves routing incoming Telegram messages through a DeepSeek AI agent, enhanced by a memory buffer window that recalls prior exchanges, while integrating Google Docs for dynamic information retrieval during chats.
Use this when creating persistent AI assistants for Telegram-based queries, such as ongoing support tickets or personalised advice sessions, where maintaining conversation history is essential. Avoid it for one-off tasks or high-volume enterprise messaging that demands advanced scaling beyond 23 nodes. Common variations include swapping DeepSeek for another AI model or adding voice transcription for audio inputs.
About this workflow
🐋🤖 DeepSeek AI Agent + Telegram + LONG TERM Memory 🧠. Uses telegram, stickyNote, agent, memoryBufferWindow. Webhook trigger; 23 nodes.
Source: https://github.com/Zie619/n8n-workflows — original creator credit. Request a take-down →
Related workflows
Workflows that share integrations, category, or trigger type with this one. All free to copy and import.
🐋🤖 DeepSeek AI Agent + Telegram + LONG TERM Memory 🧠. Uses telegram, stickyNote, agent, memoryBufferWindow. Webhook trigger; 23 nodes.
Telegram, Agent, Memory Buffer Window +4
This n8n workflow template is designed to integrate a DeepSeek AI agent with Telegram, incorporating long-term memory capabilities for personalized and context-aware responses. Here's a detailed break
Telegram, Agent, Memory Buffer Window +4
Telegram Webhook. Uses telegram, agent, memoryBufferWindow, chatTrigger. Webhook trigger; 23 nodes.
Telegram, Agent, Memory Buffer Window +4
🧠 Give Your AI Agent Chatbot Long Term Memory Tools Router. Uses executeWorkflowTrigger, googleDocs, telegram, gmail. Event-driven trigger; 39 nodes.
Execute Workflow Trigger, Google Docs, Telegram +7
This n8n workflow equips your AI agent with long-term memory and a dynamic tools router, enabling it to provide intelligent, context-aware responses while managing tasks across multiple tools. By comb
Execute Workflow Trigger, Google Docs, Telegram +7