# Text Message

## Send a Text Message

In a chat application, it's essential to send text messages to each other in real-time, allowing for quick and easy communication. Users can also view previous messages sent and received within the chat, allowing them to reference past conversations as needed.

The `sendTextMessage` function is a feature provided by the social.plus chat SDK that enables users to send plain text messages in a [Subchannel](/social-plus-sdk/chat/channels/subchannel.md). This function requires two parameters: `text` and `subchannelId`.

Here is a brief explanation of the function parameters:

* `text`: A string that contains the text message that the user wants to send. This parameter is mandatory as it contains the actual message content.
* `subchannelId`: An identifier for the subchannel where the message will be sent. Subchannels are subdivisions within a channel that represent individual topics or chat threads. Messages and interactions occur within subchannels, not the main channel itself.
* `metaData`: Additional properties to support custom fields.
* `tags` - Arbitrary strings that can be used for defining and querying the messages.

{% tabs %}
{% tab title="iOS" %}
**Version 6**

{% embed url="<https://gist.github.com/amythee/8caf4860ff3c6255b8c4b825e26cc089>" %}

**Version 5 (Maintained)**

{% embed url="<https://gist.github.com/amythee/3abe32253b20e25ee4b710942a4f806f>" %}
{% endtab %}

{% tab title="Android" %}
**Version 6**

{% embed url="<https://gist.github.com/amythee/284bdf467ea8fe7a136400d3b13287ea>" %}

**Version 5 (Maintained)**

{% embed url="<https://gist.github.com/amythee/6bc19f3db1e24e8a31af236f1823f961>" %}
{% endtab %}

{% tab title="JavaScript" %}

```javascript
import { MessageRepository } from '@amityco/js-sdk';

const liveObject = MessageRepository.createTextMessage({
  channelId: 'channel1',
  text: 'Hello World!',
});

liveObject.on('dataUpdate', message => {
  console.log('message is created', message);
});
```

When creating a message, we can also pass the `parentId` to make it appear under a parent.

```javascript
import { MessageRepository } from '@amityco/js-sdk';

const messageLiveObject = MessageRepository.createTextMessage({
  channelId: 'channel1',
  text: 'Hello World!',
  parentId: 'exampleParentMessageId,
  tags: ['tag1', 'tag2'],
  mentionees: [
    {
      "type": "user",
      "userIds": [
        "user1", “user2”
      ]
    }
  ]
});
```

{% endtab %}

{% tab title="TypeScript" %}
Version 6

{% embed url="<https://gist.github.com/amythee/59381404ca924023929f1042c315b5ae#file-createtextmessage-ts>" %}

Beta (v0.0.1)

{% embed url="<https://gist.github.com/f0ccc6a26f58792e70738a026bdfa8ad>" %}
{% endtab %}

{% tab title="Flutter" %}
{% embed url="<https://gist.github.com/amythee/cdfb7544aea37943da47bf688266ce6d#file-amitymessagetextcreate-dart>" %}
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
The limit for sending text messages is 10,000 characters per text message. Messages exceeding that limit will return an error and will not be sent.
{% endhint %}


---

# 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.social.plus/social-plus-sdk/chat/messaging/send-a-message/text-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.