Business Messaging Guide v2
Business Messaging
Version 2

User information

Copy link

To enable KakaoTalk Alim Talk messaging, you must register users' phone numbers in their Sendbird user profiles first.

Note: Existing users can be updated in bulk via the Sendbird Dashboard under Business Messaging > User insights > Import users. Refer to our guide on importing user data.


Add a phone number to an existing user

Copy link

Add a phone number to an existing Sendbird user profile using the following API call.

HTTP request

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

Request body

Copy link
Properties
RequiredTypeDescription

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.

phone_number

string

Specifies the user’s phone number with the country code. An example would be: +82010XXXXXXXX.

OptionalTypeDescription

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. 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.

{
  "user_id": "user_id",
  "phone_number": "phone_number"
}

Update user information

Copy link

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

HTTP request

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

Parameters

Copy link

The following table lists the parameters that this action supports.

Required
ParameterTypeDescription

user_id

string

Specifies the user ID to update the phone number.

Request body

Copy link

The following tables list the properties of an HTTP request that this action supports.

Required
PropertyTypeDescription

phone_number

string

Specifies the user’s phone number with the country code. An example would be: +82010XXXXXXXX.

{
  "phone_number": "phone_number"
}