Начало работы с WhatsApp API: ключ API, account_id и channel_id

Обновлено: 27 сентября 2026 · 8 мин чтения

Шаги

1. 1

   Проверьте условия

   • В аккаунте должен быть канал WhatsApp типа Cloud API. Номер WhatsApp, подключённый по QR, с этим API не работает: шаблоны есть только в Cloud API.
   • В Meta Business Manager хотя бы один шаблон должен получить статус APPROVED.
   • Загрузите шаблоны в Clomni: «Settings › Workspace settings › Inboxes», на вкладке «Configuration» канала WhatsApp нажмите «Sync Templates». Без этого шага API не найдёт шаблон.
2. 2

   Получите ключ API

   Войдите в панель под аккаунтом администратора. Внизу меню слева нажмите на своё фото профиля, выберите «Profile Settings» и перейдите в раздел «API access». Создайте ключ кнопкой «New key» и сразу скопируйте его: ключ больше не показывается.

   В документе этот ключ называется Access Token. Подробные шаги есть в статье «Как создать ключ API (API access)».

3. 3

   Найдите account_id и channel_id

   account_id есть в адресе панели: в адресе my.clomni.co/panel/accounts/88/... число 88 это номер Вашего аккаунта.

   channel_id это номер канала WhatsApp: он виден в адресе, когда Вы открываете канал в разделе «Settings › Workspace settings › Inboxes». Все Ваши номера WhatsApp и их channel_id также возвращает этот запрос:

   curl -s "https://api.clomni.ai/v1/accounts/{account_id}/whatsapp/channels" \
     -H "Authorization: Bearer <API_ACARI>"

   Канал с sendable: false подключён по QR, этот API через него не отправляет.

4. 4

   Общие правила запросов

   • Base URL: https://api.clomni.ai, только HTTPS (запрос по HTTP перенаправляется с кодом 301)
   • В каждом запросе два заголовка: Authorization: Bearer <API_ACARI> и Content-Type: application/json
   • Кодировка UTF-8, ответ в JSON
   • Даты в ISO 8601 и в UTC, например 2026-08-07T18:20:28.080Z

   Ошибка всегда одного вида, поле error в JSON:

   { "error": "Invalid phone number: 123" }

5. 5

   Кто что может

   • Список шаблонов, отправка одного сообщения и состояние окна: администратор или агент, назначенный на этот канал
   • Статус сообщения: любой пользователь аккаунта
   • Массовая отправка: только администратор

   Для интеграции лучше создать отдельного пользователя (например, «API Integration») и взять ключ у него: в диалоге видно, кто отправил сообщение, а интеграция не остановится, когда сотрудник уволится.

6. 6

   Берегите ключ

   Ключ даёт полный доступ к Вашему аккаунту. Храните его только на своём сервере: не в браузере, не в JavaScript и не внутри мобильного приложения. Никому не отправляйте ключ и не пишите его в чат.

   Если ключ утёк, остановите его в разделе «API access» кнопкой «Switch off» или «Delete» и создайте новый. Если поле «Expires on» оставить пустым, ключ бессрочный.

7. 7

   Если Вы подключались по старой версии

   Если интеграция сделана на версии 1, новый адрес api.clomni.ai/v1/..., новый заголовок Authorization: Bearer <API_ACARI>. Старый заголовок api_access_token и параметр inbox_id продолжают работать, переходить можно без спешки.

   Новое имя inbox_id это channel_id, а поле source_id в ответе теперь называется whatsapp_message_id.

8. 8

   Тестирование

   Отдельной тестовой среды (sandbox) нет. Для проверки укажите получателем свой номер: уходит настоящее сообщение, и Вы видите результат полностью.