Send a message to a Group

POST message via groupId

Send a message to a Group by groupId

Parameter

Accessible via URL https://api.channel.io/open/v4/groups/{groupId}/messages and HTTP POST

Example

POST https://api.channel.io/open/v4/groups/1234/messages?botName=channelBot

๐Ÿ“˜

The POST request body should be a Message object. This method accepts application/json

ParameterExampleRequiredDescriptionParameter type
groupId1234RequiredId of GroupPath
botNamechannelBotRequiredName of the Bot that sends the messageQuery

POST message via groupName

Send a new message to Group by groupName

Parameter

Accessible via URL https://api.channel.io/open/v4/groups/@{groupName}/messages and HTTP POST

Example

POST https://api.channel.io/open/v4/groups/@justgroup/messages?botName=channelBot

๐Ÿ“˜

The POST request body should be a Message object. This method accepts application/json

ParameterExampleRequiredDescriptionParameter Type
groupNamejustgroupRequiredName of GroupPath
botNamechannelBotRequiredName of the Bot that sends the messageQuery

Request Body Example

Your POST request body should look like

{
    "blocks":[
        {
            "type": "text",
            "value": "This is <b>bold</b>, <i>italic</i>, and <b><i>bold+italic</i></b>"
        },
        {
            "type": "text",
            "value": "<link type="manager" value="managerId_goes_here">@username</link>"
        },
        {
            "type": "text",
            "value": "This is a url <link type="url" value="https://channel.io">https://channel.io</link>"
        },
        {
            "type": "text",
            "value": "This is a link <link type="url" value="https://channel.io">Channel</link>"
        },
        {
            "type": "code",
            "value": "<script>ChannelIO('boot')</script>"
        },
        {
            "type": "bullets",
            "blocks":[
                {
                    "type": "text"
                    "value": "Bulleted text goes here"
                },
                {
                    "type": "text"
                    "value": "Next bulleted text goes here"
                }
            ]
        }
    ],
    "options": [
        "actAsManager", "doNotPost", "doNotSearch", "doNotSendApp", "immutable", "private", "silent"
        ],
    }
}

Response

Returns a newly created message object.

{
  "message": {
    "chatKey": "string",
    "id": "string",
    "mainKey": "string",
    "threadKey": "string",
    "root": true,
    "channelId": "string",
    "chatType": "string",
    "chatId": "string",
    "personType": "string",
    "personId": "string",
    "requestId": "string",
    "language": "string",
    "createdAt": 1624422361866,
    "version": 0,
    "blocks": [
      {
        "type": "bullets",
        "language": "string",
        "value": "string",
        "blocks": [
          null
        ]
      }
    ],
    "plainText": "string",
    "updatedAt": 1624422361868,
    "buttons": [
      {
        "title": "string",
        "colorVariant": "cobalt",
        "url": "string"
      }
    ],
    "files": [
      {
        "id": "string",
        "type": "string",
        "name": "string",
        "size": 0,
        "contentType": "string",
        "duration": 0,
        "width": 0,
        "height": 0,
        "orientation": 0,
        "animated": true,
        "bucket": "string",
        "key": "string",
        "previewKey": "string",
        "channelId": "string",
        "chatId": "string",
        "chatType": "string"
      }
    ],
    "webPage": {
      "id": "string",
      "url": "string",
      "title": "string",
      "description": "string",
      "imageUrl": "string",
      "videoUrl": "string",
      "publisher": "string",
      "author": "string",
      "width": 0,
      "height": 0,
      "bucket": "string",
      "previewKey": "string",
      "logo": "string",
      "name": "string"
    },
    "log": {
      "action": "changeName",
      "values": [
        "string"
      ],
      "triggerType": "string",
      "triggerId": "string"
    },
    "reactions": [
      {
        "emojiName": "string",
        "personKeys": [
          "string"
        ]
      }
    ],
    "profileBot": [
      {
        "id": "string",
        "key": "string",
        "type": "string",
        "name": "string",
        "value": {
          "s": "string",
          "n": "string",
          "b": {
            "short": 0,
            "char": "string",
            "int": 0,
            "long": 0,
            "float": 0,
            "double": 0,
            "direct": true,
            "readOnly": true
          },
          "m": {},
          "l": [
            null
          ],
          "ss": [
            "string"
          ],
          "ns": [
            "string"
          ],
          "bs": [
            {
              "short": 0,
              "char": "string",
              "int": 0,
              "long": 0,
              "float": 0,
              "double": 0,
              "direct": true,
              "readOnly": true
            }
          ],
          "null": true,
          "bool": true
        }
      }
    ],
    "state": "sending",
    "options": [
      "actAsManager"
    ],
    "marketing": {
      "type": "string",
      "id": "string",
      "advertising": true,
      "exposureType": "fullScreen"
    },
    "supportBot": {
      "id": "string",
      "revisionId": "string",
      "sectionId": "string",
      "stepIndex": 0,
      "buttons": [
        {
          "text": "string",
          "nextSectionId": "string"
        }
      ],
      "submitButtonIndex": 0
    },
    "threadMsg": true,
    "broadcastedMsg": true,
    "rootMessageId": "string"
  }
}