N8N Tools Telegram icon

N8N Tools Telegram

Interact with Telegram Bot API

Overview

This node integrates with the Telegram Bot API via the N8N Tools Telegram service, enabling automation workflows to interact with Telegram bots. Specifically for the Bots resource and the Get My Short Description operation, it retrieves the short description of the bot associated with the connected Telegram API credentials.

Common scenarios where this node is beneficial include:

  • Fetching the current short description of a Telegram bot to display or log it.
  • Using the bot's short description as part of a monitoring or reporting workflow.
  • Validating or auditing bot metadata in automated processes.

Practical example:

  • A workflow that periodically checks the bot’s short description to ensure it matches expected content, triggering alerts if it changes unexpectedly.

Properties

Name Meaning
Options Additional options as a JSON object. For the Bots resource operations, can include parameters like language_code to specify language context when retrieving descriptions.

Output

The node outputs an array of items, each containing a json field with the response from the Telegram Bot API for the requested operation.

For the Get My Short Description operation, the output JSON contains the bot's short description details as returned by the Telegram API. This typically includes fields such as the short description text and possibly language information if specified.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Telegram Bot API via an API key credential.
  • Uses the N8N Tools API service for validation before making Telegram API calls; this requires a valid subscription and API key for the N8N Tools API.
  • The node expects configuration of these credentials within n8n:
    • An API key credential for the N8N Tools API (used for validation).
    • Telegram Bot API credentials for accessing Telegram endpoints.

Troubleshooting

  • Invalid subscription or API key error:
    If the node throws an error indicating invalid subscription or API key, verify that the N8N Tools API key credential is correctly configured and active. Ensure the API key has the necessary permissions and is not expired.

  • Unknown operation error:
    If an unknown operation error occurs, confirm that the selected operation matches one of the supported operations under the Bots resource. For "Get My Short Description," ensure the operation name is exactly as expected.

  • Network or HTTP errors:
    Network issues or Telegram API downtime may cause request failures. Check network connectivity and Telegram service status.

  • Malformed JSON in Options property:
    Since the Options property accepts JSON input, ensure the JSON syntax is correct to avoid parsing errors.

Links and References

Discussion