▪️Inbox

Overview

Inbox is a separate communication channel similar in functionality to Facebook notifications.

From the end-user perspective, it allows users to view and manage all their notifications in one place. It acts as a centralized hub for all notifications, making it easier for users to stay informed about the latest updates and interactions on your platform.

"Inbox communication channel" is enabled for any setup with CRM Automation. This is including the possibility to send "simple" inbox messages, and the end-user is able to see them as part of the Gamification widget.

"Inbox widget" is additional is an additional feature that needs to be enabled on your setup. It provides additional possibilities to:

  • Send notifications with rich content with the support of HTML

  • Displaying notifications in a separate widget independent from the Gamification widget

  • Possibility to get real-time updates about the count of unread messages per user

All setups are limited to 1 million notification messages per month by default.

Please contact your Success Manager for more details.

The Inbox can be accessed from the main Gamification widget or by clicking on the bell/envelope icon that you can place on the front end of your platform. Once you click on the bell icon, the Inbox widget will appear, displaying all the latest notifications.

Users can interact with notifications by adding them to their favorites, expanding a notification if it has additional details, or marking all notifications as read.

Inbox template

From the operator's perspective, every notification can have the following attributes

  • Title - a short subject for the notification

  • Body - a short presentation of the notification

  • Rich body - is an extended presentation of the notification with support of the HTML formatting

  • Icon - for the visual representation of the inbox notification

  • Deep link or URL - to direct the user when he is clicking on the inbox

There are 2 types of notification messages that are behaving in different ways:

  • Simple inbox - has only a title, a short description, and an icon. Clicking on such a message will navigate the user to a specified deep link or to a URL.

  • Inbox message with a rich body - has an additional rich body, clicking on such message will open the Inbox widget with the latest notification in focus and with an expanded rich body. Deep links or URLs for this type of notification should be set inside the HTML of the rich body.

There is a set of additional configurations for the Inbox notifications:

  • For how long the inbox message will stay on the screen when sent to the user, the default value is 7 seconds and can be adjusted for each inbox template

  • For how long inbox message will stay in the notification center of the user, the default value is 30 days and can be adjusted for each inbox template

  • For the "Inbox widget", you can define how it can be closed - either by clicking on the "X" icon inside the inbox widget or, additionally by clicking outside of the widget

Inbox message lifecycle

There are following lifecycle stages of inbox message

  • The message is created as part of the Journey or Scheduled campaign

  • If the user is online, it will be delivered to him, otherwise, it will stay in the delivery pool for the period specified by the operator (20 seconds by default)

  • When a message is delivered to the end user when he is online, it's shown in the presentation of "Simple inbox message" in the bottom right corner of the screen. At this moment the "impression" of the message will be recorded.

  • If the message is defined as "Simple" then clicking on it, will lead the user to the Deep Link or URL defined in the template.

  • If the message has a rich body, then clicking on it will open the Inbox widget with the message in focus.

  • The "read" status of the message will be set when the user clicks on the message, no matter if the message is defined with a rich body or without.

Caps impact

You can have user-level and global-level caps configured for the Inbox messages.

If they are set up and reached, then the "Simple inbox message" will not be shown to the end-user, but the message will be still available in the history of the inbox for a particular user.

Sending inbox messages through the API

You can send messages to the end-users using the Smartico REST API.

General documentation about Smartico REST API you can find in the Back Office in the Label \ Using Rest API section.

To make a call to API you need to specify a private authorization key that can be requested from your Success Manager.

curl --request POST \
--url 'https://apis.smartico.ai/api/external/events/v2' \
--header 'Authorization: your-private-auth-key' \
--header 'Content-Type: application/json'

Note: depending on your setup geographical location, the URL of the API can be different

Example of the JSON body to deliver inbox message

[
    {
        // unique UUID of the request
        "eid": "96b60b08-25f0-4129-b363-ef0d4db780ef",
        // UTC timestamp of the request
        "event_date": 1680106470149,
        // brand_id as it is identified in your system. 
        // if you don't know, please consult with your Success Manager
        "ext_brand_id": "your-external-brand-id",
        "user_ext_id": "id-of-the-user-your-system",
        "event_type": "core_personal_message",
        "payload": {
            "title": "Title of the inbox message",
            "short_message": "Short message",
            "rich_message": "<b>some rich message</b>",
            "icon": "https://mycnd.com/image.png",
            "channel": "inbox-api"
        }
    }
]

Before sending the message you need to create Journey and Inbox templates in the Smartico BackOffice.

You should create Inbox message template as defined in the screenshot below. Pay attention to the names of the tags, they should be exactly as names of the fields sent in the API request. You can also add your own styles and HTML in the rich message that will be used for the all messages you are going to send.

The journey should be triggered by "Core: send personal message" trigger and the "inbox-api" should be set for the "Core: personal message channel", as specified in the screenshot below.

You should set the entry mode to "Every time conditions are met.." and campaign duration to 1 minute.

Create a Journey flow as shown on the screen below. Use the Inbox template created before.

Technical integration

For the technical details related to the integration of the Inbox widget, please refer to the Extended integration article.

Revamped Inbox

We've entirely redesigned our Inbox feature. This update offers a more intuitive and enjoyable experience when navigating messages, staying updated with notifications, and effortlessly managing your communications.

New Improvements:

  • CTA Buttons - we've introduced two new call-to-action (CTA) buttons for messages with rich content, which are also visible within the notifications. They can be configured through the BO, allowing operators to include deep links in both primary and secondary message buttons.

  • All tab and Favorite tab - offer distinct and clear separation between all your messages and those designated as favorites.

  • Show unread toggle - with the new switch, you can effortlessly view all unread messages in both the All and Favorites tabs.

  • Enhanced expand mode for messages - Regardless of rich content, all messages can now be expanded for improved readability and clarity.

  • Back-to-top button - Our latest update includes a back-to-top button for seamless navigation back to the top of the page with a single click after scrolling down.

  • Load more button - for a better user experience we have added the Load more button. After the 20th message, click the 'Load More' button to reveal additional messages.

  • Empty inbox animation - we have added an animation for the cases where you don’t have any messages in the inbox.

  • The stand-alone mode was also revamped

Last updated