# Create Kakao Brand Message (Free Form)

Kakao Brand Message (Flexible Type) is a service that lets you send various types of marketing messages — text, images, buttons, and more — to customers who have added your KakaoTalk Channel as a friend. Reach customers effectively through KakaoTalk, a channel they are familiar with, and drive high engagement and conversions with personalized messages.

{% hint style="warning" %}
KakaoTalk Channel Integration and credit top-up are required before sending Kakao Messages.

* If you have not yet completed the integration, please refer to the [KakaoTalk Channel Integration Guide](/en/external-link/crm-channels/kakaotalk-integration.md).
* To top up your credits, please contact the Hackle team at <support@hackle.io>.
  {% endhint %}

{% stepper %}
{% step %}
**Create Campaign**

Once you have completed the KakaoTalk Channel integration, click the **`+ Create Campaign`** button in the upper right of **`Kakao Message`** to create a new Kakao Message campaign.

![](/files/Z6Xh2EG5RW8EMdnYG1AB)

* **Name**: Required field. Enter the name of the campaign you want to run.
* **Description**: Optional field. If there is a description, it helps other team members understand what campaign is being run.

![](/files/sCucmOVj19QB7jgMrWEP)

When the campaign is created, you can view the campaign key, title, description, and status.

* Campaign Key: A unique value that identifies the campaign. It can be used to extract users exposed to a specific campaign.
* Campaign Title / Description: You can edit the title and description.
* Campaign Status: When you first create a campaign, it is in 'Draft' status. After composing and saving the campaign details, you can start the campaign. Click the \[Edit] button at the top to modify campaign content.
  {% endstep %}

{% step %}
**Compose Message**

![](/files/NdDfJ8Tp9ypc1KHQuPYI)

**Message Information**

**Message Type**

![](/files/TyLMilxMLjBHa2Lo25LX)

Check the items below based on the nature of the message you want to send.

* **Promotional Message**
  * When a promotional message is checked, "(Ad)" is displayed at the beginning of the message, and the opt-out method (Home > Block Channel) is also shown.
* **Age Verification Message**
  * For content unsuitable for users under 20, you must select 'Age Verification Message'. Failure to apply the age verification feature may result in service restrictions under operating policy.
  * This message is displayed in a hidden state in the chat room until the recipient completes age verification. Only adults aged 20 or older based on their KakaoTalk account identity verification can view the content.

