Working with channels

Knowledge Base

Knowledge Base

Working with channels

A channel is an account in a messenger or social network that is connected to Wazzup in order to communicate with customers. Channel type and channel are different things:

channel — a specific account in the messenger from which they correspond. For example, a WhatsApp account with a specific number, a specific bot in Telegram.
channel type — different types of channels for one messenger: WhatsApp, WABA, Instagram, Telegram, Telegram Bot.

So you can have multiple channels for each "channel type". For example, two WhatsApp numbers are connected. Then there will be two channels (two different numbers), and only one channel type (WhatsApp).

Getting the channel list

In order to get a list of channels that are added to work in Wazzup, you must call:

GET https://api.wazzup24.com/v3/channels

Request structure

GET /v3/channels

Request example

 curl --location --request GET 'https://api.wazzup24.com/v3/channels' \
--header 'Authorization: Bearer c8cf90444023482f909520d454368d27'

Response example

HTTP/1.1 200 OK

[
  {
    "channelId": string,
    "transport": "whatsapp",
    "plainId": "79865784457",
    "state": "active"
  }
]

Response structure

Response
└── [array of objects]
    ├── channelId
    ├── transport
    ├── plainId
    └── state

Response parameters

Parameter	Type	Description
channelId	String	Channel Id (uuidv4)
transport	String	Channel type. Available values: whatsapp — WhatsApp channel, wapi — WABA channel, instagram — Instagram channel, tgapi — Telegram channel, telegram — Telegram Bot channel, vk — VK channel, avito — Avito channel.
plainId	String	Phone number, username or ID in the messenger
state	String	Channel status: active— channel is active, init — channel is starting, disabled — the channel is turned off: it was removed from subscription or deleted with messages saved, phoneUnavailable — no connection to the phone, qr — QR code must be scanned, openElsewhere — the channel is authorized in another Wazzup account, notEnoughMoney — the channel is not paid, foreignphone — channel QR was scanned by another phone number, unauthorized — not authorized, waitForPassword — channel is waiting for a password for two-factor authentication, onModeration — the WABA channel is in moderation, rejected — the WABA channel is rejected.