N8N Tools Telegram icon

N8N Tools Telegram

Interact with Telegram Bot API

Overview

The node "N8N Tools Telegram" integrates with the Telegram Bot API, enabling automation workflows to interact with Telegram bots and their features. Specifically, for the Updates resource and the Get Webhook Info operation, this node retrieves information about the current webhook status of a Telegram bot.

This operation is useful when you want to:

  • Check if a webhook is set up for your Telegram bot.
  • Retrieve details such as the webhook URL, pending update count, and last error messages related to the webhook.
  • Monitor and debug webhook configurations in automated workflows.

Practical example:

  • After setting a webhook for your Telegram bot, use this node operation to verify that the webhook is active and correctly configured.
  • Use it in monitoring workflows to alert if the webhook becomes inactive or encounters errors.

Properties

Name Meaning
Options Additional options as a JSON object to customize the request (optional, depends on context)

For the Updates resource and Get Webhook Info operation, only the "Options" property is relevant, allowing users to pass extra parameters if needed.

Output

The output of the Get Webhook Info operation is a JSON object containing the webhook status and details as returned by the Telegram Bot API. Typical fields include:

  • url: The webhook URL currently set.
  • has_custom_certificate: Whether a custom certificate is used.
  • pending_update_count: Number of updates waiting to be delivered.
  • last_error_date: Timestamp of the last error.
  • last_error_message: Description of the last error.
  • max_connections: Maximum allowed simultaneous HTTPS connections.
  • allowed_updates: List of update types the bot is subscribed to.

The node outputs this data under the json field for each input item processed.

Dependencies

  • Requires an active Telegram Bot API token credential to authenticate requests.
  • Requires a subscription and valid API key for the external "N8N Tools API" service, which validates usage before forwarding requests to Telegram.
  • The node uses the "N8N Tools API" base URL and API key from credentials to validate the operation before calling Telegram endpoints.

Troubleshooting

  • Invalid subscription or API key error: If the node throws an error indicating invalid subscription or API key, verify that the API key credential for the external validation service is correct and active.
  • Unknown operation error: Ensure the selected operation matches the supported operations for the chosen resource.
  • Webhook info retrieval failure: Could be due to network issues, invalid bot token, or Telegram API downtime. Check credentials and network connectivity.
  • Malformed JSON in Options: If passing additional options, ensure the JSON syntax is correct to avoid parsing errors.

Links and References

Discussion