Тестовый канал: проверка приложения без реальных клиентов

Обновлено: 11 ноября 2026 · 6 мин чтения

Шаги

1. 1

   Создайте тестовый канал

   На портале откройте раздел «Test channel» и рядом с workspace нажмите «Create test channel». Это может сделать только администратор этого workspace, в одном workspace может быть один тестовый канал. В workspace создаётся API-канал с названием «Developer test channel». По желанию создаются и демо-диалоги: они не отправляют уведомления команде и не запускают автоматизацию. Канал виден в панели так же, как другие каналы: его можно открыть, смотреть сообщения и отвечать.

2. 2

   Отправьте сообщение клиента

   POST /v1/test_channel/messages пишет в тестовый канал сообщение от имени клиента. Сообщение обрабатывается как настоящее входящее: его видят вебхуки, лента событий, синхронизация и автоматизация.

   • content: текст сообщения, не больше 5000 символов.
   • conversation_id: необязательно, номер диалога в тестовом канале. Сообщение пишется в этот диалог.
   • contact: необязательно, { "name", "identifier" }. Открывается новый диалог. Контакт с этим identifier это собственный контакт тестового канала, если его нет, он создаётся.

   curl -X POST https://api.clomni.ai/v1/test_channel/messages \
     -H "Authorization: Bearer $CLOMNI_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"content": "Здравствуйте, где мой заказ?", "contact": {"name": "Тестовый клиент", "identifier": "crm-1001"}}'

   Ответ: 201 и сообщение в формате синхронизации. Если в workspace нет тестового канала, возвращается 404 test_channel_missing. Старый адрес /v1/sandbox/messages тоже работает.

3. 3

   Какой нужен токен

   Токену нужен messages:send или conversations:write. Эти два scope работают в тестовом канале и до review (проверки):

   1. Добавьте в приложение messages:send или conversations:write, ждать review не нужно.
   2. Создайте токен в разделе «Credentials» (учётные данные) и выберите этот scope.
   3. Токен может писать в тестовый канал сообщения от имени клиента. Для остальных данных workspace работают только одобренные scope.

   Чтобы проверить публичное приложение до review, подключите его в собственном workspace приложения, как владелец: в этом workspace должен быть тестовый канал. Неодобренные scope и там работают только в тестовом канале.

4. 4

   Наружу ничего не уходит

   • У тестового канала нет адреса вебхука, попытка указать адрес возвращает 403 test_channel_webhook. Ответ оператора не выходит за пределы Clomni.
   • У контакта для имитации есть только имя: e-mail и телефона нет, кампании и письма до него не доходят.
   • Сообщение попадает только в тестовый канал, номер диалога из другого канала возвращает 404.

   Собственные вебхуки workspace, автоматизации и вебхук Вашего приложения видят эти сообщения как настоящие. Если Ваше правило автоматизации отправляет клиенту сообщение, оно тоже остаётся в диалоге тестового канала.

5. 5

   Удалите тестовый канал

   На портале нажмите «Delete test channel». Канал и диалоги в нём удаляются в фоне, так же как при удалении канала в панели. После этого можно создать новый.

6. 6

   Старый sandbox workspace

   Отдельные sandbox workspace, созданные до 9 ноября 2026 года, продолжают работать: их токены начинаются с clomni_pat_test_, /v1/me возвращает workspace.sandbox: true, операции, которые отправляют что-то наружу, возвращают 403 sandbox_restricted. В панели в таком workspace видна полоса «This is a sandbox: test data, nothing reaches a real customer.». Новые не создаются, старый можно удалить на странице портала «Test channel».