Smartico Help Center
Admin loginSmartico.aiTheAffiliatePlatform.com
  • Welcome
  • Products
    • 🔆CRM Automation
      • ◾Create Journey Flow
      • ◾Event Driven Journey
      • ◾Automation Rules
      • ◾Campaigns vs Automation Rules
      • ◾Segmentation
        • ▪️User State Segments
        • ▪️Behavioral Segments
        • ▪️Imported Segments
      • ◾Activities of Flows
        • ▪️Activity: Email
        • ▪️Activity: SMS, Viber and WhatsApp
        • ▪️Activity: Telegram Bot
        • ▪️Activity: Custom IM
        • ▪️Activity: WebHook
        • ▪️Activity: Limit
        • ▪️Activity: Add Points
      • ◾Communication channels
        • ▪️Email
        • ▪️Liquid Email
        • ▪️SMS, Telegram, Viber, and WhatsApp
        • ▪️Popups
        • ▪️Inbox
        • ▪️Push notifications
        • ▪️Content Variations
        • ▪️Opt-out & Communication Statuses
        • ▪️Gamification activities in the communications
      • ◾A/B Testing
    • 🎮Gamification Blocks
      • Setup steps and checklist
      • Points
      • Gems & Diamonds
      • Levels
        • Level Map
        • Levels Tips & Hints
      • Missions
        • Mission Types & Statuses
        • How to set up a Mission
      • Tournaments
        • Tournament Setup
      • Badges
      • Store
      • Example setup
      • Gamification UI skinning
      • Terms to protect
    • 🧠AI Models
      • ◾AI Enhancer
      • ◾Best Time Model
      • ◾Churn & LTV prediction
      • ◾Favorite product
      • ◾RFM Analysis
      • ◾Sport Recommendations
    • 🎲Mini Games
      • ◾Introduction to Mini Games
      • ◾Game template setup
      • ◾Custom skins for Mini-games
      • ◾Mini-games on the landing pages
      • ◾Using images instead of prize names in Spin the Wheel
      • 🏴‍☠️Treasure Hunt
      • ⚽MatchX Game
        • Creating Rounds
        • Resolution of a Round
        • Leaderboard
        • Game Statuses
        • FAQ: MatchX game
        • Loading MatchX & Quiz games on website
      • ❓Quiz Game
      • 🪂Prize Drop
    • 🗺️Lootbox 2.0
    • 🎁Missions Lootbox
    • 🏆Jackpots
    • 🎟️Raffles
    • 💡General concepts
      • ◾Bonuses
      • ◾Dynamic Rewards
      • ◾Custom Sections
      • ◾Attribution value
      • ◾Label tags
      • ◾Multi-currency usage report
      • ◾Multi-brands support
      • ◾Override translations on Label/Brand Level
      • ◾User markers (tags)
      • ◾Deep-links
      • ◾User roles in Back Office
      • ◾Email Gateways Guide
      • ◾"Client action" event
      • ◾Custom fields/attributes
    • 💻UI Widgets
    • ❔FAQs
      • FAQ: Gamification
      • FAQ: Data Studio & Reports
      • FAQ: CRM Automation
      • FAQ: Front-end integration
      • FAQ: Other topics
      • FAQ: Bonuses
  • Use cases
    • 🔆CRM Automation
      • ◾Cross-sell. Match users on different brands
      • ◾Mini-games usage in marketing campaigns
      • ◾Optimize Communication by excluding disengaged players
      • ◾Automated Sports Campaigns
  • Technical guides
    • ◾Integration process
    • ◾Front-end integration
      • ▪️Extended integration
      • ▪️Push configurations
      • ▪️Acquisition mode
    • ◾Data integration
    • ◾Bonus API integration
    • ◾Secured Messaging Gateways (Email/SMS/IM)
    • ◾Reverse integration
    • ◾Smartico Data Warеhouse
      • ◾Smartico DWH \ Affiliation views
      • ◾Smartico DWH \ CRM views
      • ◾Smartico DWH \ Gamification views
    • ◾Games catalog API
    • ◾Custom push gateways
    • Branded Links
  • More
    • 📝Release notes
      • 🌷May 2025
      • 🌷April 2025
      • 🌷March 2025
      • ❄️February 2025
      • ❄️January 2025
      • ⛄December 2024
      • 🍁November 2024
      • 🍁October 2024
      • 🍁September 2024
      • 🌞August 2024
      • 🌞July 2024
      • 🌞June 2024
      • 🌷May 2024
      • 🌷April 2024
      • 🌷March 2024
      • ❄️February 2024
      • ❄️January 2024
      • ⛄December 2023
      • 🍁November 2023
      • 🍁October 2023
      • 🍁September 2023
      • 🌞August 2023
      • 🌞July 2023
      • 🌞June 2023
      • 🌷May 2023
      • 🌷April 2023
      • 🌷March 2023
      • ❄️February 2023
      • ❄️January 2023
      • ⛄December 2022
      • 🍁November 2022
      • 🍁October 2022
      • 🍁September 2022
      • 🌞June 2022
      • ❄️January 2022
      • 🍁October 2021
      • 🌞July 2021
      • 🌷April 2021
      • ❄️February 2021
    • ⚙️Support Scope
    • 👍Request Demo
Powered by GitBook

More

  • expo.smartico.ai
  • ice.smartico.ai
  • play.smartico.ai

@ 2025 Smartico.ai

On this page
  • Overview
  • Inbox template
  • Inbox message lifecycle
  • Sending inbox messages through the API
  • Technical integration
  • Revamped Inbox
  • Add sound for incoming inbox messages

Was this helpful?

  1. Products
  2. CRM Automation
  3. Communication channels

Inbox

Last updated 3 months ago

Was this helpful?

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

  • Open Links - choose whether links within the message will open in a new window or the current one

  • Enable "zoom" mode for images - zoom in on images by clicking on them within the message

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

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

Add sound for incoming inbox messages

You can enable a sound alert when players receive an inbox message. The setting, 'Enable sound for receiving inbox,' is located in the inbox template within the BO. By default, this option is turned off, meaning no sound will play when a message arrives. When enabled, players will hear a default notification sound, and you can also upload a custom sound of your choice.

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

🔆
◾
▪️
Extended integration
Example of inbox notifications in BO
BackOffice interface to manage Inbox resource
Setting the trigger for the Journey
Journey setup
Journey flow
Example of message with rich body
Example of simple inbox message
Example of standalone inbox