# Text message

A text message is a plain text message. You can send a text message by making a `POST` request to the `/messages:send` Conversation API [endpoint](/docs/conversation/api-reference/conversation/messages/) with the following payload:

```json
{
  "app_id": "{APP_ID}",
  "recipient": {
    "identified_by": {
      "channel_identities": [
        {
          "channel": "{CHANNEL}",
          "identity": "{IDENTITY}"
        }
      ]
    }
  },
  "message": {
    "text_message": {
      "text": "This is a text message."
    }
  }
}
```

## Text message schema

A text message can take the following parameters and properties. Required parameters are marked.

```json
{
  "$ref": "#/components/schemas/TextMessageField",
  "components": {
    "schemas": {
      "TextMessageField": {
        "type": "object",
        "title": "Text",
        "description": "A message containing only text.",
        "properties": {
          "text_message": {
            "type": "object",
            "title": "Text Message",
            "required": [
              "text"
            ],
            "properties": {
              "text": {
                "description": "The text to be sent.",
                "type": "string"
              }
            }
          }
        }
      }
    }
  }
}
```

The following sections give examples of how card messages are rendered in each channel and specific parameter support:

- [WhatsApp](#whatsapp)
- [SMS](#sms)
- [Facebook Messenger](#facebook-messenger)
- [Instagram](#instagram)
- [MMS](#mms)
- [RCS](#rcs)
- [Viber Business Messages](#viber-business-messages)
- [Telegram](#telegram)
- [KakaoTalk](#kakaotalk)
- [LINE](#line)
- [WeChat](#wechat)


## WhatsApp

WhatsApp channel natively supports text messages. You can include a maximum of 4096 characters in a single text message.

Note:
This character limit applies to generic messages sent on the WhatsApp channel, which can only be sent during a customer [customer care session](https://community.sinch.com/t5/WhatsApp/What-is-a-Customer-Care-Session/ta-p/6858). [Approved template messages](https://community.sinch.com/t5/WhatsApp/What-is-a-message-template-and-why-are-they-necessary/ta-p/6857) with text-only bodies can include up to 32768 characters.

The following image gives an example of a text message.

![Text Message](/assets/whatsapp_text_message.760073d75a4e28896631aa7a242d35eb4f47fb8520b04fedb649cb050bbde9b5.3a8dbadf.png)

## SMS

Note:
If you are sending messages on the SMS channel and you haven't set a [default originator](/docs/conversation/channel-support/sms/best-practices#international-considerations-for-the-sms-service-plan) in the Sinch Build Dashboard, ensure you include the [`SMS_SENDER` property](/docs/conversation/channel-support/sms/properties) in your API call.

SMS channel natively supports text messages. The following image gives an example of a text message.

![Text Message](/assets/sms_text_message.cfa38c58fde0e9b54dda4952280b12ae2a78c313175a1b01046295adffcdce35.22f24fc4.png)

## Facebook Messenger

Facebook Messenger supports text messages natively. The following image gives an example of a text message.

![Text Message](/assets/messenger_text_message.a34e281bac0b32b10c898a8bf9ae0cc4bb8a3c1f8acd45e5b418fe1a50224dff.46a24e6c.png)

## Instagram

Instagram supports text messages natively. The following image gives an example of a text message.

![Text Message](/assets/instagram_text_message.396764260a834d4430b6f815a61b4f42d760c290c20bccf5b271ba27554463b3.01afcbcc.png)

## MMS

MMS channel supports text messages natively.

The following image gives an example of a text message.

![Text Message](/assets/mms_text_message.b6cae1d7d2acb1589df584c0c9933ca966d47899b3fe2c2876aed2cc0d9935a1.88839cbf.png)

## RCS

The RCS channel natively supports text messages.

Note the following:

- You can include a maximum of 3072 characters in a single text message.


The following image gives an example of a text message:

![Text Message](/assets/rcs_text_message.440f9b66a4fd56567ed464732538c18137cefb30db5c10f3c94df89162133907.94cf44a2.png)

## Viber Business Messages

The Viber Business Messages channel natively supports text messages. The maximum length of a text message is 1000 characters. Longer content will be truncated. Texts can be formatted with markdown.

| Format | Markdown | String to be sent | Appearance on message |
|  --- | --- | --- | --- |
| Bold | One asterisk at each end of the text: * | *This text will be bold* | **This text will be bold** |
| Italics | One underscore at each end of the text: _ | _This text will be in italics_ | *This text will be in italics* |
| Monospace | Three backticks at each end of the text: ![backtick](/assets/single_backtick.9eb2c097aeafe53e27b924cf8a4ef521233c5b416848d1c6bc62f6558ab173a6.c734a361.png)![backtick](/assets/single_backtick.9eb2c097aeafe53e27b924cf8a4ef521233c5b416848d1c6bc62f6558ab173a6.c734a361.png)![backtick](/assets/single_backtick.9eb2c097aeafe53e27b924cf8a4ef521233c5b416848d1c6bc62f6558ab173a6.c734a361.png) | ![backtick](/assets/single_backtick.9eb2c097aeafe53e27b924cf8a4ef521233c5b416848d1c6bc62f6558ab173a6.c734a361.png)![backtick](/assets/single_backtick.9eb2c097aeafe53e27b924cf8a4ef521233c5b416848d1c6bc62f6558ab173a6.c734a361.png)![backtick](/assets/single_backtick.9eb2c097aeafe53e27b924cf8a4ef521233c5b416848d1c6bc62f6558ab173a6.c734a361.png)This text will be in monospace![backtick](/assets/single_backtick.9eb2c097aeafe53e27b924cf8a4ef521233c5b416848d1c6bc62f6558ab173a6.c734a361.png)![backtick](/assets/single_backtick.9eb2c097aeafe53e27b924cf8a4ef521233c5b416848d1c6bc62f6558ab173a6.c734a361.png)![backtick](/assets/single_backtick.9eb2c097aeafe53e27b924cf8a4ef521233c5b416848d1c6bc62f6558ab173a6.c734a361.png) | `This text will be in monospace` |
| Strikethrough | One tilde at each end of the text: ~ | ~This text will have a strikethrough~ | This text will have a strikethrough |


The following image gives an example of a text message:

![Text Message](/assets/viberbm_text_message.06bc76efb06b859a82500e506f213c103432f21f8c7a311efe0d093a5aa16217.c734a361.png)

## Telegram

Telegram Bot channel natively supports text messages.

When sending text messages on the Telegram Bot channel, you can use Markdown syntax in the text content. See [**Telegram Bot channel Markdown support**](/docs/conversation/channel-support/telegram/markdown) for more information.

The following image provides an example of a text message:

![Text Message](/assets/telegram_android_textmessage.0f843e68d8cbed4993099a17c1c21de80a30f67181ff31dc033557a4acda93a2.22cfd7e9.png)

## KakaoTalk

KakaoTalk supports text messages natively. The text of the Text message has a maximum length of 1000 characters.

## LINE

LINE channel natively supports text messages.

![Text Message](/assets/line_text.376d83e4c0b0be2c50fb7e2eb00e2980eebb99b7027f14438186f3c571c6c24a.7a4a72d5.jpg)

## WeChat

WeChat channel natively supports text messages.

![Text Message](/assets/wechat_text.f3341f10934cff9df998049b0eb5ea6102d8d270f0db8b16e69927196e0d9aa4.5b7624f8.png)