Incoming Messages —Applies to All Messages

The message event delivers every incoming message to your bot — text, media, contacts, locations, everything.

💡 One event, every message type. Read message.type to decide how to handle it.

Event

method is "message".

Field	Type	Returned	Description
`method`	String	Yes	`"message"`
`message`	Message	Yes	The message itself — sender, chat, content, and type.
`app_id`	String	Yes	The app the message belongs to.

SDKs

SDK	Callback
Java	`onReceive(IncomingMessage incomingMsg)`
JavaScript	`onReceive(incomingMsg)`
Python	`on_receive(self, incoming_msg)`

Example

Event — text message

json
{
  "method": "message",
  "app_id": 90090684293000559,
  "message": {
    "message_id": "d1_y7Zt2lJr126176",
    "type": "text",
    "text": "hello world 3",
    "date": 1741955050810,
    "reference": 111111124,
    "gmid": "13",
    "style": 0,
    "chat": {
      "id": "90090684438172188",
      "title": "New Chat",
      "type": "Group"
    },
    "from": {
      "id": "90091783822039252",
      "name": "Test Bot V4",
      "type": "Bot",
      "terminal": "API",
      "version": "('0twD')"
    }
  }
}