Каналы
Канал — подключённый аккаунт мессенджера (WhatsApp, Telegram, VK и другие) для вашей компании
Канал (auth) — подключённый аккаунт мессенджера для вашей компании: WhatsApp, Telegram, MAX, VK, Instagram, Facebook, Avito и другие провайдеры.
Это мост между Pact.im и мессенджером. Пока канал не создан и не подтверждён, отправлять и получать сообщения по этому каналу нельзя. Жизненный цикл: create → confirm (QR, код или OAuth) → enabled; позже канал можно отключить или удалить.
Некоторые провайдеры также отдают страницы (например, сообщества VK), которые выбираются при подтверждении. Изменения каналов приходят вебхуками — см. События каналов.
Если вы ещё используете Channels API v1, см. Переход с API v1 на API v2 для Каналов.
С API каналов вы можете:
- Получить каналы компании
- Получить каналы (несколько компаний)
- Создать канал
- Подтвердить канал
- Включить канал
- Отключить канал
- Удалить канал
Объект auth
Пример
{
"auth": {
"id": 69174,
"company_id": 52368,
"provider": "whatsapp",
"state": "enabled",
"phone_number": "79000000000",
"username": null,
"created_at": "2025-06-23T14:33:47.886Z",
"updated_at": "2025-06-23T14:33:47.886Z",
"sync_messages_at": "2025-06-22T14:33:47.877Z",
"pages": null
}
}Описание
| Параметр | Тип | Описание |
|---|---|---|
| id | Integer | ID канала |
| company_id | Integer | ID компании |
| provider | String | Название подключённого мессенджера |
| state | String | Статус подключения (disabled или enabled) |
| phone_number | Integer | Номер телефона подключённого мессенджера (если провайдер его отдаёт) |
| username | String | Имя пользователя подключённого мессенджера (если провайдер его отдаёт) |
| created_at | Time | Время подключения канала |
| updated_at | Time | Время последнего обновления |
| sync_messages_at | Time | Время, с которого началась синхронизация сообщений |
| pages | Object | Некоторые провайдеры могут отдавать список страниц для подключения |
Объект pages
Пример
{
"page": {
"id": 30190,
"auth_id": 69167,
"company_id": 52368,
"external_id": "229559196",
"name": "Test1",
"enabled": true
}
}Описание
| Параметр | Тип | Описание |
|---|---|---|
| id | Integer | ID страницы |
| auth_id | Integer | ID канала, к которому относится страница |
| company_id | Integer | ID компании, к которой относится страница |
| external_id | Integer | Внешний ID страницы |
| name | String | Название страницы |
| enabled | Boolean | Статус подключения страницы (true или false) |