Insert a Chat Message
NOTE: To insert a chat message, the connector must run with delegated permissions, and not as a service application. For more information, see Process Data from a Single User.
To insert a chat message, your XML must include the following properties and metadata fields:
Type | Required | Name | Description |
---|---|---|---|
Property | Yes | Type
|
The type of item to insert. To insert a chat message, specify ChatMessage . |
Property |
Set one of:
|
TEAMID
|
The ID of the team that contains the channel. |
Property | CHANNELID
|
The ID of the channel to insert the message into. | |
Property | CHATID
|
The ID of the chat to insert the message into. | |
Property | RECIPIENT
|
The recipient to send the message to. (The sender is the user who the connector is logged in as). | |
Metadata field | Yes | Content
|
The message text. |
For example, the value of your insertXML
action parameter might look like this:
<insertXML> <insert> <property name="Type" value="ChatMessage"/> <property name="RECIPIENT" value="alice@example.com"/> <xmlmetadata> <Content>Hi Alice. How are you?</Content> </xmlmetadata> </insert> </insertXML>