--- title: "Справочник настроек организации" description: "Управляйте организацией ThunderPhone: профилем, языком панели управления, участниками, подтверждением исходящих звонков, заблокированными звонящими, вебхуками, единым входом, ключами API, оповещениями, оплатой, лимитами расходов и историей." --- Откройте **Настройки организации** (`/dashboard/organization`), чтобы управлять активной организацией и собственной учётной записью. Настройки разделены на шесть вкладок; ваша роль определяет, какие элементы управления вы можете изменять. ## Моя учётная запись Вкладка **Моя учётная запись** содержит настройки для пользователя, выполнившего вход, а не для всей организации: - Имя, фамилия, email и URL аватара. - Язык отображения панели управления. - Скачивание приложения для macOS. - Добавление, проверка, просмотр и удаление ключей доступа. - Настройки файлов cookie. - Выход на текущем устройстве. Если вы входите через SSO организации, поставщик идентификации управляет вашим email, и здесь он доступен только для чтения. Подробный процесс работы с ключами доступа и профилем описан в разделе [Учётная запись и безопасность](/ru/guides/account-and-security). ## Общие ### Соответствие требованиям для исходящих вызовов Для организаций, на которые распространяется это требование, владелец или администратор должен проверить и зафиксировать однократное подтверждение исходящих вызовов, прежде чем агенты смогут совершать исходящие вызовы. Участники видят, что требуется действие, но не могут его отправить. См. [Законы об исходящих вызовах](/ru/guides/outbound-calling-laws). ### Отчетность Часовой пояс, еженедельные рабочие часы и собственные тестовые номера организации. Рабочие часы определяют, какие звонки считаются совершёнными в нерабочее время в показателях отчётов о звонках на Главной, на вкладке **Звонки** каждого агента и в Клиентских порталах, а также при использовании фильтра **Рабочие часы** в Истории звонков. Если не отмечен ни один день, звонки в нерабочее время не отслеживаются, и каждый звонок считается совершённым в рабочее время. Звонки с тестового номера или на тестовый номер исключаются из всех показателей отчётов, списков порталов, показателей Обзора и CSV-экспортов; их нельзя открыть в портале. У агента могут быть собственные часовой пояс и рабочие часы в разделе **Отчетность** конструктора агента, которые применяются только к звонкам этого агента. Владельцы и администраторы изменяют эти настройки в разделе **Общие → Отчетность**. Выберите часовой пояс и отметьте каждый рабочий день, затем укажите время открытия и закрытия. В разделе **Тестовые номера** введите каждый номер и выберите **Добавить**. Затем выберите **Сохранить настройки отчетности**. Пока часовой пояс не сохранён, отчёты используют UTC; страница предлагает часовой пояс вашего браузера как несохранённое изменение. После настройки любых рабочих часов звонки в неотмеченные дни считаются совершёнными в нерабочее время при использовании этого расписания. #### Настройка отчетности через API Владельцы и администраторы могут использовать `PATCH /v1/orgs/{id}/` с параметрами `timezone`, `business_hours` и `excluded_numbers`: - `timezone`: имя часового пояса IANA, например `America/Los_Angeles`, длиной до 64 символов. - `business_hours`: ключи дней недели от `mon` до `sun`, каждый из которых содержит список из не более чем четырёх интервалов `{start, end}` в 24-часовом формате `HH:MM`, где каждое значение окончания позже значения начала. `{}` означает отсутствие разделения на рабочее и нерабочее время. - `excluded_numbers`: до 50 телефонных номеров, хранящихся в формате E.164. К номеру из Северной Америки без кода страны из 10 цифр добавляется код страны `+1`. ```bash curl -X PATCH https://api.thunderphone.com/v1/orgs/42/ \ -H "Authorization: Bearer sk_live_YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "timezone": "America/Los_Angeles", "business_hours": { "mon": [{"start": "09:00", "end": "17:00"}], "sat": [{"start": "10:00", "end": "14:00"}] }, "excluded_numbers": ["+14155550199"] }' ``` ### Заблокированные звонящие Номера из этого списка не могут дозвониться до ваших голосовых агентов. Когда заблокированный номер звонит на любой из телефонных номеров вашей организации, ThunderPhone завершает вызов до ответа агента и не взимает плату за звонок. Он всё равно отображается в Истории звонков как неудавшийся входящий звонок с причиной завершения **Заблокированный звонящий**. Звонки со скрытым или анонимным идентификатором звонящего никогда не сопоставляются, а исходящие звонки на заблокированный номер не затрагиваются. Звонящий, которого вы заблокировали во время звонка, не будет отключён; блокировка применяется начиная со следующего звонка. Каждый участник может просматривать список; владельцы и администраторы изменяют его в разделе **Общие → Заблокированные звонящие**: - Чтобы заблокировать один номер, введите его с необязательной заметкой и выберите **Заблокировать номер**. Используйте `+` и код страны; национальный формат, например `(415) 555-0123`, также работает, если все телефонные номера вашей организации находятся в одной стране. - Чтобы заблокировать сразу много номеров, выберите **Вставить список**, вставьте до 500 номеров (по одному в строке или разделённых запятыми) и отправьте его. Результат покажет, сколько номеров добавлено, уже заблокировано или недействительно, а также перечислит недействительные записи. - Чтобы разблокировать номер, выберите **Удалить** в его строке и подтвердите действие. Вы также можете открыть входящий звонок в **Истории звонков** и выбрать **Заблокировать этого звонящего**. Организация может заблокировать до 10 000 номеров. Чтобы управлять списком через API, см. [Заблокированные звонящие](/api-reference/blocked-callers). ### Идентификация организации и участие Карточка организации показывает идентификатор организации, вашу роль участника и редактируемое название организации. Карточка команды объединяет активных участников и ожидающие приглашения. | Роль | Типичный доступ | | --- | --- | | **Участник** | Создание и управление агентами, а также проверка вызовов. | | **Администратор** | Доступ участника, а также администрирование команды, ключей, порталов, подключений, оповещений, биллинга и безопасности. | | **Владелец** | Доступ администратора, а также действия с организацией на уровне владельца. | Владельцы и администраторы могут приглашать **Участника** или **Администратора**, отзывать ожидающее приглашение, изменять роли подходящих участников и удалять участников. Приглашения привязаны к email и истекают через семь дней. См. [Пригласите команду](/ru/guides/invite-your-team). Опасная зона позволяет подходящему пользователю покинуть организацию или навсегда удалить её. При удалении удаляются агенты, номера, история вызовов и данные биллинга организации; это действие нельзя отменить. Чтобы удалить собственную учётную запись, откройте вкладку **Учётная запись** и выберите **Удалить учётную запись**. В диалоговом окне перечислены организации, которые будут удалены (те, где вы единственный участник), и организации, которые вы покинете. Созданные вами API-ключи в организации, которую вы покидаете, будут отозваны. Удаление блокируется, если вы единственный владелец организации с другими участниками (сначала назначьте владельцем другого пользователя), если вы создали пользовательские голоса в организации, которая остаётся, если выполняется звонок или действует юридическое удержание; в диалоговом окне указано, что именно блокирует удаление. Это действие нельзя отменить. ### Вебхук по умолчанию Укажите один устаревший URL вебхука для получения событий от всех веб-виджетов и телефонных номеров в организации. Для секретов на уровне конечных точек, подписок, истории доставки и повторных попыток используйте рекомендуемые [конечные точки вебхуков](/ru/webhooks/endpoints). ### SSO для бизнеса Настройте одно или несколько SSO-подключений, разрешённые домены email, JIT-подготовку пользователей, роль по умолчанию и необязательные сопоставления групп с ролями. Политика безопасности может требовать SSO, разрешать экстренный доступ по паролю для администраторов и требовать ключи доступа для доступа к организации. См. [SSO](/ru/guides/sso). ## Ключи Вкладка **Ключи** управляет секретными серверными API-ключами `sk_live_`. В каждой строке указаны название, префикс, активное или отозванное состояние, время создания, последнее использование и время отзыва. Полный секрет отображается только один раз, сразу после создания. Скопируйте его тогда и сохраните в менеджере секретов. Отзыв необратим и останавливает каждую интеграцию, использующую ключ. См. [API-ключи](/ru/guides/api-keys). Публикуемые ключи `pk_live_` относятся к **Веб-виджетам**, поскольку это учётные данные браузера с ограничением по источнику, а не серверные ключи. ## Оповещения Создавайте правила метрик для процента успешных операций, процента ошибок, средней оценки, объёма вызовов или регрессий наборов тестов. Правило включает: - Компаратор и числовой порог. - Окно оценки от 1 до 720 часов. - До 10 получателей по email. - Необязательный URL входящего вебхука Slack. - Необязательную доставку в вебхук разработчика. - Период ожидания в целых минутах и состояние включения. На этой же вкладке перечислены недавние срабатывания. См. [Оповещения](/ru/guides/alerts). ## Настройки биллинга Управляйте балансом организации и поведением платежей: - Добавляйте или заменяйте платежную карту по умолчанию. - Пополняйте средства вручную. - Включайте автопополнение и задавайте его порог и сумму пополнения. - Устанавливайте или удаляйте месячный лимит расходов. Месячный лимит приостанавливает новые вызовы и использование при 100% и остаётся активным, даже если автопополнение отключено. См. [Тарифы](/ru/guides/pricing) и [Биллинг и пополнения](/ru/guides/billing-and-topups). ## История платежей Используйте **Историю платежей**, чтобы просматривать баланс и расходы за сегодня, 7 дней, 30 дней, 90 дней или за всё время. Она включает: - Динамику баланса. - Структуру расходов: плату за звонки, отчёты, телефонные номера и пополнения. - Наибольшие расходы по агентам. - Таблицу транзакций с датой, категорией, описанием, типом, суммой и итоговым балансом. - Фильтрацию по категориям и экспорт отображаемой истории в CSV или JSON. Панель управления сообщает, когда отображаются только самые последние транзакции; более старые строки за пределами этого ограничения также не включаются в экспорт. [Billing API](/api-reference/billing) поддерживает программную пагинацию.