Skip to main content

Get Contacts

Retrieves the list of contacts from the Telegram client.

Common Properties

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs

  • Client Id - The unique identifier of the Telegram client to use for this operation.

Output

  • Contacts - An array of contact objects containing contact information.

How It Works

The Get Contacts node retrieves the list of contacts from the Telegram client. When executed, the node:

  1. Validates the provided Client Id input
  2. Uses the Telegram client to fetch the contacts list
  3. Processes each contact to extract relevant information:
    • ID
    • Access hash
    • First name
    • Last name
    • Username
    • Phone number
  4. Returns the list of contacts as output

Requirements

  • A valid Telegram client session with appropriate permissions
  • Client Id must match an existing Telegram client session

Error Handling

The node will return specific errors in the following cases:

  • Empty or invalid Client Id

Usage Notes

  • The output contains detailed information about each contact
  • The contact information can be used in other Telegram nodes that require user identification
  • The Client Id must correspond to an active Telegram client session