When sending messages through a channel, you must comply with applicable laws, including the Act on Promotion of Information and Communications Network Utilization and Information Protection. For specific details, check the message send precautions in the <[KakaoTalk Channel Operating Policy](https://center-pf.kakao.com/policy)>.

**Message Content**

Hackle supports all layouts. [View message layouts in detail](https://kakaobusiness.gitbook.io/main/ad/brandmessage#id-4-1)

![Source: Kakao Business Guide](https://kakaobusiness.gitbook.io/main/~gitbook/image?url=https%3A%2F%2F234308570-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MVZVmVOd-5LtENUPqdq%252Fuploads%252FlHbzSvsBSeXTWwaLM8QN%252F%25EC%25B9%259C%25EA%25B5%25AC%25ED%2586%25A1_%25EB%25A9%2594%25EC%258B%259C%25EC%25A7%2580%25ED%2583%2580%25EC%259E%2585_%25EC%25A0%2584%25EC%25B2%25B4%25EC%259D%25B4%25EB%25AF%25B8%25EC%25A7%2580.png%3Falt%3Dmedia%26token%3D2b0b6274-b154-4dee-9014-283213a01586\&width=768\&dpr=2\&quality=100\&sign=ccd1405a\&sv=2)

| Layout            | Description                                                                            |
| ----------------- | -------------------------------------------------------------------------------------- |
| Text              | • Text: up to 400 characters • Buttons: up to 5                                        |
| Image             | • Image (optional) • Text: up to 400 characters • Buttons: up to 5                     |
| Wide Image        | • Image (required) • Text: up to 76 characters • Buttons: 1                            |
| Wide Item List    | • Image (required) • List: up to 4 items • Title separate                              |
| Commerce          | • Image (required) • Product name/supplementary info separate • Price info highlighted |
| Carousel Feed     | • 2–10 cards • Title/body separate • Text up to 180 characters                         |
| Carousel Commerce | • 2–10 cards • Intro area separate • Price info highlighted                            |
| Premium Video     | • 2–10 cards • Text up to 1000 characters • Buttons: 1                                 |

![](/files/HpllIviQaJZ5lDSJl4dq)

**Image**

* File format: PNG, JPG, JPEG
* File size: up to 5MB

| Layout     | Recommended Size                                        |
| ---------- | ------------------------------------------------------- |
| Image      | Recommended ratio 1:1, recommended size: 1000 x 1000 px |
| Wide Image | Recommended size: 800 x 600px                           |

**Text**

Character count includes spaces.

* Image: up to 400 characters
* Wide Image: up to 76 characters

**Personalized Message**

A personalized message is delivered in a customized way tailored to the user's name, behavior, interests, and more. This increases user engagement and conversion rates, reduces unnecessary messages to improve user satisfaction, and is an effective communication strategy that contributes to improved retention and revenue growth.

Click the {...} button on the right side of the text box when entering text or links to compose a personalized message.

![{...} button location reference](/files/0qJyeKuC4Bgp7EkXKVE6)

In the popup, you can select **event properties** and **user properties**. For each property, you can also configure what to display as a **fallback value** if no value exists. For example, selecting the property value `firstName` will display the member's name "(Gil)dong", and if no name exists, the fallback text "Customer" will appear.

**Buttons**

Buttons are a key element for driving user actions within a message. You can configure buttons for various purposes — website visits, coupon downloads, event participation, and more — to effectively drive conversions by improving click-through rates.

Button labels can be up to 8 characters. Depending on the message layout, up to 5 buttons can be added, and each button can have a URL configured to set an action.

* Default Link: Navigates to the link in mobile/PC KakaoTalk.
* PC-only Link (optional): Navigates to a separate PC link in PC KakaoTalk.

**Coupon**

You can add a button at the bottom of the message balloon that highlights coupon benefits. Clicking the button navigates to the attached coupon, and you can write the title and description according to the benefit type.

* Benefit Type: Discount amount, Discount rate, Free shipping, Free gift, Upgrade
* Benefit Information: Enter information matching the selected benefit type.
* Link
  * Direct entry: Enter a URL including `http://` or `https://`
  * Channel Coupon: Channel coupons can be created directly in the \[Kakao Business Dashboard]. [Learn more about how to create](https://kakaobusiness.gitbook.io/main/channel/run/biztool) Channel coupon links must include `alimtalk=coupon://`. This URL format can be found via \[Kakao Business Dashboard > Coupon Details > Copy URL].
  * ![Kakao Dashboard > Business Tools > Coupon Detail Screen](/files/soQfb7KQNIDfz90SKDqT)

**User Message Preview**

The User Message Preview can be used to verify that personalization variables are working correctly.

Enter a value that matches your personalization variable and check the actual rendered message in the preview on the right.

![](/files/dBgGSHgRizBVWCx6NAR0)
{% endstep %}

{% step %}
**Save and Test**

Once you have finished composing the message, click the \[Next] button in the upper right to continue with **Send Settings**. Or click \[Save] to save what you have written so far.

![](/files/587pcG7pzh7WYzV008fq)

Send Settings must be completed to send messages.

Click \[Edit Message] at the top of the saved message detail screen to continue with Send Settings.

![](/files/oM4hPXdn92ukcLC4Wy5b)

**Sending a Test Message**

If you want to preview the Kakao Message on an actual device, click the Test Send button.

Test messages cannot be sent when in \[Draft] status.

![](/files/sSnqAyaWMq740PqFWDFg)

Enter the phone number and click the Send button to send the Kakao Message to that number.

* Test messages are sent regardless of the campaign's status. Brand Messages cannot be sent during late-night hours (20:50–08:00).
* Test messages can only be sent to KakaoTalk Channel friends. Verify that the entered phone number has been added as a friend.
* Credits are deducted when sending a test message. Test message sending may be restricted if there are insufficient remaining credits.
  {% endstep %}
  {% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hackle.io/en/crm-marketing/kakao-message-guide/brand-message.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.