The step-by-step guide to messaging mobile customers using your app and SMS

Chase Kim profile picture
Chase Kim
옴니채널 메세징 플랫폼 Product Manager (PM)
  • Tutorial Type: Getting started
  • Reading Time: 20 min
  • Building Time: 30 min
SBM blog CTA mobile 1

옴니채널 비즈니스 메시징으로 당신의 비즈니스를 성장 시키고 비용을 줄이세요

Starting with omnichannel business messaging

This guide explains everything you need to know to start sending SMS, push, KakaoTalk, and in-app notifications with the Sendbird Business Messaging software and API.

You’ll learn how to create your account, set up channels for your outreach/campaign, craft messages, and send messages using the Sendbird notification dashboard or API.

By the end, you’ll have the know-how and the capabilities to send omnichannel messages to customers using your app, push, SMS, and KakaoTalk with Sendbird.

Let’s begin!

3 prerequisites for customer messaging

1. Sendbird account

A Sendbird account is owned by the organization, company, or entity and created through the Sendbird Dashboard.

To create a Sendbird account, just sign up for a 30-day communication platform free trial.

2. Sendbird application

When opening an account with Sendbird, you will first register your organization. Within your organization, you’ll create a Sendbird application with access to the core functionalities—product & features—of the entire Sendbird platform, including Sendbird Business Messaging, Chat, Voice and Video, and AI chatbot.

Each application within a Sendbird account (organization) is siloed, allowing you to manage multiple tenants. For example, one app can be used as a staging environment while another is used for production.

To create a Sendbird application, follow these steps:

  1. Sign in to your Sendbird account. If you do not have an account, sign up for a Sendbird platform free trial.

  2. Create a new application by clicking [Create +] at the bottom right of your screen.

  3. Enter a name for your application, then select a Product Type and a Region. Click [Confirm].

  4. Click the application you just created under Applications. You will see its Application ID, which you will need when initializing the Chat SDK.

Figure 1: A user creates a new Sendbird application
Figure 1: A user creates a new Sendbird application

3. Mobile phone

To test Sendbird Business Messaging, we recommend a mobile phone with iOS or Android (or both) that can access data, receive SMS messages, and has an active KakaoTalk account.

To test in-app messaging, we recommend preparing a mobile application for testing.

Notification channels setup for customer messaging

The following section guides you on how to set up the various notification channels for customer messaging in Sendbird Business Messaging, including in-app notifications, push notifications, KakaoTalk, and SMS notifications.

In-app notifications

In-app messages are centralized within the app, usually through a message center, and can be quickly accessed using a shortcut like a bell icon.

The notification message center allows users to conveniently check and engage with saved notifications. By offering contextual and customizable communication, in-app notifications create a superior business messaging experience for customers that boosts open rates (engagement), CTR (conversion), and satisfaction (retention). You will see later how to implement a notification center into your app.

Figure 2: An example of an in-app message center
Figure 2: An example of an in-app message center

In-app notifications configuration steps

1. In the Sendbird Dashboard, go to Business Messaging > Channels and click the [Create channel+] button at the top-right corner of your screen.

A user sets up the in-app notification channel and template type
Figure 3: A user sets up the in-app notification channel and template type

2. Depending on your client app notification center’s implementation, choose “UI” or “Data type” for the template.

  1. UI: select when implementing using the Sendbird in-app notifications UIKit

  2. Data: select when implementing using the Sendbird in-app notifications SDK

Note: Sendbird’s UIKit is a set of pre-built UI components that allow you to integrate a notification center into your app with one line of code. Sendbird’s SDK allows developers to build a full custom notification center to meet even the strictest brand guidelines. The notification center UIKits and SDKs are available for iOS, Android, JS, and Flutter.

3. Fill in the remaining required fields.

  1. Name: the name of the channel (e.g. message center)

  2. Key: the key of the channel (e.g. message-center)

4. Click [Create].

Mobile push notifications

A mobile push notification is created in the Sendbird Business Messaging dashboard
Figure 4: A mobile push notification is created in the Sendbird Business Messaging dashboard

