پرش به محتویات

مدیریت گفتگوها، گروه‌ها و اعضا (Chat Management)

ربات‌های کدمیت در صورت عضویت یا داشتن دسترسی ادمین در گروه‌ها و کانال‌ها، می‌توانند اطلاعات چت، لیست مدیران، وضعیت عضویت کاربران و سنجاق (Pin) کردن پیام‌ها را مدیریت کنند.

۱. دریافت اطلاعات گفتگو (getChat)

دریافت مشخصات کامل یک گفتگو، گروه یا کانال (شامل عنوان، بیوگرافی و تعداد اعضا):

POST https://botapi.codemeet.chat/bot<TOKEN>/getChat 
{
  "chat_id": "e9b2a1c0-4411-4fa3-9f88-d4508671b122"
}

نمونه پاسخ

{
  "ok": true,
  "result": {
    "id": "e9b2a1c0-4411-4fa3-9f88-d4508671b122",
    "type": "group",
    "title": "گروه توسعه‌دهندگان کدمیت",
    "description": "بحث و گفتگو پیرامون ساخت برنامه‌ها در کدمیت",
    "members_count": 142
  }
}

۲. بررسی وضعیت عضویت کاربر (getChatMember)

استعلام وضعیت یک کاربر خاص در چت (سازنده creator، ادمین administrator، عضو عادی member یا خارج‌شده left):

POST https://botapi.codemeet.chat/bot<TOKEN>/getChatMember 
{
  "chat_id": "e9b2a1c0-4411-4fa3-9f88-d4508671b122",
  "user_id": "c1f72b9a-1122-3344-5566-778899aabbcc"
}

نمونه پاسخ

{
  "ok": true,
  "result": {
    "user": {
      "id": "c1f72b9a-1122-3344-5566-778899aabbcc",
      "is_bot": false,
      "first_name": "سارا",
      "username": "sara_dev"
    },
    "status": "administrator",
    "is_anonymous": false
  }
}

۳. دریافت لیست ادمین‌های گفتگو (getChatAdministrators)

دریافت لیست تمام سازندگان و مدیران فعال در گروه یا کانال:

POST https://botapi.codemeet.chat/bot<TOKEN>/getChatAdministrators 
{
  "chat_id": "e9b2a1c0-4411-4fa3-9f88-d4508671b122"
}

۴. دریافت تعداد اعضای گفتگو (getChatMemberCount)

{
  "chat_id": "e9b2a1c0-4411-4fa3-9f88-d4508671b122"
}
پاسخ: 
{
  "ok": true,
  "result": 142
}

۵. سنجاق و حذف سنجاق پیام‌ها (pinChatMessage / unpinChatMessage / unpinAllChatMessages)

pinChatMessage

سنجاق کردن یک پیام در بالای صفحه گفتگو:

{
  "chat_id": "chat-id",
  "message_id": 45,
  "disable_notification": false
}

unpinChatMessage

برداشتن سنجاق یک پیام خاص: 

{
  "chat_id": "chat-id",
  "message_id": 45
}

unpinAllChatMessages

حذف سنجاق تمام پیام‌ها در چت: 

{
  "chat_id": "chat-id"
}