Workspace Chats

Update shared workspace CRM chat metadata

Applies a partial update to the shared CRM chat row in frontend DB for the canonical Telegram chat id. Changes propagate across workspace copies of the same chat. Send empty strings to clear scalar fields.

patch/v1/workspace/chats/{chat_id}

Request

  • Base URL: https://api.entergram.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.entergram.com/v1/workspace/chats/{chat_id}
  • Auth: API key in header X-API-Key

Path parameters

chat_idstring required

Canonical Telegram chat identifier.

Example:-1000001234567

Request body

emailstring

Workspace CRM email for the chat. Send an empty string to clear it.

phoneNumberstring

Workspace CRM phone number for the chat. Send an empty string to clear it.

prioritystring

Workspace CRM priority label. Send an empty string to clear it.

telegramFirstNamestring

Workspace override for Telegram first name. Send an empty string to clear it.

telegramLastNamestring

Workspace override for Telegram last name. Send an empty string to clear it.

Example request

{
  "email": "alex@example.com",
  "phoneNumber": "+48123123123",
  "priority": "High",
  "telegramFirstName": "Alex",
  "telegramLastName": "Johnson"
}

Response

OK

Example response

{
  "data": {
    "commentCount": 2,
    "connectedAccount": {
      "color": "#2563eb",
      "displayName": "Ops Sample",
      "id": "acct_demo_123",
      "username": "ops_sample"
    },
    "description": "Synthetic example chat for API documentation.",
    "id": "chat_demo_123",
    "inviteLink": "https://t.me/+sampleinvite123",
    "lastCommentBody": "Synthetic note for documentation only.",
    "lastMessage": {
      "id": "123456",
      "sender": {
        "displayName": "David Hngr",
        "id": "580876383"
      },
      "serviceAction": "setMessagesTTL",
      "text": "Please review the sample request.",
      "timestamp": 1774728948,
      "type": "message"
    },
    "lastMessageText": "Please review the sample request.",
    "lastMessageTimestamp": 1774728948,
    "membersCount": 245,
    "name": "Support Queue Alpha",
    "openTicketCount": 2,
    "photoUrl": "https://cdn.example.test/chat-photo.png",
    "status": "active",
    "telegramId": "-1000001234567",
    "telegramUsername": "samplecommunity",
    "ticketCount": 3,
    "title": "Community Alpha",
    "type": "group",
    "unreadCount": 4,
    "username": "support_queue_alpha"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.