Messages_
Learn about Appwrite messages, the different types of messages, what can be sent in different message types.
7 min read
Each time you send or schedule a push notification, email, or SMS text, it's recorded in Appwrite as a message is displayed in the Messages tab.
Messages
Each message displays with the following information.
| Column | Description |
|---|---|
| Message ID | The unique ID of the message. |
| Description | The developer defined description of the message. End users do not see this description. |
| Message | The message delivered to end users. |
| Type | Type of message, either Push, Email, and SMS. |
| Status | Indicates the status of the message, can be one of draft, scheduled, processing, failed, success. |
| Scheduled at | Indicates the scheduled delivery time of the message. |
| Delivered at | Indicates the time at which the message was successfully delivered. |
Messages types
There are three types of messages
| Message type | Description |
|---|---|
| Push notifications | Push notifications are alerts that show up on a user device's notification center. This can be used to deliver messages to the user whether their application is open or not. |
| Emails | Emails let you deliver rich content to a users' inbox. Appwrite allows you to send customized HTML email messages so you can include links, styling, and more. |
| SMS | SMS messages let you deliver text messages to your user's phone. This helps you reach your user, even when their device do not have internet access. |
Messages lifecycle
Messages can begin as a draft, or proceed directly to processing if it's sent immediately. If the message is scheduled to be sent later, its status is set to scheduled, then to processing at schedule time. After attempted delivery, it is marked as sent or failed depending on if the message was successfully delivered.
Choosing a message type
Choosing the right type of notification to reach your audience is important for your app's success. Here are some common factors to consider when deciding what type of message should be sent.
| Message type | Description |
|---|---|
| Time-sensitive messages | Push notifications or SMS messages are ideal for time-sensitive messages, as they are typically checked frequently and opened within minutes, ensuring prompt attention. |
| Guaranteed delivery | Emails and SMS messages are more reliable for guaranteed delivery of important messages like invoices and order confirmations, as push notifications can be easily missed. |
| Content-rich messages | Emails are best suited for delivering content-rich messages like promotional letters, detailed updates, and newsletters, thanks to support for HTML, allowing for rich text, links, and styling. |
| Increasing engagement | Push notifications are effective for increasing engagement with users, as they can be clicked on to link directly to your app, promoting immediate interaction. |
| Accessibility and reach | Emails and SMS messages allow you to reach users even before they have installed your app, making them suitable for announcement-type messages that require broad accessibility. |
Composing messages
Different types of messages have different content and configurable options. Here are the different components that make up a message.
Sending a message
You can create a message with a Server SDK. You can send a push notification like this.
You can send an email like this.
You can send an SMS message like this.
Was this page helpful?
Share what worked or what we should fix. Once approved, our agents automatically apply suggested updates to the docs.