Open in

Справочник настроек организации

Управляйте организацией ThunderPhone: профилем, языком панели управления, участниками, подтверждением исходящих звонков, заблокированными звонящими, вебхуками, единым входом, ключами API, оповещениями, оплатой, лимитами расходов и историей.

Откройте Настройки организации (/dashboard/organization), чтобы управлять активной организацией и собственной учётной записью. Настройки разделены на шесть вкладок; ваша роль определяет, какие элементы управления вы можете изменять.

Моя учётная запись

Вкладка Моя учётная запись содержит настройки для пользователя, выполнившего вход, а не для всей организации:

Имя, фамилия, email и URL аватара.
Язык отображения панели управления.
Скачивание приложения для macOS.
Добавление, проверка, просмотр и удаление ключей доступа.
Настройки файлов cookie.
Выход на текущем устройстве.

Если вы входите через SSO организации, поставщик идентификации управляет вашим email, и здесь он доступен только для чтения. Подробный процесс работы с ключами доступа и профилем описан в разделе Учётная запись и безопасность.

Общие

Соответствие требованиям для исходящих вызовов

Для организаций, на которые распространяется это требование, владелец или администратор должен проверить и зафиксировать однократное подтверждение исходящих вызовов, прежде чем агенты смогут совершать исходящие вызовы. Участники видят, что требуется действие, но не могут его отправить. См. Законы об исходящих вызовах.

Отчетность

Часовой пояс, еженедельные рабочие часы и собственные тестовые номера организации. Рабочие часы определяют, какие звонки считаются совершёнными в нерабочее время в показателях отчётов о звонках на Главной, на вкладке Звонки каждого агента и в Клиентских порталах, а также при использовании фильтра Рабочие часы в Истории звонков. Если не отмечен ни один день, звонки в нерабочее время не отслеживаются, и каждый звонок считается совершённым в рабочее время. Звонки с тестового номера или на тестовый номер исключаются из всех показателей отчётов, списков порталов, показателей Обзора и 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.

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, см. Заблокированные звонящие.

Идентификация организации и участие

Карточка организации показывает идентификатор организации, вашу роль участника и редактируемое название организации. Карточка команды объединяет активных участников и ожидающие приглашения.

Роль	Типичный доступ
Участник	Создание и управление агентами, а также проверка вызовов.
Администратор	Доступ участника, а также администрирование команды, ключей, порталов, подключений, оповещений, биллинга и безопасности.
Владелец	Доступ администратора, а также действия с организацией на уровне владельца.

Владельцы и администраторы могут приглашать Участника или Администратора, отзывать ожидающее приглашение, изменять роли подходящих участников и удалять участников. Приглашения привязаны к email и истекают через семь дней. См. Пригласите команду.

Опасная зона позволяет подходящему пользователю покинуть организацию или навсегда удалить её. При удалении удаляются агенты, номера, история вызовов и данные биллинга организации; это действие нельзя отменить.

Чтобы удалить собственную учётную запись, откройте вкладку Учётная запись и выберите Удалить учётную запись. В диалоговом окне перечислены организации, которые будут удалены (те, где вы единственный участник), и организации, которые вы покинете. Созданные вами API-ключи в организации, которую вы покидаете, будут отозваны. Удаление блокируется, если вы единственный владелец организации с другими участниками (сначала назначьте владельцем другого пользователя), если вы создали пользовательские голоса в организации, которая остаётся, если выполняется звонок или действует юридическое удержание; в диалоговом окне указано, что именно блокирует удаление. Это действие нельзя отменить.

Вебхук по умолчанию

Укажите один устаревший URL вебхука для получения событий от всех веб-виджетов и телефонных номеров в организации. Для секретов на уровне конечных точек, подписок, истории доставки и повторных попыток используйте рекомендуемые конечные точки вебхуков.

SSO для бизнеса

Настройте одно или несколько SSO-подключений, разрешённые домены email, JIT-подготовку пользователей, роль по умолчанию и необязательные сопоставления групп с ролями. Политика безопасности может требовать SSO, разрешать экстренный доступ по паролю для администраторов и требовать ключи доступа для доступа к организации. См. SSO.

Ключи

Вкладка Ключи управляет секретными серверными API-ключами sk_live_. В каждой строке указаны название, префикс, активное или отозванное состояние, время создания, последнее использование и время отзыва.

Полный секрет отображается только один раз, сразу после создания. Скопируйте его тогда и сохраните в менеджере секретов. Отзыв необратим и останавливает каждую интеграцию, использующую ключ. См. API-ключи.

Публикуемые ключи pk_live_ относятся к Веб-виджетам, поскольку это учётные данные браузера с ограничением по источнику, а не серверные ключи.

Оповещения

Создавайте правила метрик для процента успешных операций, процента ошибок, средней оценки, объёма вызовов или регрессий наборов тестов. Правило включает:

Компаратор и числовой порог.
Окно оценки от 1 до 720 часов.
До 10 получателей по email.
Необязательный URL входящего вебхука Slack.
Необязательную доставку в вебхук разработчика.
Период ожидания в целых минутах и состояние включения.

На этой же вкладке перечислены недавние срабатывания. См. Оповещения.

Настройки биллинга

Управляйте балансом организации и поведением платежей:

Добавляйте или заменяйте платежную карту по умолчанию.
Пополняйте средства вручную.
Включайте автопополнение и задавайте его порог и сумму пополнения.
Устанавливайте или удаляйте месячный лимит расходов.

Месячный лимит приостанавливает новые вызовы и использование при 100% и остаётся активным, даже если автопополнение отключено. См. Тарифы и Биллинг и пополнения.

История платежей

Используйте Историю платежей, чтобы просматривать баланс и расходы за сегодня, 7 дней, 30 дней, 90 дней или за всё время. Она включает:

Динамику баланса.
Структуру расходов: плату за звонки, отчёты, телефонные номера и пополнения.
Наибольшие расходы по агентам.
Таблицу транзакций с датой, категорией, описанием, типом, суммой и итоговым балансом.
Фильтрацию по категориям и экспорт отображаемой истории в CSV или JSON.

Панель управления сообщает, когда отображаются только самые последние транзакции; более старые строки за пределами этого ограничения также не включаются в экспорт. Billing API поддерживает программную пагинацию.