Как работать с заявками

Приём по API доступен на оплаченном тарифе Pro и выше. Сейчас возможность доступна только в dev-окружении

Что изменится

Отправляйте поля заявки в объекте payload. Переданные поля сохраняются целиком, включая вложенные данные. Заранее создавать поля или настраивать их сопоставление не требуется. Одна отправка создаёт одну заявку и ставит её на первый этап

Откройте заявку в списке, проверьте переданные поля и выберите следующий этап. Изменение этапа сохраняется сразу. Вложенные объекты и списки доступны в полном просмотре; сами поля заявки остаются такими, какими их отправил источник

Найдите нужные заявки поиском по переданным полям, этапу и дате поступления. Кнопка календаря рядом с сортировкой позволяет выбрать день или период: нажмите один день либо начальный и конечный дни, затем «Применить». Обе границы входят в результат; «Все даты» возвращает полный список. Фильтр использует дату поступления заявки в часовом поясе вашего устройства. Смена периода сохраняет поиск, этап, сортировку и вид списка, возвращая на первую страницу. Счётчики показывают количество заявок по этапам с учётом поиска и периода. Сортировка показывает сначала новые, сначала старые или недавно изменённые заявки

У каждой заявки есть постоянный номер. Чтобы имя и контакты клиента появились отдельным блоком, источник может передать их в payload.client: текстовые name, phone, email. Остальные поля тоже сохранятся и останутся доступны в полном просмотре. В меню внешнего вида можно переключить карточки и таблицу. Из заявки можно скопировать ссылку; печать и отправка через «Поделиться» пока недоступны

Нажмите на клиента, чтобы открыть переданные контактные данные. Через меню блока можно настроить порядок блоков и скрыть блок действий; настройка личная и сохраняется при смене пространства

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

Для просмотра участнику нужен доступ к заявкам. Для смены этапа нужно право изменения; настройки доступны участникам с правом настройки заявок

Удаление находится в «Дополнительно» блока действий и требует права удаления и просмотра. После подтверждения заявка исчезает из списка. Данные сохраняются в истории с датой удаления; её ключ повторной отправки остаётся занятым. Удалять прежние заявки можно и при выключенном приёме или после снижения тарифа

Чтобы повторная отправка из внешнего сервиса не создала дубль, передавайте заголовок Idempotency-Key. Для одного источника используйте одинаковое значение при повторе той же заявки. Повтор с тем же ключом и полями возвращает ранее принятую заявку; изменённые поля с тем же ключом получают ошибку 409. Без заголовка каждая отправка создаёт отдельную заявку

Что произойдёт при выключении

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

При снижении тарифа ниже оплаченного Pro настройка и смена этапов также недоступны. История сохраняется: её можно читать с правом просмотра заявок; выключить приём можно с правом настройки