A mobile push notification is a brief, application-to-person (A2P) automated message sent directly to a user's device from an app or service, even when the app isn't actively in use. It’s displayed in the OS's notification center.

Push notifications are non-permanent messages that convey various information types, such as new messages, updates, alerts, or promotional offers.

To send mobile push notifications with Sendbird Business Messaging, you must first register the push service certificates for iOS, Android, or Harmony. To set up the push notification environment within your client app, please refer to the Sendbird push notification documentation.

Consider these additional push notification resources from Sendbird:

Mobile push notifications prerequisites

  • Firebase Cloud Messaging (FCM) certificate

  • Apple Push Notification Service (APNS) certificate

Mobile push notifications configuration steps

Please follow the instructions detailed in the Sendbird docs to implement push notifications for iOS and Android.

Kakao Alim Talk notifications

To enable Kakao Alim Talk, Sendbird must manually turn on a feature flag. Please send your account executive or manager the Sendbird application ID(s) you want to test or use with Kakao Alim Talk.

KakaoTalk notification prerequisites

  • A KakaoTalk business channel.

  • Business channel ID that can be publicly searched within the KakaoTalk app.

  • Access to the administrator phone number for your KakaoTalk business channel.

KakaoTalk notification configuration steps

Figure 5: A user selects and sets up a KakaoTalk channel
Figure 5: A user selects and sets up a KakaoTalk channel

1. Go to Business Messaging > Channels and click the [Create channel+] button.

2. Select KakaoTalk under Channel type.

3. Complete all required fields.

  1. Kakao Business Channel ID: You can find this ID by going to the Manage > Search ID menu on the KakaoTalk Channel Manager page.

  2. Business Category: The category for the channel.

  3. Business Admin’s Phone: The phone number you registered when signing up for KakaoTalk Channel Manager.

4. Complete the token verification process with an administrator’s phone number.

5. Click [Create].

SMS notifications

To send SMS using South Korean phone numbers, you must register the sender phone numbers with Sendbird in advance. Please send the prerequisite documents below to your Sendbird account executive or manager. Your account executive or manager will provide you with the templates for the following documents.

Note: Once we have received the documents, please give us 5 business days to complete the setup process.

SMS notifications required documents

  • Business registration certificate

  • Proof of telecommunication service use

  • Service usage agreement

  • Document confirming the relationship between the business and a third party

Once Sendbird completes the registration process, you can add the registered phone numbers to your organization by accessing the Phone Number menu in the organization sidebar.

A user adds their organization’s phone number to send SMS
Figure 6: A user adds their organization’s phone number to send SMS

SMS notifications configuration steps

Selecting and setting up an SMS channel and template type
Figure 7: Selecting and setting up an SMS channel and template type

1. Go to Business Messaging > Channels and click the [Create channel+] button.

2. Select SMS under Channel type.

3. Select the registered phone number.

4. Fill in the remaining fields required.

  1. Name: the name of the channel (e.g. SMS - Transactions)

  2. Key: the key of the channel (e.g. sms-transactions)

5. Click [Create].

Campaign/outreach notification templates for customer messaging

Once all channels are added, the next step to use Sendbird Business Messaging is to learn how to create and use campaign/outreach templates. 

Templates are an integral part of Sendbird’s Business Messaging platform and are currently the only way to send customer notifications. They are omnichannel, meaning a single template can contain multiple channels (e.g., in-app, push notifications, SMS, KakaoTalk) and sequencing conditions for optimized delivery.

Sendbird simplifies omnichannel messaging with a unified API and messaging templates

Rather than directly sending a notification to the user with the user’s phone number and push device token, like when using Twilio SMS APIs — Sendbird requires a user to be created in advance

Next, the user’s phone number and push device token should be added to the user profile. Then, sending a notification requires a user ID and a template to target the user on the right channel.

Sendbird omnichannel customer messaging API vs. legacy communication API

Legacy communication APIs like Twilio
Figure 8: Legacy communication APIs like Twilio


Sendbird Business Messaging unified API
Figure 9: Sendbird Business Messaging unified API

