Message

chat_id
Type: integer
required

ID of the groups that the message belongs to
created_at
Type: stringFormat: date-time
required

The date and time (UTC) that the message was created.
edited_at
Type: string | null
required

The date and time (UTC) that the message content was last edited, or null if it has never been edited.
edited_version
Type: integer
required

How many times the message was edited
id
Type: integer
required

ID of the message
parent_id
Type: integer | null
required

ID of the parent message. This value is expected only when the message is in a thread, in response to another message.
text
Type: string
required

The text of the message
updated_at
Type: stringFormat: date-time
required

The date and time (UTC) that the message was last updated.
user_id
Type: integer | null
required

ID of the user that created the message. Null for system-generated messages.
attachment
Type:

This property is deprecated and will be removed soon. Please use attachments instead.

If the message has more than one attachment, this property will be the first attachment. Never included in webhook event payloads.

Properties: 8
attachments
Type:
Properties: 8
chat
Type:

The chat or thread the message was posted in, so consumers can tell a thread from a regular chat (and find the parent chat) without an extra API round-trip. Only present in webhook event payloads.

Properties: 18
conversation_id
Type: integer

Stable identifier grouping this message into a conversation, for integrations that track context across related messages (for example, chatbot sessions). Resolves to the source message ID of the thread the message was posted in, else the ID of the message it replies to, else the message's own ID. Only present in webhook event payloads.
everyone_mentioned
Type: boolean

Whether the message mentions everyone in the chat.
language
Type: string | null

The detected language of the message text (locale), or null/unknown if it could not be determined.
location_accuracy
Type: number | null

Accuracy (in meters) of the shared location, if any.
location_lat
Type: number | null

Latitude of a location shared with the message, if any.
location_long
Type: number | null

Longitude of a location shared with the message, if any.
meeting
Type: nullable

The meeting associated with this message, or null.

Properties: 16
meeting_id
Type: integer | null

ID of the meeting associated with this message, if any.
mentions
Type:

Users mentioned in the message.

Properties: 22
poll
Type: nullable

The poll associated with this message, or null.

Properties: 14
poll_id
Type: integer | null

ID of the poll associated with this message, if any.
reactions
Type:

A summary of the reactions on the message, grouped by emoji.

Properties: 5
resource
Type: nullable

The unfurled link resource associated with this message, or null.

Properties: 9
resource_id
Type: integer | null

ID of the unfurled link resource associated with this message, if any.
system_event
Type: string | null

For system-generated messages, the type of system event. Null for normal user messages.
system_message_parts
Type: object | null

Structured parts used to render a system message. Null for normal user messages.
task
Type: nullable

The task associated with this message, or null.

Properties: 14
task_id
Type: integer | null

ID of the task associated with this message, if any.
thread
Type: nullable

The thread referenced by this message, or null.

Properties: 18
thread_id
Type: integer | null

ID of the thread referenced by this message, if any.
user
Type: nullable

The user who sent the message. Null for system-generated messages.

Properties: 22

Examples

{
  "id": 7846871,
  "user_id": 12345,
  "group_id": 54321,
  "message": "Hello, world!",
  "created_at": "2021-07-22T18:05:53Z",
  "updated_at": "2021-07-22T18:05:53Z"
}

User

Message_Search_Result