Быстрый старт Inbound

Перед началом

Создайте аккаунт, подтвердите почту и войдите в кабинет. Подготовьте тестовый HTTPS-получатель под своим контролем, доступный из региона и возвращающий 2xx. Не используйте клиентские данные или рабочие побочные эффекты. Для локального приложения вместо Direct выберите вариант CLI.

Создайте Сервер

В Inbound → Servers откройте форму создания, укажите имя, выберите регион и разрешите POST. Для первого JSON-примера не ограничивайте IP и Content-Type. Нажмите Create server, скопируйте адрес из карточки. Используйте полный URL и учтите настройки ответа; по умолчанию код — 202.

Подключите Direct-получателя

В Inbound → Channels создайте Канал типа Direct.
На карточке нажмите Add endpoint и введите ваш тестовый базовый URL без query. Для базы https://receiver.example/adal ниже нужен обработчик /adal/demo; замените пример фактическим адресом.
Оставьте Ендпоинт Enabled и нажмите Save endpoints.
В Inbound → Routers создайте включённый Маршрутизатор: Add server — ваш Сервер, Add channel — созданный Канал, затем Create router.

Создание Канала без Ендпоинта или без Маршрутизатора не завершает настройку доставки.

Если получатель локальный

Direct не может обратиться к localhost вашего компьютера. Создайте Канал типа CLI, настройте локальный Ендпоинт, подключите его Маршрутизатором и запустите клиент с токеном этого Канала. Подробные команды и ограничения текущего подключения — в инструкции CLI. Для Direct клиент запускать не нужно.

Отправьте новый запрос

Задайте ADAL_SERVER_URL скопированным полным URL Сервера без завершающего слеша. В Bash выполните:

curl --silent --show-error --include \
  --request POST "$ADAL_SERVER_URL/demo?source=docs" \
  --header 'Content-Type: application/json' \
  --data-binary '{"event":"docs.first-webhook","value":1}'

URL из документации и JSON выше демонстрационные. Ответ Сервера подтверждает только путь приёма, а не результат у получателя.

Проверьте оба этапа

Откройте Inbound → Requests, отфильтруйте Сервер и найдите новый запрос.
Сверьте метод, путь/query и JSON. Запрос без получателей может оставаться received.
В Deliveries откройте ваш Канал, проверьте попытку и HTTP-успех Ендпоинта.
Подтвердите получение docs.first-webhook на тестовом обработчике. Успешный HTTP-ответ не доказывает завершение бизнес-транзакции.

Если записи нет, проверьте URL, регион и фильтры приёма. Если приём есть, но получателя нет — Маршрутизатор и Ендпоинт. При HTTP-ошибке получателя действуют автоматические повторы; обновление отчёта не запускает новую попытку.

Дальше

Настройки Сервера, Каналы, Маршрутизаторы, Direct и контролируемая ошибка, история запросов, хранение.