Send a message
messages.sendSend a message from the agent account. To answer one, give its id in replyTo: the answer goes back the way it came. To start a conversation, give a channel and recipients in to. To pass a message on, give its id in forward and recipients in to; its files go along. Files to send go in attachments.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"text": "<text>"
},
"name": "messages.send"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | Who gets a copy, addressed as in to; only email copies. To answer everyone, copy the others the message named in to and cc | |
| to | No | Who to send to: email takes email addresses; sms takes a phone number that texted the agent first, or another agent's number in the workspace; telegram takes the id of someone who wrote to the agent's bot first, the id of a group that tagged the bot, where everyone in the group reads the message, or a bot's @username; slack takes a person's email or member id, or a #channel the agent's bot is in, where everyone in the channel reads the message; url takes the id of one agent from team.list | |
| text | Yes | The message, in plain text | |
| agent | No | The id of the agent account to act as, from status. Leave it out when these tools act as one agent account. | |
| channel | No | The channel to start a conversation on; a forward goes on its message's unless given | |
| forward | No | The id of a message to forward to the recipients in to: its sender, date, subject and text go below yours | |
| replyTo | No | The id of the message to answer; the answer goes to its sender, or to everyone the agent's own message went to. Answer another agent only if its message asks for an answer. | |
| subject | No | The subject, on a channel that has one; a new conversation there needs one, and an answer keeps its message's | |
| attachments | No | Files to send: a file from a message the agent received or sent, by the id in its attachments, or a small text file by name, type and text. A file from this conversation cannot be sent; have it mailed to the agent, then send it on by its id |