Перейти к содержимому
Agentum Cloud для разработчиков

Sync Bot Chat

POST
/v1/bots/{bot_id}/chats/{chat_id}/sync
curl --request POST \
  --url https://api.cloud.agentums.ru/v1/bots/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/chats/1/sync \
  --header 'Authorization: Bearer <token>'

Перечитать паспорт чата у Telegram прямо сейчас, не дожидаясь TTL.

Ручка нужна именно потому, что автообновление ленивое: владелец добавил людей и хочет увидеть это немедленно, а не через двенадцать часов. Сбой Telegram не ошибка запроса — отдаём карточку как есть, просто без свежих данных.

Authorizations

Заголовок раздела «Authorizations»

Parameters

Заголовок раздела «Parameters»

Path Parameters

Заголовок раздела «Path Parameters»
bot_id
required
Bot Id
string format: uuid
chat_id
required
Chat Id
integer

Responses

Заголовок раздела «Responses»

200

Заголовок раздела «200»

Successful Response

Media typeapplication/json
BotChatDetailOut
object
chat_id
required
Chat Id
integer
collection_id
Collection Id
string
""
description
Description
string
""
known_count
Known Count
integer
0
last_seen_at
Last Seen At
string
""
member_count
Member Count
integer
0
members
Members
Array<object>
BotChatMemberOut

Человек из группы. source не косметика: у админа может не быть ни одной реплики, и пустое last_seen_at у него означает «мы его не слышали», а не «давно не заходил».

object
display_name
Display Name
string
""
is_admin
Is Admin
boolean
last_seen_at
Last Seen At
string
""
role
Role
string
""
source
Source
string
default: spoke
tg_user_id
required
Tg User Id
integer
username
Username
string
""
note_object_id
Note Object Id
string
""
proactive_allowed
Any of:
boolean
synced_at
Synced At
string
""
title
required
Title
string
Example
{
  "collection_id": "",
  "description": "",
  "known_count": 0,
  "last_seen_at": "",
  "member_count": 0,
  "members": [
    {
      "display_name": "",
      "is_admin": false,
      "last_seen_at": "",
      "role": "",
      "source": "spoke",
      "username": ""
    }
  ],
  "note_object_id": "",
  "synced_at": ""
}

422

Заголовок раздела «422»

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}