Перейти к содержимому
AISARAISAR
Все инструкции

Запуск сценария вебхуком: заявки с сайта и Tilda

Как отправлять заявки с формы сайта или Tilda на адрес сценария AISAR: настройка, секрет, защита адреса и то, как писать клиенту в WhatsApp Business вне окна 24 часа.

Что это даёт

Форма на сайте, лендинге Tilda или в другом сервисе может запускать сценарий AISAR. Заявка приходит на специальный адрес, AISAR находит клиента по телефону или email (или создаёт нового) и запускает сценарий: например, отправляет приветствие, заводит сделку, ставит задачу.

Что понадобится

  • Тариф с автоматизациями и право редактировать сценарии: адрес и секрет видят только такие сотрудники.
  • Сохранённый и включённый сценарий с триггером Webhook / API.
  • Подключённый канал, через который сценарий напишет клиенту (если в сценарии есть шаг отправки).

Как подключить, пошагово

  1. Сохраните сценарий. Пока он не сохранён, в настройке триггера стоит подсказка «Сначала сохраните сценарий».
  2. В настройке триггера Webhook / API нажмите «Получить адрес для заявок». Появятся адрес и секрет.
  3. Скопируйте адрес. Он выглядит как https://api.aisar.app/webhooks/automation/awh_....
  4. В Tilda откройте Настройки сайта, Формы, Webhook, вставьте адрес в поле URL и передайте секрет в заголовке X-Webhook-Secret.
  5. Отправьте тестовую заявку с формы и нажмите «Проверить» в AISAR: последняя заявка и результат появятся ниже.
Если форма не умеет задавать заголовки, используйте адрес с секретом внутри (.../awh_.../<секрет>). Такой адрес виден каждому посетителю сайта в HTML формы, поэтому отключите создание контактов, а при утечке нажмите «Заменить секрет». Старый секрет перестаёт работать сразу, обновите его в форме. Секрет принимается только в заголовке или в пути адреса, но не в параметрах запроса и не в теле.

Где в заявке телефон, email и имя

Обычные названия полей (Phone, Email, Name, а также tel, mail, телефон, почта, имя) определяются автоматически. Если в форме другие названия, в разделе «Где в заявке данные клиента» выберите поле из последней заявки или впишите его название.

Всё содержимое заявки доступно в сценарии как переменные: {{trigger.body.Name}}, а для вложенных данных {{trigger.body.order.items.0.title}}. Имя поля может содержать пробелы и кириллицу: {{trigger.body.Имя клиента}}.

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

  • Принимать заявки. Выключатель: пока он выключен, адрес отвечает ошибкой, сценарий не запускается.
  • Создавать контакт для новых клиентов. Если клиента с таким телефоном или email нет, он создаётся.
  • Дополнять данные найденного контакта. По умолчанию выключено: публичная форма не может менять существующую карточку. Включайте, только если доверяете источнику. Имя и уже заполненные значения не перезаписываются.
  • Канал для ответа клиенту. Через него сценарий пишет клиенту. Если не выбран, берётся первый подходящий.

Клиент, который уже проходил сценарий, не запустится повторно, пока в настройках сценария не разрешён повторный вход.

Защита адреса

Секрет лежит в публичной форме, поэтому AISAR считает его потенциально утёкшим и ограничивает то, что можно сделать через адрес.

  • Тело заявки до 64 КБ. Повтор той же заявки в течение 10 минут игнорируется (ответ duplicate). Для явного различия повторов передавайте заголовок Idempotency-Key.
  • Исходящие сообщения тарифа тоже считаются: при исчерпании лимита тарифа сценарий не откроет новый диалог.

WhatsApp Business вне окна 24 часа

WhatsApp Business позволяет первым написать клиенту только по шаблону, одобренному Meta. Поэтому обычный текст заявке по каналу WhatsApp Business не отправится, если клиент не писал вам за последние 24 часа: шаг пропускается с причиной whatsapp_window_closed, остальные шаги сценария выполняются.

Чтобы написать первым, добавьте в сценарий шаг «Отправить шаблон WhatsApp» (send-whatsapp-template): выберите канал WhatsApp Business и утверждённый шаблон, заполните его переменные (подойдут подстановки из заявки, например {{trigger.body.Name}}). Такой шаг может открыть диалог с клиентом первым, в том числе вне окна 24 часа. Подробности о шаге: «Переменные, константы и кнопки в сценариях». Для Instagram и Messenger окно закрывается так же: instagram_window_closed, messenger_window_closed. Подробнее об окне: «24-часовое окно WhatsApp Business».

Что отвечает адрес

Этот раздел для тех, кто настраивает форму или интеграцию. Ответ всегда JSON вида {"ok": true} или {"ok": false, "error": "..."}.

КодОтветЧто значит
200{"ok": true}Заявка принята, сценарий запускается в очереди.
200{"ok": true, "duplicate": true}Такая же заявка уже была в последние 10 минут.
200{"ok": true, "test": true}Проверка связи Tilda (test=test), сценарий не запускается.
400invalid_bodyТело не разобрано как форма или JSON.
403subscription_inactiveПодписка компании не даёт доступа или нет функции автоматизаций.
404not_foundНеверный адрес или секрет. Ответ одинаковый, чтобы нельзя было перебирать адреса.
409automation_inactiveПриём выключен или сценарий не активен.
411, 413length_required, body_too_largeНет длины тела или тело больше 64 КБ.
429rate_limitedСлишком много запросов. Повторите позже.

Результат обработки конкретной заявки (запущен ли сценарий, почему нет) виден в настройке триггера в блоке «Последняя заявка» и в журнале запусков сценария. Если сценарий не запустился, чаще всего причина одна из: trigger_not_matched (заявка не подходит под условия триггера), entry_gate_blocked (клиент уже проходил сценарий), contact_blocked или contact_hidden, plan_contact_limit (лимит активных контактов тарифа). Если сценарий запустился, но сообщение не ушло, причина в журнале запусков, смотрите таблицу кодов пропуска в статье о переменных и кнопках.

Управление адресом через API

Адрес, секрет и настройки доступны и по REST: GET, POST, PATCH /v1/automations/{automation}/inbound-webhook и POST .../inbound-webhook/rotate-secret. Описание полей: REST, автоматизации.

Смотрите также