Advanced topics

Advanced topics and features of the messaging module

This page describes advanced usage of our Messaging module with options about Conversation creation and management.

Conversation creation

Sending a first message on Patient's behalf

You can create a conversation with an initial message by calling createConversationWithMessage. It requires a MessageInput that contains the content of the message that will be sent on behalf of the patient.

This is useful if you want to automatically create a Conversation with some data you want your Providers to be aware of.

See the Core module documentation for details about what a MessageInput can contain.

Conversation creation additional options

Set a title

You can add a title when calling createConversationWithMessage or createConversation.

This title is a string that will be visible to both the Patient and the Providers on the Console so make sure you use it carefully.

📘

Note that this title is editable by Providers from the Console, just like they can add a title to a Conversation that doesn't have one already.

Automatically add Providers to a Conversation

When calling createConversationWithMessage or createConversation you have access to a parameter named providerIds that is a nullable UUID[].

By specifying a list with one or more Providers UUID you can automatically add them to the Conversation when created.

📘

For security reasons, you cannot query existing Provider UUIDs from the patient SDK, this is something only your server can access and that it needs to send to your app.