Table of Contents
/Xmpp/SendXmlMessage
Allows the client to send a custom XML normal message from its account to an XMPP recipient.
JSON
- Request
{ "to":Required(Str(PTo)), "subject":Optional(Str(PSubject)), "language":Optional(Str(PLanguage)), "id":Optional(Str(PId)), "xml":Required(Str(PXml)) }
- Response (if successful)
{ "sent":Required(Bool(PSent)), "id":Required(Str(PId)) }
XML
- Request
<SendXmlMessage xmlns="https://waher.se/Schema/BrokerAgent.xsd" to=(Required(Str(PTo))) subject=(Optional(Str(PSubject))) language=(Optional(Str(PLanguage))) id=(Optional(Str(PId)))> xml=(Required(Str(PXml))) />
- Response (if successful)
<StanzaResult xmlns="https://waher.se/Schema/BrokerAgent.xsd" sent=(Required(Bool(PSent))) id=(Required(Str(PId))) />
Input Parameters
Parameter | Description |
---|---|
PTo |
A Bare or Full JID (XMPP network address). |
PSubject |
Optional subject of message. |
PLanguage |
Optional ISO 639-1 language code. |
PId |
Optional Message ID. |
PXml |
The XML message to send. It can be sent as text or directly in XML (if sent embedded in XML). |
Response Parameters
Parameter | Description |
---|---|
PSent |
If the XMPP stanza was sent or not. |
Pid |
ID of stanza sent. Can be used to update message. If no ID was provided in the call, a message ID will be generated. |
Javascript Library
Use the following asynchronous method in the Javascript Library, to call this resource.
var Response = await AgentAPI.Xmpp.SendXmlMessage(To,Xml,Subject,Language,Id);
Note: The Subject
, Language
and Id
arguments are optional, and can be omitted, or set to null
or undefined
.