👥 Контакты

Список активных контактов из кэша LOGIN-ответа. Загружается при connect().

for contact in client.cached_contacts:
    print(contact.get('id'), contact.get('name'))

Возвращает список контактов по статусу с сервера. Подтверждено ✅

# Заблокированные контакты
blocked = await client.get_contacts(status="BLOCKED")
print(f"Заблокировано: {len(blocked)}")

# Удалённые контакты
removed = await client.get_contacts(status="REMOVED")

Ищет аккаунт по номеру телефона. Подтверждено ✅

result = await client.get_contact_by_phone("+79999999999")

if result.get("contact"):
    print("Аккаунт найден", result["contact"]["id"])
else:
    print(result.get("error"))

Пример успешного ответа

{
  "contact": {
    "id": 61091213,
    "updateTime": 1774268217766,
    "names": [
      {
        "name": "Телеграм",
        "firstName": "Телеграм",
        "lastName": "",
        "type": "ONEME"
      }
    ],
    "options": ["TT", "ONEME"],
    "accountStatus": 0,
    "country": ""
  }
}

Пример ответа, если номер не найден

{
  "error": "contact.not.found",
  "message": "Cannot found contact by phone",
  "localizedMessage": "Контакт не найден",
  "title": "Контакт не найден"
}

Поиск пользователей по имени или номеру телефона.

results = await client.search_contacts("Новости")

print(results["total"])
for c in results.get("result", []):
    print(c.get("id"), c.get("name"))

Пример реального ответа

{
  "result": [],
  "total": 0
}

Глобальный поиск — аналог get_entity() в Telethon. Одновременно ищет в кэше чатов, серверных контактах и публичных чатах.

Источники результатов

contacts и public запрашиваются параллельно через asyncio.gather().

results = await client.search("Новости")

    print(results["public_total"])
    print(results["public_ucpQId"])
    print(results["public_raw"]["total"])

for chat in results["chats"]:
    print("Чат:", chat["id"])

for c in results["contacts"]:
    print("Контакт:", c.get("name"), c["id"])

for p in results["public"]:
    chat = p.get("chat", {})
    print("Публичный чат:", chat.get("title"), chat.get("link"))

Пример реального PUBLIC_SEARCH-ответа

{
  "result": [
    {
      "chat": {
        "id": -69106129488590,
        "type": "CHANNEL",
        "title": "Новости",
        "link": "https://max.ru/politics_today",
        "participantsCount": 30205,
        "description": "Главные новости из России и мира"
      },
      "highlights": ["Новости", "новости"]
    }
  ],
  "total": 7,
  "ucpQId": "f75fa88e0e24be98"
}

Вывод по живой проверке

search_contacts("Новости") -> {"result": [], "total": 0}
PUBLIC_SEARCH("Новости") -> 7 публичных результатов
    search("Новости") -> chats=2, contacts=0, public=7

Получить информацию о конкретном пользователе по UID. Высокоуровневой обёртки нет — используйте напрямую:

info = await client._send_command(
    OpCode.CONTACT_INFO,
    {"uid": 27993802}
)

Получить онлайн-статус пользователя.