# Messages to users (Notifications)

{% hint style="info" %} <mark style="color:blue;">Path: SBO > Content > Notifications</mark>
{% endhint %}

* [Definition](#id-1.16.x-messagestousers-definition)
* [Create messages to users](#id-1.16.x-messagestousers-createmessagestousers)
* [Read the “messages to users” interface](#id-1.16.x-messagestousers-readthe-messagestousers-interface)
* [Update messages to users](#id-1.16.x-messagestousers-updatemessagestousers)
* [Customizing Messages](#customizing-messages)
* [Message tracking](#message-tracking)
* [Delete messages to users](#id-1.16.x-messagestousers-deletemessagestousers)
* [Related resources](#id-1.16.x-messagestousers-relatedresources)

## Definition <a href="#id-1.16.x-messagestousers-definition" id="id-1.16.x-messagestousers-definition"></a>

Messages to users are messages (SMS or Email) sent automatically to users by the platform.

It can concern:

* An action made by users
* A booking status update
* Payment status update

The SBO allows the management of these messages.

<mark style="color:red;background-color:yellow;">WHO CAN USE THIS FEATURE?</mark>

Logged super-administrators and administrators

## Create messages to users <a href="#id-1.16.x-messagestousers-createmessagestousers" id="id-1.16.x-messagestousers-createmessagestousers"></a>

Create a message to be automatically sent to users. They can be customized depending on the platform (it may need custom development)

***

## Read the “messages to users” interface <a href="#id-1.16.x-messagestousers-readthe-messagestousers-interface" id="id-1.16.x-messagestousers-readthe-messagestousers-interface"></a>

Use the search bar (figure 1) to find the messages. When searching for a message to manage, the super-administrator can write the words related to it in the search bar.

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/6Nfq6XQe7rkpczTzy76R/image.png" alt=""><figcaption><p>Figure 1</p></figcaption></figure>

The “*Clear Cache*” button at the top of the page will help to display the modification. Indeed a cache is a piece of information saved by a web browser or a server to load pages faster. When clearing the cache of the web browser, it deletes all the information saved on the cache and displays the information saved in the new cache.

For each message block (figure 2), it shows:

* The trigger. It is the event that sends the message to the target.&#x20;
* The target. It is the recipient of the message&#x20;
* The message type (Mail / SMS)
* The overview of the message

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/iQIqfI0Bw2wWZY1NYHn0/image.png" alt=""><figcaption><p>FIgure 2</p></figcaption></figure>

The folder icon displays the details of the message.

**How can you read the message?**

To customize each message automatically sent, we use placeholders.

A placeholder is a dynamic value stored in the database and changes according to the context and the person. It is easily recognizable with the “%” symbol at the end and beginning of it. This is a mandatory syntax for each placeholder.&#x20;

In our case, you can find placeholders used in labels (figure 3)

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/LqcuToiYTtaK99kind2C/image.png" alt=""><figcaption><p>Figure 3</p></figcaption></figure>

For example, each user on a platform has a different first name, the placeholder records it so the automatic personal message becomes customized.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><p><strong>The SBO message</strong></p><p></p><p>Hi <em>%firstname%</em>,</p><p>A new transfer <em>( %payout_id%)</em> is available to <em>%offerer_name%</em> for the <em>%quote_id%</em> quote.</p><p>Here is the link to make the transfer to the provider: <em>&#x3C;a href="%url%">%url%&#x3C;/a></em></p></td><td></td><td></td></tr><tr><td><p><strong>The received message</strong></p><p></p><p>Hi <em>Lola</em>,</p><p>A new transfer <em>9749087</em> is available to <em>Damien</em> for the <em>#67542</em> quote.</p><p>Here is the link to make the transfer to the provider: <em>lemonpay account</em></p></td><td></td><td></td></tr></tbody></table>

## Update messages to users <a href="#id-1.16.x-messagestousers-updatemessagestousers" id="id-1.16.x-messagestousers-updatemessagestousers"></a>

The subject and content of the message can be modified by clicking the “folder” icon from the message page edit.

The “*Subjec*t” (figure 4) is the subject of the email to be sent. It can be modified in the text area.

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/H5LUI411Juuo3000aKwh/image.png" alt=""><figcaption><p>Figure 4</p></figcaption></figure>

The “*Content*” (figure 5) is the detail/explanation of the message. It can be modified in the text area.

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/pAmsnof0lNTLLOX9rn2N/image.png" alt=""><figcaption><p>Figure 5</p></figcaption></figure>

The Meta title part (figure 6) suggests the only placeholders that can be used in the message.

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/yHp6V6oSILexF3nxaZNo/image.png" alt=""><figcaption><p>Figure 6</p></figcaption></figure>

The side card (figure 7), displays information about :

* What event triggers the message
* Who will receive the message
* The message type

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/1IbJ9eyfncUTEHCh74SQ/image.png" alt=""><figcaption><p>Figure 7</p></figcaption></figure>

Click “Save” to conclude the modifications of the messages (figure 8 ).

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/E4ABIteWODRJHWbwokuk/image.png" alt=""><figcaption><p>FIgure 8</p></figcaption></figure>

## Customizing Messages

To update the logo, navigate to 'Other > Configurations > **cocorico\_shop.logo**' and make the desired changes. Additionally, customize the email footer by modifying the following configurations:

* **all\_the\_best.email.footer**
* **the\_sitename\_team.email.footer**

More complex customization is possible through custom development in the file **src/Cocorico/ShopBundle/Resources/views/Mails/layout.html.twig**.

## Message tracking

All the messages sent out of the platform are available in the table below.

**Agent:** The entity who sent the message.

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/3eKBrS1DBi0PX7ixgD2k/image.png" alt=""><figcaption><p>Agents</p></figcaption></figure>

**Target:** To whom the message is sent.

**Action Trigger:** Action that triggered the message to be sent.

**Bundle**: Rendering type where the notifications are enabled.

* **All:** All the rendering types
* **All- RFC/RFP:** All the rendering types but RFC and RFP
* **All-RFC:** All rendering types but RFP

**Notification method:** The messages can be sent by e-mail or SMS.

**Subject:** The message subject.

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/3ftjrXoQUDXIgD9bjh30/Notifications---Second---Google-Sheets-pages-deleted.jpg" alt=""><figcaption></figcaption></figure>

## Delete messages to users <a href="#id-1.16.x-messagestousers-deletemessagestousers" id="id-1.16.x-messagestousers-deletemessagestousers"></a>

Messages to users cannot be deleted.

## Related resources <a href="#id-1.16.x-messagestousers-relatedresources" id="id-1.16.x-messagestousers-relatedresources"></a>

*No related resources*
