Telegram CoPilot icon

Telegram CoPilot

袙邪褕 锌械褉褋芯薪邪谢褜薪褘泄 Telegram CoPilot

Actions56

袩芯写邪褉芯泻 → 袩芯谢褍褔懈褌褜 锌芯谢褍褔械薪薪褘械 锌芯写邪褉泻懈

AI-generated

Overview

This node operation retrieves the list of gifts received by a specified owner, which can be either a user or a chat, identified by their ID. It supports filtering options to exclude certain types of gifts such as unsaved, saved, unlimited, limited, or upgraded gifts. Additionally, it allows sorting the results by price or send date and supports pagination through offset and limit parameters. This operation is useful for scenarios where you want to analyze or display gifts received by a user or chat in Telegram, for example, to track gift activity or manage gift-related data.

Use Case Examples

  1. Retrieve all gifts received by a user with user ID 12345, excluding unsaved gifts, sorted by price.
  2. Get the first 50 gifts received by a chat with chat ID -67890, excluding upgraded gifts and limited gifts.

Properties

Name Meaning
Owner ID Identifier of the gift receiver (user or chat). Use positive number for user ID, negative for chat ID.
Exclude Unsaved Whether to exclude gifts that are not saved to the chat's profile page
Exclude Saved Whether to exclude gifts that are saved to the chat's profile page
Exclude Unlimited Whether to exclude gifts that can be purchased unlimited number of times
Exclude Limited Whether to exclude gifts that can be purchased limited number of times
Exclude Upgraded Whether to exclude upgraded gifts
Sort by Price Whether to sort results by gift price instead of send date
Offset Offset of the first entry to return as received from the previous request; use empty string to get the first chunk of results
Limit Max number of results to return

Output

JSON

  • total_count - Total number of gifts matching the query
  • gifts - Array of gift objects received by the owner, each containing details about the gift

Dependencies

  • An API key credential for Telegram CoPilot API

Troubleshooting

  • Ensure the owner ID is valid: positive for user ID, negative for chat ID.
  • If 'Chat not found' or 'User not found' errors occur, verify the owner ID exists and is accessible.
  • Check API credentials are correctly set and the Telegram CoPilot session is active.
  • If the limit exceeds 100, it will be capped to 100 as per API constraints.

Links

Discussion