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

Parameter

Example

Required

Description

Parameter type

groupId

1234

Required

Id of Group

Path

botName

channelBot

Required

Name of the Bot that sends the message

Query

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

Parameter

Example

Required

Description

Parameter Type

groupName

justgroup

Required

Name of Group

Path

botName

channelBot

Required

Name of the Bot that sends the message

Query

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"
  }
}