Интеграции: игра спрашивает ваш сервис и выдаёт награду по ответу
Покупка на сайте, запись в CRM, заказ в доставке, даже погода за окном. Всё, что знает ваш сервис, может засчитать задание или выдать промокод в игре. Связь настраивается один раз в разделе «Интеграции», дальше игра сама спрашивает сервис в нужный момент.

Задание, которое засчитывается по ответу вашего сервиса, и кнопка «Проверить» в игре.
- Адрес вашего сервиса, который отвечает в формате JSON
- Ключ доступа к сервису, если он нужен
- Игра с заданием, которое хотите засчитывать
Заведите интеграцию
Откройте «Интеграции» и создайте новую. Имя связи пишется латиницей, например «pogoda» или «crm-zakaz». По этому имени интеграцию найдут задания, предметы и кнопки игры.
Адрес и вид запроса
Адрес запроса это адрес вашего сервиса. Вид запроса: GET, POST, PUT, PATCH или DELETE, как требует сервис. Ожидание ответа: сколько секунд ждать, например 3s.
Заголовки
Открытые заголовки видят все, кто правит игру: сюда тип содержимого и прочее несекретное.
Секретные заголовки для ключа доступа. Значение записывается один раз и больше нигде не показывается. Поменять адрес можно без повторного ввода ключа.
Тело запроса
Текст, который уйдёт в сервис, с подстановками из данных игрока. «${user.login}» подставит игрока, «${task.meta.productId}» значение, которое вы записали в само задание. Например: {"player": "${user.login}", "product": "${task.meta.productId}"}.
Работает только подстановка: формул, условий и значений по умолчанию в теле нет, остальной текст уходит как написан.
Разбор ответа
Покажите игре, где в ответе лежит нужное. Путь задаётся шагами: имя поля или номер в списке. Например, ответ {"result": {"done": true}} читается путём result → done.
Что игра умеет прочитать: Выполнено (строго true или false), Промокод и ПИН к нему, Действует с и Действует до (дата и время без пояса), Номер у партнёра, Имя события и Время события.
Повторы и нагрузка
Попыток всего: сколько раз переспросить сервис, если он не ответил, по умолчанию 3. Пауза между попытками в секундах. Сколько запросов одновременно: по умолчанию 20, чтобы акция не уронила ваш сервис в день рассылки.
Когда проверять
При входе в игру: включено по умолчанию. Из игры кнопкой: включите, если в игре будет кнопка «Проверить». Не чаще чем раз в: например 3600s (час), тогда сервис не спросят об одном и том же задании игрока чаще раза в час.
Подключите к заданию
В задании выберите условие «Действие у партнёра» и вашу интеграцию. Когда сервис ответит «выполнено», задание засчитается, и игрок получит его награду.
Кнопка «Проверить»
На кнопку в игре поставьте действие «Вызвать интеграцию» с именем связи. Игрок вернулся с сайта, нажал, игра спросила сервис, задание обновилось у него на глазах. Сама кнопка призов не выдаёт: приз приходит с заданием.
Промокод из вашей системы
Предмет с поведением «Интеграция» выдаёт то, что вернул сервис: промокод, ПИН и срок действия. Так игрок получает настоящий код из вашей системы, а не из заранее загруженного списка.
Журнал
Каждый вызов записывается: адрес, тело, код и тело ответа, сколько ждали. Если сервис не ответил, видно, когда и с какой ошибкой. Застрявшую заявку можно отправить заново.
Где чаще ошибаются
- Ключ доступа в открытых заголовках: его видят все, кто правит игру.
- Не включили «Из игры кнопкой», и кнопка «Проверить» получает отказ.
- Дата в ответе не в формате ISO, и промокод с непонятным сроком не выдаётся.