🎉The advantage of this abstraction is that we can provide user insights (user-level data), as we have merged everything through the Sendbird user profile.

Additionally, omnichannel templates allow for easy modification of a notification's content, channels, and delivery sequence.

Note: You can create a template with a single channel (e.g. KakaoTalk).

Notification template global variables

Sendbird Business Messaging uses global variables, where a single set of variables within a single template are shared across the multiple channels added to the template. For example, a variable called name can be used seamlessly across in-app, push notifications, SMS, and KakaoTalk.

The variables are provided to the channels when sending a message through the API or the Sendbird dashboard.

Notification template configuration steps

1. Create a campaign/outreach notification template

Go to Business Messaging > Templates and click the [Create template +] button.

Creating a new campaign template
Figure 10: Creating a new campaign template

2. Campaign/outreach notification template information

Enter a notification campaign/outreach template name and key.

Entering a notification template information
Figure 11: Entering a notification template information
  1. Template name: plain text used to denote the template (e.g. transaction alert)

  2. Template key: used when sending notifications through the API or dashboard

3. Template notification channel selection

Select the notification channels to be added.

Choosing a set of channels for a mobile customer messaging campaign
Figure 12: Choosing a set of channels for a mobile customer messaging campaign

Note: you must complete the Channel Setup section before creating a template.

4. Campaign/outreach message creation

Once you select a set of channel types to link to the template, you can edit each channel's message layout and content using the message builder/editor.

  1. In-app notification message creation

    1. UIKit/UI template type: You can customize each template element, such as padding, font size, color, alignment, etc. The global theme will control some aspects of the template design.

      Customizing the in-app notification of a messaging campaign
      Figure 13: Customizing the in-app notification of a messaging campaign

    2. SDK/data template type: When using the in-app message center SDK, the message editor allows you to customize the title, body, variables, etc. When using the in-app message center SDK, the UI/UX is up to you to develop.

      Customizing data for an in-app notification in the Sendbird Business Messaging dashboard when using the in-app message center SDK
      Figure 14: Customizing data for an in-app notification in the Sendbird Business Messaging dashboard when using the in-app message center SDK

  2. Push notification message creation
    1. Title: the title of the push notification
    2. Body: the body of the push notification
    3. Data: custom data sent for uses such as deep links (path), transaction_id, event_id, etc.)

      Customizing a push notification for a messaging campaign/outreach in the Sendbird Business Messaging dashboard
      Figure 15: Customizing a push notification for a messaging campaign/outreach in the Sendbird Business Messaging dashboard
  1. KakaoTalk message creation
  • Creating a KakaoTalk notification for messaging campaign/outreach in the Sendbird Business Messaging dashboard
    Figure 16: Creating a KakaoTalk notification for messaging campaign/outreach in the Sendbird Business Messaging dashboard
  • A KakaoTalk template requires approval from Kakao before use. When a template is saved, we will automatically send a request to Kakao for approval. All KakaoTalk templates are up-to-date and aligned with Kakao's offerings. Here’s a guide for Kakao templates.
  1. SMS (Korea) message creation
  • Customizing SMS notification for a customer messaging campaign/outreach in the Sendbird business messaging dashboard
    Figure 17: Customizing SMS notification for a customer messaging campaign/outreach in the Sendbird business messaging dashboard
  • Sendbird Business Messaging supports SMS (body) and LMS (title + body) for Korea specifically for informational notifications. Please contact your Sendbird account manager or executive if you require promotional messages.

5. Creating a mobile notification channel delivery sequence

Once the channels and content are set, the next step is configuring a sequence.

