message.received
Fired when a bot receives a message in an accessible conversation
When to use this
Primary inbound trigger for bot logic.
Auth
Requires authenticated bot Socket.IO connection.
Event Payload
| Field | Type | Description |
|---|---|---|
event_id | string | Unique event identifier |
bot_id | string | Receiving bot ID |
message | BotMessage | Incoming message object |
received_at | string | ISO timestamp |
Acknowledgment
No explicit ack required. Handle asynchronously and send replies via REST.
Errors
Malformed payloads are not delivered; connection-level issues appear as Socket.IO errors.
cURL
Not applicable for inbound events.
TypeScript
socket.on("message.received", async (event) => {
console.log(event.message.content);
});Retry behavior
Use event_id for deduplication in your bot if reconnects cause redelivery.