## Создайте аккаунт {#create-account}

Создайте аккаунт Adal перед настройкой приёма вебхуков. Сейчас Adal поддерживает регистрацию по электронной почте.

1. Откройте [страницу регистрации Adal](https://dashboard.adal.cloud/auth/register).
2. Укажите адрес электронной почты и завершите регистрацию.
3. Откройте письмо от Adal и перейдите по ссылке для подтверждения.
4. Войдите в панель управления.

> **Ожидаемый результат:** аккаунт активирован, и вам доступна панель управления.

## Создайте Server {#create-server}

Server предоставляет стабильный публичный URL для приёма вебхуков.

1. Откройте [раздел Servers](https://dashboard.adal.cloud/servers).
2. Нажмите **Create server**.
3. Выберите регион обработки и укажите название.
4. Для этого руководства оставьте остальные настройки по умолчанию, затем сохраните Server.

После создания скопируйте **Public Ingest URL** и сохраните **CLI token**.

> **Важно:** CLI token показывается только один раз. Считайте его секретом: храните безопасно, не добавляйте в систему контроля версий и не включайте в логи или обращения в поддержку.

> **Ожидаемый результат:** Server создан, у вас есть его Public Ingest URL и CLI token.

## Создайте Destination {#create-destination}

Destination определяет, куда доставляется принятый Request. Один Request может независимо доставляться в несколько Destinations.

1. Откройте [раздел Destinations](https://dashboard.adal.cloud/destinations).
2. Нажмите **Add destination**.
3. Выберите тот же регион и созданный ранее Server.
4. Укажите название и URL сервиса, который должен получить вебхук.
5. Сохраните Destination.

Для локальной проверки через CLI можно использовать URL наподобие `http://127.0.0.1:3000/webhooks`. Локальное приложение должно быть запущено и принимать запросы по указанному адресу. Для прямой доставки используйте URL, доступный из интернета.

> **Ожидаемый результат:** Destination связан с вашим Server и готов принимать Deliveries.

## Запустите Adal CLI {#run-cli}

Adal CLI поддерживает безопасное исходящее соединение и пересылает входящие Requests в локальный или закрытый сервис. [Скачайте готовую сборку](https://github.com/adal-cloud/adal-cli/releases) или [соберите CLI из исходного кода](https://github.com/adal-cloud/adal-cli).

Запустите CLI с токеном, который вы сохранили при создании Server:

```bash
adal-cli --token <your-cli-token>
```

Полезные параметры:

```bash
adal-cli --version
adal-cli --verbose <level>
```

Уровни подробности:

| Уровень | Вывод |
| --- | --- |
| `0` | Только ошибки; используется по умолчанию. |
| `1` | Основная информация о соединении и доставке. |
| `2` | Подробные рабочие логи. |
| `3` | Отладочные логи. |

Пример:

```bash
adal-cli --token <your-cli-token> --verbose 1
```

> **Ожидаемый результат:** CLI успешно подключён и ожидает входящие Deliveries.

## Отправьте тестовый вебхук {#send-test-webhook}

Замените адрес-заглушку ниже на Public Ingest URL из панели управления и отправьте тестовый запрос:

```bash
SERVER_URL='https://your-server-id.region.adal.cloud'

curl --request POST "$SERVER_URL" \
  --header 'Content-Type: application/json' \
  --header 'X-Test-Source: quickstart' \
  --data '{"message":"Hello from Adal"}'
```

Adal принимает вебхук как Request, создаёт Delivery для настроенного Destination и пересылает его через подключённый CLI или напрямую по HTTP — в зависимости от конфигурации. Исходные HTTP-метод, путь, строка запроса, заголовки и тело сохраняются.

> **Ожидаемый результат:** Request появился в Adal, а попытка доставки достигла настроенного Destination. Успешный Delivery означает, что Adal получил ожидаемый HTTP-ответ от Destination; это не подтверждает выполнение бизнес-операции в вашей системе.

## Изучите Request {#inspect-request}

Откройте [раздел Requests](https://dashboard.adal.cloud/requests), выберите Request из предыдущего шага и откройте подробности.

Вы можете проверить:

- HTTP-метод, путь и строку запроса;
- заголовки и тело запроса;
- время получения и статус Request;
- Delivery для каждого Destination и историю попыток.

Для поддерживаемых форматов тело можно просмотреть в браузере или скачать в исходном виде, если эта возможность доступна.

> **Важно:** повторные попытки и ручной replay могут привести к повторной доставке одного события. Проверяйте подпись отправителя, валидируйте входные данные, делайте обработчики вебхуков идемпотентными и устраняйте дубликаты по стабильному идентификатору события провайдера, если он доступен.

> **Ожидаемый результат:** вы видите, что получил Adal, и можете проследить результат каждой попытки Delivery.

## Что дальше {#next-steps}

Базовый сценарий завершён: Server принял вебхук, Adal сохранил его как Request, а Destination получил Delivery.

Продолжите знакомство с документацией:

- [Основные понятия](/docs/concepts)
- [Servers](/docs/servers)
- [Destinations](/docs/destinations)
- [Requests](/docs/requests)
- [Повторные попытки и replay](/docs/retries)
- [Adal CLI](/docs/adal-cli)