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

{
  "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')"
    }
  }
}