N8N Tools Telegram icon

N8N Tools Telegram

Interact with Telegram Bot API

Overview

The node integrates with the Telegram Bot API to perform various chat-related operations. Specifically, for the "Chats" resource and the "Set Chat Title" operation, it allows users to change the title of a Telegram chat by specifying the chat's unique identifier and the new title. This is useful in scenarios where you want to programmatically update group or channel names based on workflow events or external triggers.

Practical examples include:

  • Automatically renaming a group chat when a project phase changes.
  • Updating a channel title to reflect current promotions or announcements.
  • Managing multiple chats dynamically from an automation workflow.

Properties

Name Meaning
Chat ID The unique identifier of the Telegram chat whose title you want to set (required).
Options Additional optional parameters as a JSON object (not specifically used in this operation but available for extensibility).

Note: For the "Set Chat Title" operation, an additional property named title (string) is required to specify the new chat title, although it was not included in the provided properties snippet. This is inferred from the source code usage.

Output

The node outputs a JSON object representing the response from the Telegram Bot API after attempting to set the chat title. This typically includes confirmation details about the updated chat or an error message if the operation failed.

No binary data output is involved in this operation.

Example output structure (simplified):

{
  "ok": true,
  "result": {
    "id": 123456789,
    "title": "New Chat Title",
    "type": "group"
  }
}

Dependencies

  • Requires a valid Telegram Bot API token configured as credentials in n8n.
  • Requires access to the "N8N Tools API" service for subscription validation via an API key credential.
  • The node uses HTTP requests to communicate with both the N8N Tools API and the Telegram Bot API endpoints.

Troubleshooting

  • Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that your API key credential for the N8N Tools API is correct and active.
  • Missing Required Parameters: Ensure that the chatId and title parameters are provided and correctly formatted.
  • Permission Errors: The bot must have appropriate permissions to change the chat title; otherwise, the Telegram API will reject the request.
  • Unknown Operation Error: If the operation name is incorrect or unsupported, the node will throw an error. Confirm that "setChatTitle" is selected under the "Chats" resource.
  • JSON Parsing Errors: When providing JSON input in options or other fields, ensure the JSON is valid to avoid parsing errors.

Links and References

Discussion