> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Подключение собственного домена к рабочему пространству AgencyHandy

> Привяжите свой субдомен (например, portal.yourcompany.com) к AgencyHandy, добавив CNAME-запись у вашего DNS-регистратора — без написания кода.

По умолчанию ваше рабочее пространство AgencyHandy доступно по субдомену в зоне `agencyhandy.com`. Подключение собственного домена позволяет заменить этот URL по умолчанию вашим фирменным адресом — например, `portal.youragency.com` — обеспечивая клиентам профессиональный опыт, который укрепляет ваш бренд с самой первой страницы, на которую они попадают.

<Note>
  Настраивать собственный домен могут только **Суперадминистраторы** и **Администраторы**. Вы также должны владеть доменом и иметь доступ к его DNS-настройкам у регистратора для завершения этой настройки.
</Note>

***

## Как это работает

При добавлении собственного домена в AgencyHandy платформа предоставляет вам **CNAME-запись**. Вы добавляете эту запись в DNS-настройки вашего домена у регистратора (GoDaddy, Namecheap, Cloudflare и др.), и AgencyHandy подтверждает подключение после распространения DNS.

***

## Пошаговая настройка

<Steps>
  <Step title="Откройте настройки Custom Domain">
    Войдите в аккаунт AgencyHandy. Перейдите в раздел **Workspace Config** в левой боковой панели, затем нажмите **Custom Domain**.
  </Step>

  <Step title="Добавьте собственный домен">
    Нажмите кнопку **+ Add Custom Domain**. В появившемся поле ввода укажите субдомен, который хотите использовать — например, `portal.youragency.com`.

    <Warning>
      **Не используйте** `www` в качестве субдомена (то есть избегайте `www.youragency.com`). Префикс `www` может вызвать конфликты конфигурации и препятствует успешной верификации. Используйте другой субдомен, например `portal`, `client`, `app` или `hub`.
    </Warning>
  </Step>

  <Step title="Скопируйте данные CNAME-записи">
    После отправки домена AgencyHandy отображает DNS-запись, которую необходимо добавить:

    | Поле      | Значение                                      |
    | --------- | --------------------------------------------- |
    | **Type**  | CNAME                                         |
    | **Name**  | Ваш субдомен (например, `portal`)             |
    | **Value** | Целевое значение, предоставленное AgencyHandy |

    Тщательно скопируйте эти значения — они понадобятся вам на следующем шаге.
  </Step>

  <Step title="Добавьте CNAME-запись у DNS-регистратора">
    Войдите в панель управления вашего DNS-регистратора (например, GoDaddy, Namecheap, Cloudflare). Перейдите в раздел управления DNS для вашего домена и добавьте CNAME-запись, используя скопированные из AgencyHandy значения Type, Name и Value.

    Ниже приведены инструкции для конкретных регистраторов для Cloudflare.
  </Step>

  <Step title="Сохраните домен в AgencyHandy">
    Вернитесь в AgencyHandy и нажмите **Save Domain**. Статус изначально будет отображаться как **Disconnected** — это ожидаемо в период распространения DNS.
  </Step>

  <Step title="Дождитесь распространения DNS и выполните верификацию">
    Изменения DNS могут распространяться от нескольких минут до **48 часов** в зависимости от регистратора и настроек TTL. Периодически нажимайте **Refresh** для проверки статуса подключения.

    После завершения распространения статус изменится на **Connected** ✅.
  </Step>
</Steps>

<Warning>
  Распространение DNS может занять до **48 часов**. Если ваш домен по-прежнему отображается как **Disconnected** по истечении 48 часов, дважды проверьте правильность CNAME-записи и отсутствие конфликтующих DNS-записей для того же субдомена.
</Warning>

***

## Инструкции для Cloudflare

Если ваш домен управляется через Cloudflare, существует одна критически важная настройка, которую необходимо выполнить правильно:

<Steps>
  <Step title="Войдите в Cloudflare и выберите домен">
    Откройте [панель управления Cloudflare](https://dash.cloudflare.com) и нажмите на домен, который подключаете к AgencyHandy.
  </Step>

  <Step title="Перейдите в настройки DNS">
    Нажмите вкладку **DNS** в верхней навигации панели настроек домена.
  </Step>

  <Step title="Добавьте CNAME-запись">
    Нажмите **+ Add Record** и заполните поля:

    * **Type:** CNAME
    * **Name:** Ваш субдомен (например, `portal`)
    * **Target/Content:** Значение, предоставленное AgencyHandy
    * **TTL:** Установите **2 минуты** (или наименьшее доступное значение) при первоначальной настройке
  </Step>

  <Step title="Отключите прокси Cloudflare (обязательно)">
    В столбце **Proxy status** убедитесь, что переключатель установлен в положение **DNS only** (значок облака должен быть серым, а не оранжевым).

    <Warning>
      Если прокси Cloudflare **включён** (оранжевый значок облака), CNAME-запись не будет разрешаться корректно, и AgencyHandy не сможет верифицировать ваш домен. Необходимо установить значение **DNS Only** для успешного подключения.
    </Warning>
  </Step>

  <Step title="Сохраните запись">
    Проверьте все значения на точность и нажмите **Save**.
  </Step>
</Steps>

<Tip>
  Используйте [dnschecker.org](https://dnschecker.org) для мониторинга распространения вашей CNAME-записи в различных регионах мира. Дождитесь зелёных галочек во всех регионах, прежде чем ожидать подтверждения подключения от AgencyHandy.
</Tip>

***

## Мониторинг статуса подключения

После сохранения вернитесь в раздел **Workspace Config → Custom Domain** в AgencyHandy, чтобы отслеживать статус:

| Статус           | Значение                                                                                                           |
| ---------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Disconnected** | DNS-запись ещё не распространилась или содержит ошибку                                                             |
| **Connected**    | Домен верифицирован и активен — клиенты могут получить доступ к вашему рабочему пространству через собственный URL |

***

## Обновление или удаление собственного домена

* **Чтобы обновить домен:** удалите существующую запись и добавьте новый домен, используя те же шаги настройки, описанные выше.
* **Чтобы удалить домен:** нажмите кнопку **Delete** рядом с вашим доменом в панели Custom Domain и подтвердите удаление. Ваше рабочее пространство вернётся к URL AgencyHandy по умолчанию. Вы можете повторно добавить любой домен в любое время.

***

## Важные замечания

* **Используйте субдомен, а не корневой домен:** собственные домены AgencyHandy требуют субдомена (например, `portal.youragency.com`), а не корневого/апекс-домена (например, `youragency.com`).
* **Избегайте `www`:** субдомен `www` может вызвать проблемы при верификации. Используйте другое имя субдомена.
* **Требуется точное соответствие записей:** введите значения Type, Name и Value CNAME точно так, как указано в AgencyHandy. Любая опечатка или пропущенный символ препятствуют подключению.
* **Прокси Cloudflare должен быть отключён:** всегда устанавливайте записи Cloudflare в режим **DNS Only** для верификации собственного домена AgencyHandy.
* **Доступ только для администраторов:** добавлять, изменять или удалять настройки собственного домена могут только суперадминистраторы и администраторы.