Direct message
inbox.message_received · Planned: built in order of demand
What it is
Private: from accounts you connect, delivered only to you.
- Example: New Instagram DM: Is the blue one still available?
- Standard envelope; a typed payload schema comes with its first source
- Not collected yet: ask for it and it moves up the list
Used for
Example event, standard format
{
"specversion": "1.0",
"id": "evt_01M5EV0NM0GQ3WHJKANZQZ9JS9",
"type": "inbox.message_received",
"source": "/sources/examples/inbox",
"time": "2026-10-21T09:00:00Z",
"observed_at": "2026-10-21T09:00:42Z",
"dataschema": "https://schemas.worldsignals.dev/inbox.message_received/1.json",
"datacontenttype": "application/json",
"visibility": "private",
"tenant": "tnt_example",
"subject": {
"kind": "message",
"name": "Direct message",
"ws_id": "ent_01M5EV0NM0T1X12XCN9ERZ7KBR"
},
"entities": [
{
"kind": "account",
"role": "inbox",
"name": "@yourbrand on Instagram"
}
],
"title": "New Instagram DM: Is the blue one still available?",
"data": {
"channel": "instagram_dm",
"text": "Hi, is the blue one still available?"
},
"provenance": {
"source_id": "example",
"source_name": "Example data",
"url": "https://example.com/worldsignals/inbox.message_received",
"licence": "Example only, not a real record",
"method": "example"
},
"confidence": 0.95,
"personal_data": true,
"revision": 1,
"tags": [
"example"
]
}
Give your agents something to notice
Join the waiting list, free during early access. Pick these events and we’ll email you when you’re in.