Advanced topics

Advanced topics and features of the messaging module

This page describes advanced usage of our Messaging Core 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 startConversation.

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 startConversation you have access to a parameter named providerIds that is a nullable string[].

By specifying an array with one or more properly formatted 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.