Создание аккаунта и ключа
Два способа получить ключ — из Bitrix24 или в консоли разработчика по email и паролю. Без redirect URI, без PKCE, без экрана согласия.
Получить API key можно двумя равноценными способами — в зависимости от того, как вы используете WASync.
Откройте приложение в Bitrix24, перейдите в Settings → API & Agents и найдите карточку API keys. Назовите интеграцию и нажмите Create key.
Для создания ключа нужно хотя бы одно подключение с активным API add-on
($12 за номер в месяц). Без него кнопка неактивна, а рядом указана причина;
сервер отвечает 403 addon_required. Ключ показывается один раз, прямо здесь,
с кнопкой Copy, и имеет стандартные scopes
whatsapp.read whatsapp.send.
Списки разрешённых IP-адресов, настройка webhooks и управление несколькими порталами из одного аккаунта находятся в консоли разработчика, а не в этой карточке — из карточки есть ссылка на неё.
Ключ показывается один раз — хранится только его хеш. Сразу скопируйте его в своё окружение.
export WASYNC_API_KEY=wsk_live_…Передавайте его в каждом запросе:
Authorization: Bearer $WASYNC_API_KEYНа этом настройка авторизации закончена. Никакого redirect URI, PKCE, экрана согласия и обновления токенов.
Scopes
Отмечайте только то, что нужно интеграции: scopes задаются для каждого ключа.
| Scope | Что разрешает |
|---|---|
whatsapp.read | Просматривать список подключений и читать сообщения. |
whatsapp.send | Отправлять сообщения и читать отчёты о прочтении. |
whatsapp.events | Получать webhooks и настраивать, куда они отправляются. |
whatsapp.manage | Создавать, проверять, перезапускать, выходить из аккаунта и удалять подключения. |
Scopes и список доступных подключений определяются заново при каждом запросе, поэтому отзыв или сужение прав ключа действует уже со следующего вызова: ничего не кэшируется и ничего не нужно обновлять. Подробности и то, чем грозит утечка каждого scope, описаны в разделе Scopes.
Вы не заблокируете себя
Необязательный список разрешённых IP-адресов действует только для вызовов API. Страница, где вы его редактируете, защищена вашим аккаунтом, а не ключом, поэтому она остаётся доступной с любого адреса. См. IP allowlist.
Сколько стоит подключение
Каждому номеру WhatsApp нужна активная лицензия для отправки и получения
сообщений. Новый номер начинает с 7-дневного бесплатного пробного периода,
затем стоит $19 за номер в месяц для номера qr (WAPP) или $29 за номер в
месяц для номера cloud_api (WABA), в долларах США. На портале Bitrix24
доступ к номеру через API — это отдельный add-on за $12 за номер в месяц.
Полная картина — в разделе Лицензии и пробный период.