Canvas allows for an e-mail like communication with students, called 'conversations', which can be handled from the API.
create_conversation(
canvas,
recipients = NULL,
subject = " ",
body = " ",
force_new = TRUE,
group_conversation = FALSE,
attachments = NULL,
attachment_ids = NULL,
media_comment_id = NULL,
media_comment_type = NULL,
mode = "sync",
scope = NULL,
filter = NULL,
filter_mode = NULL,
context_code = NULL
)A confirmation message indicating that the message has been successfully send.
An object containing the Canvas API key and base URL,
An array of recipient ids.
The subject of the conversation. Maximum length is 255 characters.
The message to be sent. Unfortunately, Canvas only allows for plain text.
logical. Forces a new message to be created, even if there is an existing private conversation.
logical. Defaults to FALSE. When false, individual private
conversations will be created with each recipient. If true, this will be a group
conversation (i.e. all recipients may see all messages and replies). Must be set true
if the number of recipients is over the set maximum (default is 100).
An array of paths to local files that should be uploaded.
An array of attachments ids. These must be files that have been previously uploaded to the sender's 'conversation attachments' folder.
Media comment id of an audio or video file to be associated with this message.
Type of the associated media file, values allowed are audio or
video.
Determines whether the messages will be created/sent synchronously or
asynchronously. Defaults to sync.
Used when generating 'visible' in the API response, values allowed are unread,
starred, archived.
Used when generating 'visible' in the API response.
Used when generating 'visible' in the API response, values allowed are and, or
(default).
The course or group that is the context for this conversation. Same format as courses or groups in the recipients argument.
Note that the user should have rights to access the folder.
get_single_conversation() and get_conversations().