Creating a notification delivery sequence in the Sendbird dashboard
Figure 18: Creating a notification delivery sequence in the Sendbird dashboard
  1. What is a mobile notification channel sequence?

    A mobile notification channel sequence is a predefined order in which notifications are delivered across multiple channels. The steps have conditions and time delays, which a user can configure on the fly without any engineering resources.

    1. Recommended usage: Send to the most economical channels (in-app + push) together as Step 1, KakaoTalk as Step 2, and SMS as Step 3. Depending on the urgency, the condition can be changed, but we recommend starting with in-app and push notifications for insights (viewed and clicks) and cost efficiency.

    2. Note: For SDK implementation - please ensure your SDK implementation is correct for in-app view/click conditions to work correctly.

  2. Mobile notification metrics and observability by channel:
    Mobile notification metrics and observability by channel
    1. In-app notifications:
      1. Delivered: when an in-app message is sent to the user
      2. Viewed: when a user views an in-app message
        1. SDK: implement view logic through the provided method
        2. UIKit: automatically tracked when a message is rendered 0.5 seconds on the screen
      3. Clicked: when a user clicks on a button within an in-app message
        1. SDK: implement click logic through the provided method

        2. UIKit: automatically tracked when a user clicks on a button

    2. Mobile push notifications:
      1. Delivered: when a push notification has been delivered to the user

      2. Clicked: when a user clicks the push notification and opens the app

    3. KakaoTalk notifications:
      1. Delivered: when a Kakao AlimTalk is sent to the user
      2. Clicked: coming soon
    4. SMS notifications:
      1. Delivered: when a user’s device receives a SMS

      2. Clicked: coming soon

6. Configure permissions and in-app notifications specific settings (optional)

  1. Permissions: roles that can edit the template

  2. In-app notification channel settings:
    1. In-app notification categories are used so that an end user may utilize it to filter the list of notifications rendered. This is optional and can be configured per channel. By default, Sendbird Business Messaging creates updates, promotions, and announcements but these can be configured by accessing Business Messaging > Channels > In-app channel > Category filters.

    2. In-app notification labels are used to send metadata that labels each notification. When using the UIKit, the label is automatically rendered in the upper left corner of the notification. In an SDK implementation, feel free to use the label for whatever purpose is necessary. 

    3. In-app notification message retention configures the expiration settings for each in-app message. For example, if this is set to 3 days, and a notification is sent using this template, it will expire and be deleted from the user’s in-app message center after 3 days.

7. Click [Create]

Implementing your in-app message/notification center

Implementing an in-app notification center requires deciding between the Sendbird in-app notification SDK or the Sendbird in-app notification UIKit.

Sendbird in-app notification UIKit

Using the Sendbird in-app notification UIKit accelerates speed to market and lessens maintenance, as Sendbird is responsible for storing and rendering the in-app message center.

The UIKit allows complete customization of the message and the message center through features within the Sendbird dashboard. 

Note: To utilize the Sendbird in-app notification UIKit, please select a notification UI template type when creating an in-app channel (refer to step 2 of Channel Setup).

User configuring the in-app notification UIKit theme in the Sendbird dashboard
Figure 19: User configuring the in-app notification UIKit theme in the Sendbird dashboard

Installation

  • iOS

  • Android

  • JavaScript (not supported)

  • Flutter (not supported)

Sendbird in-app notification SDK

The Sendbird in-app notification SDK offers full customizability without storing the message data on the Sendbird platform. The in-app notification SDK also allows you to pass data using templates and metrics such as in-app views and clicks, sequencing, and analytic features. The tradeoff is time to market. 

Note: To utilize the Sendbird in-app notification SDK, please select the Data template type when creating an in-app notification channel (refer to step 4 of Channel Setup).

In-app notification SDK installation instructions by platform

Sending customer notifications via the Sendbird Business Messaging API

Sendbird Business Messaging API use case

The Sendbird Business Messaging API sends messages from external systems, such as your payment, shipping, or logistics tech stack.

Everyday use cases include payment/transaction alerts, account updates, and user event-based marketing messages.

Through the Sendbird business messaging API, you can send mobile notifications in real-time to a single user, or in batches to a large number of users.

  • Single user: This type of notification targets a single user for immediate delivery. It is ideal for event-based notifications like appointment reminders or transaction confirmations.

  • Batch: Designed to send notifications to multiple users, with two methods to send:
    • Array: Supports up to 10,000 users directly in a JSON array.

    • CSV: For more than 10,000 users, up to 100,000, use a CSV file.

