The main message method defines all parameters for all incoming messages to the bot.

Field	Type	Required	Description
message_id	String	Yes	Unique identifier for this message.
reference	Long	Yes	Unique local identifier.
chat	Chat	Yes	Conversation the message belongs to.
from	User	Yes	Sender (user) of this message.
sent_to	User	Yes	Receiver (user): in most cases, it is the bot ID, except if the channel has multiple administrators; it will be the specific admin who should receive the message.
type	String	Yes	type: ’text’: for text messages. ’text_file’: any message exceeding 1800 characters will be converted to text file. ’photo’: message is a photo. ’gif’: message is a GIF ’sticker’: message is a sticker. ’video’: message is a video. ’audio’: message is an audio. ’voice’: message is a voice note. ’location’: message is a location. ’contact’: message is a contact. ’document’: message is a document.
date	Long	Yes	The date of the message that was sent is the Unix Epoch timestamp in milliseconds.
reply_to_message_id	String	Optional	Unique identifier for the parent message.
from_admin	Integer	Optional	1 if its from an admin user; otherwise, it is 0.
text	String	Conditional	Only available when its type is text.
text_file	Text_File	Conditional	Only available when its type is text_file.
photo	Media File	Conditional	Only available when its type is photo.
gif	Media File	Conditional	Only available when its type is gif.
sticker	Sticker	Conditional	Only available when its type is sticker.
video	Media File	Conditional	Only available when its type is video.
audio	Media File	Conditional	Only available when its type is audio.
voice	Media File	Conditional	Only available when its type is voice.
document	Media File	Conditional	Only available when its type is document.
location	Location	Conditional	Only available when its type is location.
contact	Contact	Conditional	Only available when its type is contact.
status	String	Optional	‘deleted’: if messages is recalled and updated if it is updated.
chat_settings	Integer	Optional	1 if its from chat settings bot; otherwise, it is 0.
menu_ref	String	Optional	Menu reference for existing predefined menu: the menu will be displayed as inline menu associated to the message.
inline_menu	Array of Menu	Optional	Inline menu object to hold menus: if both inline_menu and menu_ref are defined, the priority goes to inline_menu.
caption	String
bg_color	String
article	Article
url	String
white_list_user	WhiteListUser
tag	TagDefinition
schedule_date	Long	Optional	Long-time format: ex. (1579102262)

Text_File

This object represents a text file.

Field	Type	Required	Description
Id	String	Yes	Unique identifier for this file.
size	Integer	Yes	File size.

Objects

json
{
  "message": {
    "date": 1512445910180,
    "gif": {
      "thumbnail": {
        "width": 256,
        "id": "cfdb3cc5.gif.thumb.jpg",
        "height": 191
      },
      "size": 4136640,
      "width": 443,
      "id": "cfdb3cc5.gif.thumb.jpg",
      "height": 332
    },
    "chat": {
      "name": "chat 1",
      "id": "4522291356145774",
      "type": 0
    },
    "message_id": "d2_QhlW1MAH12617138",
    "from": {
      "name": "john smith",
      "id": "4521191845180798",
      "type": 0,
      "version": "(&#39;0hn0&#39;,&#39;1YDA&#39;,&#39;2ViB&#39;,&#39;32Fg&#39;)"
    },
    "type": "gif"
  }
}

Message

Text_File

Objects