Sending Messages - Documentation

Sending a User Message

{
  "message": "Your message text here",
  "type": "message"
}

Receive confirmation:

{
  "type": "recv",
  "id": "{message-id}",
  "profilepic": "{user-profile-pic}",
  "name": "Anonymous",
  "content": "Your message text here"
}

{
  "type": "message",
  "id": "{message-id}",
  "profilepic": "{assistant-image-url}",
  "name": "Assistant",
  "content": "AI response text here"
}

Signal when the user is typing (visible in the Plura AI inbox dashboard):

{ "message": true, "type": "typing" }

{ "message": false, "type": "typing" }

Required. Send a heartbeat every 15 seconds to maintain the connection and show the user as online.

{
  "message": {
    "stamp": "2025-11-06T21:59:02",
    "tz": "+04:00"
  },
  "type": "heartbeat"
}

Field	Format	Example
`stamp`	`YYYY-MM-DDTHH:mm:ss`	`2025-11-06T21:59:02`
`tz`	Timezone offset	`+04:00`, `-05:00`

Type	Direction	Description
`message`	Send / Receive	User message (send) or AI response (receive)
`recv`	Receive	Confirmation that your message was received
`session`	Receive	Session ID on initial connect
`chatowner`	Receive	Chat owner info on initial connect
`typing`	Send	Typing indicator
`heartbeat`	Send	Keep-alive signal (every 15s)

⌘I