Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.plura.ai/llms.txt

Use this file to discover all available pages before exploring further.

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"
}

Receiving AI Responses

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

Typing Indicators

Signal when the user is typing (visible in the Plura AI inbox dashboard):
{ "message": true, "type": "typing" }
{ "message": false, "type": "typing" }

Heartbeat

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"
}
FieldFormatExample
stampYYYY-MM-DDTHH:mm:ss2025-11-06T21:59:02
tzTimezone offset+04:00, -05:00

Message Types Reference

TypeDirectionDescription
messageSend / ReceiveUser message (send) or AI response (receive)
recvReceiveConfirmation that your message was received
sessionReceiveSession ID on initial connect
chatownerReceiveChat owner info on initial connect
typingSendTyping indicator
heartbeatSendKeep-alive signal (every 15s)