v1

latestOpenAPI 3.0.12026-08-0621301.7 MB
Channels

Add a channel

Adds a new messaging channel, only admins are able to register new channels. It will use the getConversations endpoint to fetch conversations, participants and messages afterward. To use the endpoint, you need to have Messengers integration OAuth scope enabled and the Messaging manifest ready for the Messaging app extension.

post/channels

Request body

namestring required

The name of the channel

provider_channel_idstring required

The channel ID

avatar_urlstring url

The URL for an icon that represents your channel

template_supportboolean

If true, enables templates logic on UI. Requires getTemplates endpoint implemented. Find out more here.

provider_type'facebook' | 'whatsapp' | 'other'

It controls the icons (like the icon next to the conversation)

Example request

{
  "name": "My Channel"
}

Response

The channel registered

successboolean

Example response

{
  "success": true,
  "data": {
    "name": "My Channel",
    "avatar_url": "http://some-domain.com/test.jpg",
    "pd_company_id": 1,
    "pd_user_id": 1
  }
}