Sendbird Business Messaging API Implementation

To send notifications, you need to use the Sendbird Platform API. Ensure you have your base URL and API token, which are accessible through your account or API settings here.

To send a notification via the Platform API, make a POST request to the following endpoint:

Unset

POST {base_url}/v2/notifications

To authenticate this request, you’ll need to pass in the following header:

Unset

'Api-Token': '8ww199t0opk2wq1f7uwiqslwip5dhhd5rj3pmkoy' // example token

Required parameters

Name

Type

Description

template

json

Specifies the template used to send the notification.

template.key

string

Specifies the key of the template used to send the notification.

template.variables

json

Specifies the customizable variables in a template.

targets

array of strings

Array of Sendbird user IDs

mode

string

Specifies which mode is used to send the notification, depending on the number of recipients.

- realtime: There's only one recipient and the notification is sent directly to the target user in real-time.

- batch (currently not supported): There are multiple recipients of the notification and messages will be sent in a series of batches.

title

string

Specifies the title used to send the notification. This field can be used as a label to organize and manage individual notifications.


Optional parameters

Name

Type

Description

template.push_notification_data

json

Specifies the custom data (key/value) within a push notification template (max 5 pairs).

priority

string

Specifies the delivery priority level of a batch notification. Acceptable values are high, normal, and low. (Default: normal)

* This is effective only when mode is set to batch.

tag

string

Specifies a key that groups notifications together. This key is used in the Analytics page on Sendbird Dashboard to sort and categorize notifications.


Real-time


Batch mode

Sending mobile customer notifications via the Sendbird dashboard

Sendbird mobile customer notifications use cases

Sending mobile notifications through the Sendbird dashboard can be helpful when operators want to send direct or bulk messages to a group of users for cases such as announcements, marketing promotions, or any updates to a group of users.

Sendbird mobile customer notifications prerequisites

  • User list: If you need a more significant number of users, please contact your Sendbird account manager or executive.
    • CSV file: the default limit is 100,000 users in a single batch.

    • Input individual users: up to 10,000 users.

  • Template: Sending notifications requires a template to be created and available (it must have passed KakaoTalk template approval if Kakao is included).

Sendbird mobile customer notifications steps

Refer to this link for detailed steps on using the dashboard to send omnichannel mobile notifications.

Managing phone numbers for SMS messaging

To send notifications through SMS or KakaoTalk, you must register users' phone numbers on Sendbird. Only a single phone number is accepted per Sendbird user and will be used for SMS and KakaoTalk.

Note: Existing users can be updated in bulk via the Sendbird dashboard under Business Messaging > User insights > Import users.

Adding phone numbers through API

For new users, incorporate the phone number during user creation with the following API call:

HTTP request

POST https://api-{application_id}.sendbird.com/v3/users


Required parameters

Name

Type

Description

user_id

string

Specifies a user's unique ID. Maximum length is 80 characters.

* Do not use PII (Personally Identifiable Information) such as user email address, legal name, or phone number as it could jeopardize data security and privacy.

nickname

string

Specifies the user's nickname. Maximum length is 80 characters.

profile_url

string

Specifies the URL of the user's profile image. If left empty, no profile image is set for the user. The maximum length is 2,048 characters. If the profile_url property is specified, the profile_file property is not required.

profile_file

string

Specifies the file of the user's profile image. An acceptable image is limited to a JPG, JPEG, or PNG file of up to 5 MB. When passing a file, you should send a multipart request. If the profile_file property is specified, the profile_url property is not required.


Optional parameters

Name

Type

Description

phone_number

string

Specifies the user’s phone number. Example: +82010XXXXXXXX

Updating phone numbers through API

Update a Sendbird user profile when a user changes their phone number using the following API call:


HTTP request

PUT https://api-{application_id}.sendbird.com/v3/users/{user_id}


Optional parameters

Name

Type

Description

phone_number

string

Specifies the user’s phone number.

FAQ for Sendbird Business Messaging

What is Sendbird Business Messaging?

