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 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 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.