Send formatted message - Neuron Agent API

Overview

Send a formatted chat message. Provide Markdown in message and the server creates plain text and HTML representations for recipients to choose from.

HTTP request

POST /Agent/Xmpp/SendFormattedMessage

Authentication

Requires a valid JWT bearer token.

Request body

{
  "to": "bob@neuron.example.com",
  "message": "# Hello\n\n**Bold** and _italic_ text.",
  "subject": "",
  "language": "en",
  "id": ""
}

Field	Type	Required	Description
`to`	string	yes	Recipient JID (bare or full).
`message`	string	yes	Markdown body of the message.
`subject`	string	no	Optional subject line.
`language`	string	no	Optional ISO 639-1 language code.
`id`	string	no	Optional message id.

Response

{
  "sent": true,
  "id": "msg-67890"
}

Field	Type	Description
`sent`	boolean	Whether the stanza was sent.
`id`	string	Message id. Generated if not provided.

Example (curl)

curl -sS "https://$NEURON_HOST/Agent/Xmpp/SendFormattedMessage" \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "bob@neuron.example.com",
    "message": "# Hello\n\n**Bold** and _italic_ text.",
    "language": "en"
  }'

Send text message

Send text message Send presence subscription

⌘I

​Overview

​HTTP request

​Authentication

​Request body

​Response

​Example (curl)

​Related endpoints