Событие — «Входящий запрос» ( «Упомянут в GET / POST запросе»

В сервисе событие называется «Входящий запрос (Упомянут в GET запросе)». Но на самом деле оно не ограничено только одним методом вызова, а поддерживает все виды запросов (POST / PUT и т.д.)😉

Событие имеет 2 поля ввода:

• Готовая ссылка для возможности просто скопировать и вставить в сторонний сервис (1).
• Дополнительные GET параметры ссылки. В некоторых сервисах (например в GetCourse) даже при POST запросе параметры передаются так же (2).

Сама ссылка содержит ID сообщества, номер события и hash (3), который формируется из множества параметров (в том числе из специального «секретного ключа события»). Первым параметром в ссылке также прописывается секретный ключ сообщества (4). Ключ тот же, что и в настройках подключения сообщества.

В тексте события вы можете найти много полезной информации. Например, готовый набор параметров для процесса по заказам в GetCourse.

После того как вы прописали все нужные параметры, сохраните событие (забыл об этом сказать на видео) и можете копировать готовую ссылку специальной кнопочкой (6).

ВАЖНО!

Ссылка запроса содержит 2 секретных параметра: hash события и секретный ключ сообщества. Поэтому не показывайте ее никому! Так одной ссылки достаточно, чтобы запустить событие для любого вашего подписчика.

Второй важный момент при формировании hash учитывается «секретный ключ сообщества». Поэтому если по каким-то причинам вы его поменяете (например когда нажмете в списке сообществ: Еще → Обновить токен и данные), то нужно будет либо вернуть старый вручную, либо обновить все ссылки на стороннем сервисе.

Переменные действий

Любой дописанный вами произвольный GET-параметр ссылки данного события может использоваться в Автопилоте как переменная. Достаточно написать в действиях название этого параметра между символов %. Пример: %custom%:

ГОТОВЫЕ ПРИМЕРЫ ССЫЛОК

Несколько примеров готовых наборов параметров

• &sid=26187274&payment_link=https://skyjoom.com&content=Сообщенька — для простого запуска события вручную при переходе по ссылке (например при проверке работы события).

ВАЖНО!

Если в событии дописать дополнительный GET-параметр &api=1то Автопилот будет ждать выполнение всей команды, иначе вернет стандартный ответ сервера success: true — на примере Senler. Это может быть полезно на примере сервиса динамических обложек Dycover и если у вас в команде есть действие «Сменить ответ сервера»

Примеры с переменными в качестве значений GET-параметров (переменные обрабатывает сервис, отправляющий запрос!)

• &sid={object.vk_uid}&first_name={object.first_name}&last_name={object.last_name}&email={object.email}&phone={object.phone}&autopilot_id=0 — для процесса по пользователям в GetCourse, например при импорте. Дополнительная переменная autopilot_id полезна для передачи номера списка автопилота прямо из процесса.
• &sid={object.user.vk_uid}&payment_link={object.payment_link}&product_positions={object.positions} — для универсального процесса по заказам в GetCourse. Например для отправки сообщения со ссылкой на заказ и названием продукта.
• &sid={object.user.vk_uid}&course_name={object.product_title}&course_link={object.training_link}&senler_group_id=0&autopilot_id=0 — для универсального процесса по покупкам в GetCourse. Если продукт выдает доступ к тренингу (а не вхождение в группу!), то можно передать и ссылку на тренинг: {object.training_link}.

Дополнительно обычно передаю название продукта (чтобы использовать потом как название курса) а также ID списка/группы в Автопилоте или Senler, чтобы прописывать их в процессе, а в команде использовать только переменную:

Больше полезных переменных сервиса GetCourse смотрите в этой статье.

При необходимости сделать старую ссылку недействительной и обновить hash ссылки запроса, достаточно просто нажать в событии: Еще → Обновить секретный ключ. И переоткрыть команду (для обновления ссылки).

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