From c09e0f732f054243b11bcf9e05a2948783980e00 Mon Sep 17 00:00:00 2001 From: Justin Ellingwood Date: Mon, 18 Nov 2024 11:14:54 +0000 Subject: [PATCH] Add common issues to Telegram Trigger node (#2618) --- .../common-issues.md | 29 +++++++++++++++++++ .../index.md} | 4 +++ mkdocs.yml | 4 ++- styles/config/vocabularies/default/accept.txt | 8 +++++ 4 files changed, 44 insertions(+), 1 deletion(-) create mode 100644 docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/common-issues.md rename docs/integrations/builtin/trigger-nodes/{n8n-nodes-base.telegramtrigger.md => n8n-nodes-base.telegramtrigger/index.md} (92%) diff --git a/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/common-issues.md b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/common-issues.md new file mode 100644 index 000000000..7352516fd --- /dev/null +++ b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/common-issues.md @@ -0,0 +1,29 @@ +--- +#https://www.notion.so/n8n/Frontmatter-432c2b8dff1f43d4b1c8d20075510fe4 +title: Telegram Trigger node common issues +description: Documentation for common issues and questions in the Telegram Trigger node in n8n, a workflow automation platform. Includes details of the issue and suggested solutions. +contentType: integration +priority: critical +--- + +# Telegram Trigger node common issues + +Here are some common errors and issues with the [Telegram Trigger node](/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/) and steps to resolve or troubleshoot them. + +## Stuck waiting for trigger event + +When testing the Telegram Trigger node with the **Test step** or or **Test workflow** buttons, the execution may appear stuck and unable to stop listening for events. If this occurs, you may need to exit the workflow and open it again to reset the canvas. + +Stuck listening events often occur due to issues with your network configuration outside of n8n. Specifically, this behavior often occurs when you run n8n behind a reverse proxy without configuring websocket proxying. + +To resolve this issue, check your reverse proxy configuration (Nginx, Caddy, Apache HTTP Server, Traefik, etc.) to enable websocket support. + + +## Bad request: bad webhook: An HTTPS URL must be provided for webhook + + +This error occurs when you run n8n behind a reverse proxy and there is a problem with your instance's webhook URL. + +When running n8n behind a reverse proxy, you must [configure the `WEBHOOK_URL` environment variable](/hosting/configuration/configuration-examples/webhook-url/) with the public URL where your n8n instance is running. For Telegram, this URL must use HTTPS. + +To fix this issue, configure TLS/SSL termination in your reverse proxy. Afterward, update your `WEBHOOK_URL` environment variable to use the HTTPS address. diff --git a/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger.md b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md similarity index 92% rename from docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger.md rename to docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md index b0b93f02f..8660b7bc2 100644 --- a/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger.md +++ b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md @@ -38,3 +38,7 @@ n8n provides an app node for Telegram. You can find the node docs [here](/integr View [example workflows and related content](https://n8n.io/integrations/telegram-trigger/){:target=_blank .external-link} on n8n's website. Refer to [Telegram's API documentation](https://core.telegram.org/bots/api){:target=_blank .external-link} for details about their API. + +## Common issues + +For common questions or issues and suggested solutions, refer to [Common issues](/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/common-issues/). diff --git a/mkdocs.yml b/mkdocs.yml index ff767debc..83248e839 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -806,7 +806,9 @@ nav: - Stripe Trigger: integrations/builtin/trigger-nodes/n8n-nodes-base.stripetrigger.md - SurveyMonkey Trigger: integrations/builtin/trigger-nodes/n8n-nodes-base.surveymonkeytrigger.md - Taiga Trigger: integrations/builtin/trigger-nodes/n8n-nodes-base.taigatrigger.md - - Telegram Trigger: integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger.md + - Telegram Trigger: + - Telegram Trigger: integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md + - Common issues: integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/common-issues.md - TheHive 5 Trigger: integrations/builtin/trigger-nodes/n8n-nodes-base.thehive5trigger.md - TheHive Trigger: integrations/builtin/trigger-nodes/n8n-nodes-base.thehivetrigger.md - Toggl Trigger: integrations/builtin/trigger-nodes/n8n-nodes-base.toggltrigger.md diff --git a/styles/config/vocabularies/default/accept.txt b/styles/config/vocabularies/default/accept.txt index 89c2e7466..8b7e308f3 100644 --- a/styles/config/vocabularies/default/accept.txt +++ b/styles/config/vocabularies/default/accept.txt @@ -177,6 +177,8 @@ NASA Netlify Netscaler Nextcloud +Nginx +nginx ngrok Nodelinter npm @@ -206,6 +208,8 @@ Prefilled prefilled Prepopulate prepopulate +Proxying +proxying Pushbullet Pushcut Pyodide @@ -299,6 +303,10 @@ Vuex Wasabi's Webex Webflow +Websocket +websocket +Websockets +websockets WeKan Wireframe wireframe