Sendbird Business Messaging is a comprehensive platform that enables businesses to communicate with customers through notification channels, including SMS, in-app messaging, push notifications, and messengers like WhatsApp and KakaoTalk. It provides omnichannel templates alongside a unified API for efficiently managing and delivering messages across these channels.

What are the key features of Sendbird Business Messaging?

The key features of Sendbird Business Messaging platform include:

  • Notifications API: Simplifies messaging across channels with a single interface.

  • Omnichannel templates: Customizable for different channels.

  • Real-time & batch messaging: Supports immediate and scheduled messages.

  • Analytics: Tracks user, campaign, channel level delivery, views, and engagement.

What channels does Sendbird Business Messaging support?

Sendbird is currently in-app for push notifications, SMS, and messengers (WhatsApp/KakaoTalk). We plan to support email and other notification channels for business messaging in the future.

How does the unified API in Sendbird Business Messaging work?

Our single, unified API simplifies managing all channels — like SMS and push notifications — through one interface. It abstracts away channel and sequence details so you can focus only on the target user, content, and personalization, reducing complexity and ensuring consistent messaging.

Can I send a message to multiple different channels using Sendbird Business Messaging?

Yes, Sendbird Business Messaging allows you to customize messages for different channels by using our omnichannel messaging templates. You can tailor the content, layout, channel, and sequence options to suit each message’s needs.

How does Sendbird Business Messaging track user engagement and analytics?

The solution provides methods to track message delivery, viewed (only supported on in-app and push), and clicks across different channels. This data can track engagement on three levels: user, campaigns, and channels to optimize messaging strategies and improve customer engagement.

What are omnichannel templates in Sendbird Business Messaging?

Omnichannel templates in Sendbird Business Messaging are the foundation for a single notification use case. A template can encompass content and layout for multiple channels and determine which channels the message is sent to. These templates simplify the creation and management of messages by allowing you to design a message once and deploy it across all channels.

Why should I choose Sendbird Business Messaging over other messaging solutions?

Unlike other messaging solutions, Sendbird Business Messaging prioritizes communication on the highest-performing channel — typically the mobile app — while enabling fallbacks to external channels like SMS, email, and messaging platforms, ensuring a seamless and effective communication strategy.

How does Sendbird Business Messaging ensure messages are delivered on the most effective channel?

Sendbird Business Messaging's templates feature user-configurable sequences that optimize costs and enhance the user experience of business messaging. Conditions like "is viewed" or "is clicked" guide the message flow, while "is delivered" ensures successful delivery. If an in-app message fails, the system can automatically fallback to SMS to guarantee delivery.

How can I personalize messages sent through Sendbird Business Messaging?

Personalization in Sendbird Business Messaging is achieved through variables within omnichannel templates. These variables can be customized for each user, allowing for personalized content such as names, transaction details, or tailored offers, creating a more engaging experience for the recipient.

Can Sendbird Business Messaging integrate with my existing systems?

Sendbird Business Messaging can be integrated with your existing systems through its unified API. This integration allows you to connect your current customer management, marketing, and operational systems seamlessly with Sendbird’s messaging capabilities, enhancing your business messaging and overall communication strategy.

Welcome to Sendbird Business Messaging: your gateway to enhanced customer engagement, retention, and conversion!

Congratulations! 🎉Your teams are now equipped to reach any mobile audience across in-app messaging, mobile push, SMS, and Kakaotalk, using the Sendbird Business Messaging software and API. This includes a mobile notification software to streamline operations for any team, and a unified notification API for developers to seamlessly integrate omnichannel messaging into any tech stack.

Using this guide, you’ve laid the foundation for customer omnichannel communication. You’ve taken a crucial step toward connecting with mobile customers more effectively, and boosting engagement with media-rich, branded, and secure in-app notifications.

By sequencing in-app and push notifications first, and keeping costly external channels as fallback, you’ll reduce message volume and lower costs while improving customer satisfaction.

Onward to effectively reaching your customers!

If you have any questions or need support, please contact our friendly team of omnichannel notification experts