Интеграция с Tilda

Последние изменения: 01.12.2024

При интеграции с Tilda возникает задача принимать в Sherlock Platform заявки с форм Tilda и далее их обрабатывать. Для этого в Sherlock Platform предусмотрен обработчик https://{Sherlock_API_URL}/v2/Tilda/. Для данного обработчика доступны следующей query параметры:

  • tableSystemName - имя таблицы (без префикса at_) для сохранения записи

  • userProfileId - идентификатор канала для отправки сообщения

  • text - текст сообщения для отправки

  • botThemeId - идентификатор сценария для запуска

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

Сохранение заявки в таблицу

Для сохранения заявки в таблицу необходимо сделать:

  1. Создать пользовательскую таблицу с полями, присутствующими в заявке Tilda. Имя поля в Tilda (variable name) должно точно совпадать с кодом поля в таблице Sherlock

  2. Для удобства последующей обработки рекомендуется добавить в таблицу логическое поле IsProcessed

  3. В разделе [Настройки сайта] Tilda надо добавить отправку данных на WebHook. Реквизит tableSystemName является обязательным, имя таблицы указывается без префикса at_

  4. Подключить данный WebHook для отправки заявок на данный WebHook

  5. Протестировать отправку заявки с формы. В таблице должна появиться новая запись

Сама обработка заявок в Sherlock Platform выполняется в зависимости от бизнес задачи. Если на основе полученных заявок необходимо выполнять какие-либо действия (например, отправку уведомлений подписчикам, т.д.), то необходимо настроить сценарий, который будет выполняться автоматически. Для этого:

  1. Перейти в раздел Настройки => Автозапуск сценариев и добавить сценарий с необходимой частотой запуска

  2. В сценарии добавить выборку записей таблицы запросом: SELECT * FROM at_[TableName] WHERE IsProcessed<>1

  3. Выполнить с выбранными записями операции в соответствии с требуемой бизнес логикой

  4. Установить запросом признак IsProcessed=1 (UPDATE at_[TableName] SET IsProcessed=1 WHERE ID='{Id_текущей_записи}')

Отправка сообщения пользователю

Для отправки сообщения пользователю необходимо указать реквизиты userProfileId и text. Также на форме тильды должен присутствовать телефон (phone)

Внутри отправка осуществляется по алгоритму метода Отправка сообщения по номеру телефона. Для метода используются параметры

  • name, phone, email - берутся из формы Тильда

  • userProfileId и text - из query параметров

  • parameters - передаются все реквизиты формы Тильды

  • smsBotThemeId, messengerBotThemeId - сценарий для запуска из query параметра botThemeId

Необходимые параметры для WhatsApp можно получить с помощью формы в интерфейсе "Отправить сообщение по номеру"

Помогла ли вам статья?