Тайный гость
Загрузка панели управления
Панель управления

Вход администратора

Используйте учетную запись с ролью администратора.

Обычный кабинет
Панель управления

Обзор

A
Администратор
ОБЗОР РАБОЧЕГО ПРОСТРАНСТВА

Проверки и результаты
в одном месте.

Сводка по визитам, команде и ресторанам за выбранный период.

Последние 14 дней

Завершенные проверки

Компании

Активность

Контроль

Последние проверки

#Тайный гостьКомпания / ресторанСтатусДата
ПользовательРольКомпанииСтатусСозданДействия
Справочник company

Компании / проекты

РесторанКомпанияФорматПроверокСтатусДействия
#ГостьКомпания / ресторанАнкетаОтветовМедиаОценкаPDFСтатусДата
Web Push

Отправить уведомление

Проверяем...
0активных устройств
0пользователей с push
Готовность

Настройка сервера

Аналитика качества

ИИ-анализ визитов

Сравнивает текущую проверку с предыдущими визитами того же ресторана и добавляет рекомендации в PDF.
Проверяем...
Подключение

Настройки модели

Промпт можно адаптировать под стандарты вашей сети. Ожидаемый JSON: summary, trend, strengths, risks, recommendations, focus_next_visit.
Состояние

ИИ-аналитика

0готовых анализов
0ошибок
Как работает

Данные для анализа

Текущий результат и оценки всех блоков
Предыдущие визиты именно этого ресторана
Отрицательные ответы и повторяющиеся проблемы
Комментарии тайных гостей
Рекомендации сохраняются и попадают в конец PDF
Контроль отправок

Телеграм очередь

Отдельно отслеживаются сообщение о завершении визита и PDF. Отправленные повторно не ставятся в очередь.
Внимание: если Telegram принял сообщение, но соединение оборвалось до записи результата в БД, повторная отправка может создать дубль. Проверьте группу перед массовым запуском.
Визиты и статусы доставки
—
Визит / датаКомпания / ресторанТайный гостьРезультат визитаPDF
Нажмите «Найти»
Аналитика визитов

Отчёт по тайным гостям

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

Всего визитов—
Тайных гостей с визитами—
Сводная таблица

Тайные гости и количество визитов

#Тайный гостьКоличество визитовДействие
Выберите период и нажмите «Показать»
Детализация

Список визитов

Все тайные гости
#Тайный гостьПроектРесторанПросмотр
Нет данных
Аналитика · Telegram

Еженедельные отчёты

Один PDF на проект, за полную календарную неделю с понедельника по воскресенье. Часовой пояс: Алматы (UTC+5).
Ручная выгрузка

Отчёт по проекту за выбранный период

Только завершённые визиты; диапазон до 366 дней включительно. Формирование выполняется фоновым обработчиком без отправки в Telegram.
Последние выгрузки
ПроектПериодСтатусФайл
Загрузка…
Расписание

Автоматическая отправка

Не выбрано ни одного — отчёты по всем проектам, включая новые. Ctrl/⌘ для выбора нескольких проектов.

Проверка перед отправкой

Предпросмотр результатов

Выберите проект, чтобы увидеть расчёты последней полной недели.
Отправка без дублей: уже отправленные отчёты не отправляются повторно.
Формирование PDF и отправка выполняются фоновым cron-обработчиком. Сначала сохраните настройки.
Доставка

История еженедельных PDF

ПроектПериодСтатусПопыткиPDF / ошибка
Загрузка…
Интеграции

Внешний API

Ключи доступа для других сервисов. Разрешения отдельно для справочников, списка визитов, деталей и медиа.
Управление доступом

API-ключи

Ключ отображается только один раз при создании или перевыпуске. Отключение немедленно запрещает дальнейшие запросы.
КлиентРазрешенияДоступАктивностьДействия
Загрузка...
Разработчикам

Описание и примеры запросов

REST / JSON

OpenAPI 3.0 (JSON)

Все методы работают по HTTPS, используют GET и заголовок Authorization: Bearer API_KEY. Ключ нельзя передавать через URL. Даты в часовом поясе сервера Asia/Almaty (+05:00). Значение all или отсутствие фильтра означает все разрешённые ключу записи.

МетодЭндпоинтНазначениеРазрешение
GET/api/external/projects.phpПроекты с массивом точекallow_projects
GET/api/external/visits.phpСписок визитов с пагинациейallow_visits
GET/api/external/visit.php?id=123Визит, анкета, ответы, комментарииallow_details
1. Проекты и точки

Опционально: project_ids=1,2 и location_ids=10,11. В ответе project.id = company.id, location.id = rest.id, а location.restid — бизнес-код ресторана.


          
2. Список визитов

project_ids=all|1,2, location_ids=all|10,11, date_from=2026-10-01, date_to=2026-10-09, status=all|draft|final, page=1, limit=50 (до 100). Дата — завершения для final, начала для draft. Неудалённые визиты; по умолчанию оба статуса.


          
3. Один визит по ID

Возвращает блоки анкеты, вопросы и ответы, комментарии, оценку и ссылку на PDF при наличии. URL фото/видео/аудио включаются только при отдельном разрешении «Медиа».


          
Пример JSON-ответа
{
  "success": true,
  "items": [{"id": 123, "guest": "Тайный гость #25", "project_id": 1,
             "location_id": 10, "location_code": "R10", "status": "final", "score_percent": 92.0}],
  "pagination": {"page": 1, "limit": 50, "total": 1, "total_pages": 1}
}
Ошибки: 400 — неверные параметры, 401 — неверный или просроченный ключ, 403 — нет разрешения, 404 — визит недоступен, 429 — лимит 600 запросов/час на ключ. Чужие проекты и точки не возвращаются. ФИО и телефон гостей не передаются.
Подключения

S3, Telegram и Google Maps

Хранилище медиа, автоматическая отправка отчетов и геометки ресторанов на карте.
Хранилище медиа

S3

PS Cloud: https://object.pscloud.io (Универсальное/Холодное) или https://archive.pscloud.io (Архивное).
Для PS Cloud можно оставить us-east-1; не используйте kz-ala-1.
Уведомления

Telegram-группа

Геометки ресторанов

Google Maps

Не настроено
Ключ используется только в админке для выбора координат ресторана.
После сохранения откройте «Рестораны → Изменить» и поставьте маркер кликом по карте или поиском адреса.
Безопасность

Последние действия администраторов

ДатаАдминистраторДействиеОбъектДетали
Загрузка...Пожалуйста, не закрывайте страницу