> For the complete documentation index, see [llms.txt](https://docs.innopaas.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.innopaas.com/api-reference/api-reference-en/whatsapp-business-api/webhook/inbox-chat-message-events.md).

# Inbox Chat Message Events

## Inbox chat message event

There are the following two push events; subscribe if needed:

**chat\_mt\_message\_notify (chatroom downstream message reception)** 

**chat\_mo\_message\_notify (chatroom upstream message reception)**

### Parameter description

<table data-header-hidden><thead><tr><th width="166.34375"></th><th width="141.6328125"></th><th width="137.5"></th><th></th></tr></thead><tbody><tr><td>Field</td><td>Data type</td><td>Required</td><td>Description</td></tr><tr><td>wabaId</td><td>String</td><td>Yes</td><td>Waba Id</td></tr><tr><td>from</td><td>String</td><td>Yes</td><td>Enterprise Sender</td></tr><tr><td>to</td><td>String</td><td>Yes</td><td>User WhatsApp number</td></tr><tr><td>messageType</td><td>String</td><td>Yes</td><td>Message type</td></tr><tr><td>context</td><td>Object</td><td>Yes</td><td>Message content</td></tr><tr><td>wamid</td><td>String</td><td>No</td><td>Meta message ID</td></tr><tr><td>conversationId</td><td>String</td><td>No</td><td>Session ID (InnoPaaS chatroom session ID)</td></tr><tr><td>uid</td><td>String</td><td>No</td><td>User-defined ID</td></tr><tr><td>sendTime</td><td>String</td><td>Yes</td><td>Send time, UTC, e.g.: 2026-07-09T09:11:23.405Z</td></tr><tr><td>sendTimestamp</td><td>String</td><td>Yes</td><td>Send timestamp, accurate to the millisecond, e.g.: 1783588283405</td></tr></tbody></table>

### **chat\_mt\_message\_notify**&#x20;

**Downlink message example**

<pre class="language-json"><code class="lang-json">{
    "id": "b5e984b3-21b2-42a9-b08b-72e5a4096ac6",
<strong>    "type": "chat_mt_message_notify",
</strong>    "eventTime": "2023-02-22T12:00:00.000Z",
    "body": {
        "wabaId": "WHATSAPP_BUSINESS_ACCOUNT_ID",
        "from": "wamid.BgNODYxN...",
        "to": "PHONE-NUMBER",
         "messageType": "text",
         "context": {
             "text":"this is test message"
           },
        "wamid": "wamid.BgNODYxN...",
        "conversationId": "12312312312312",
        "uid":"123123123123123213123",
        "sendTime":"2026-07-09T09:11:23.405Z",
        "sendTimestamp":"1783588283405"
    }
}
</code></pre>

### **chat\_mo\_message\_notify**&#x20;

**Upstream message example**

<pre class="language-json"><code class="lang-json">{
    "id": "b5e984b3-21b2-42a9-b08b-72e5a4096ac6",
<strong>    "type": "chat_mo_message_notify",
</strong>    "eventTime": "2023-02-22T12:00:00.000Z",
    "body": {
        "wabaId": "WHATSAPP_BUSINESS_ACCOUNT_ID",
        "from": "wamid.BgNODYxN...",
        "to": "PHONE-NUMBER",
         "messageType": "text",
         "context": {
             "text":"this is test message"
           },
        "wamid": "wamid.BgNODYxN...",
        "conversationId": "12312312312312",
        "uid":"123123123123123213123",
        "sendTime":"2026-07-09T09:11:23.405Z",
        "sendTimestamp":"1783588283405"
    }
}
</code></pre>