Tilda™
Интеграция с Tilda для импорта профиля клиента
В Altcraft Platform можно передавать данные клиента, который заполнил форму на сайте, сконструированном в сервисе Tilda. Для этого необходимо воспользоваться инструментом Webhooks. Подробнее о Webhooks в Tilda вы можете прочитать в этой статье.
Обратите внимание, что интеграция с Tilda позволяет интегрировать только подписки пользователей на email и SMS ресурсы.
Для успешной интеграции вам потребуется следующая информация.
- URL панели Altcraft, например:
https://ru.altcraft.com. - API-ключ (API-токен), имеющий права на отправку данных в Altcraft. Подготовить такой токен сможет пользователь вашего аккаунта с мастер-правами.
- Идентификаторы базы данных и ресурса. Если необходимости подписывать на ресурс нет, то только базы данных.
Шаг 1. Создайте Webhook в Tilda
Перейдите в раздел: Мои сайты —> Сайт —> Настройки сайта —> Форма. В самом низу вы найдете Другое —> Webhook.
Заполните поле WEBHOOK URL следующим образом:
<your.domain>/api/integrations/tilda/profile_import/?token=<api_token>
Здесь вам надо заменить <your.domain> на URL панели Altcraft, а <api_token> на предоставленный вам токен:
Нажмите "Добавить". После этого вам предложат добавить приемщик данных ко всем формам на сайте. Пропустите этот шаг, кликнув кнопку "Закрыть". Итак, Webhook создан.
Шаг 2. Настройте форму в Tilda
Откройте окно редактирования страницы сайта и найдите форму, данные из которой хотите передать в Altcraft. Затем откройте вкладку "Контент":
Найдите раздел "ПРИЕМ ДАННЫХ ИЗ ФОРМЫ" и выберите ваш Webhook:
В Tilda существует два типа формы:
- простая форма с кнопкой,
- форма с несколькими полями.
Настройки для каждой из них несколько отличаются.
Простая форма
Если у вас форма с одним полем, то перейдите в Настройки вашей простой формы — кнопка слева от Контента.
Затем проскрольте настройки, пока не найдете раздел с полями. Здесь нужно обратить внимание на имя переменной в каждом из полей.
| Поле | Описание |
|---|---|
| Имя переменной | Если вы хотите, чтобы это поле попало в Altcraft, то его имя должно соотвествовать такому же полю в базе данных. Имя переменной должно быть email или phone. Имя не чувствительно к регистру, например, если в БД Altcraft есть поле "email", а в Tilda поле называется "EMAIL", то данные из формы все равно будут переданы успешно. |
| Имя переменной скрытого поля для ввода | Назовите его to_ids |
| Значение переменной скрытого поля для ввода | Введите через двоеточие идентификатор базы данных и идентификатор ресурса. Если на ресурс подписывать не нужно, то только идентификатор базы данных. На скриншоте ниже, в примере указан 9 — идентификатор БД, 10 — идентификатор ресурса. |
Пример заполнения полей:
Форма с несколькими полями
Если вы работаете с формой, которая содержит несколько полей, то вам необходимо открыть вкладк у "Контент". Там разверните вкладку "ПОЛЯ ДЛЯ ВВОДА".
Обратите внимание на имена всех переменных, которые содержит форма. Если вы хотите, чтобы поле попало в Altcraft, его имя должно соответствовать такому же полю в базе данных. Имя переменной должно быть email или phone. Имя переменной не чувствительно к регистру, например, EMAIL тоже будет работать.
После настройки видимых полей формы, добавьте еще одно поле. Тип — скрытое. Назовите его to_ids. Введите через двоеточие идентификатор базы данных и идентификатор ресурса. Если на ресурс подписывать не нужно, введите только идентификатор базы данных.
В примере на скриншоте ниже указан 9 — идентификатор БД, 10 — идентификатор ресурса.
Интеграция с Tilda позволяет не только импортировать новые профили в базы данных Altcraft, но и сразу запустить триггерное событие. Так, вы можете запустить триггерную рассылку сразу после импорта нового профиля, чтобы отправить ему приветственный email, или добавить профиль в сценарий приветственной цепочки.
Для этого вам надо добавить дополнительные скрытые поля в форме:
| Действие после импорта | Имя переменной | Значение |
|---|---|---|
| Запустить триггерную рассылку | trigger_id | Идентификатор триггерной рассылки |
| Добавить профиль в сценарий | workflow_id | Идентификатор сценария |
Передача статуса подписки
Когда вы импортируете профиль из формы с несколькими полями, вы можете передать определенный статус подписки на ресурс. Именно этот статус отобразится в цифровом профиле подписчика в платформе Altcraft.
Для передачи статуса профиля вам необходимо добавить еще одно скрытое поле в настройках вашей формы. В качестве имени переменной необходимо указать status_sub, а в качестве значения выбрать один из статусов, зарезервированных платформой Altcraft.
Доступные статусы:
| Статус | Значение поля "status_sub" |
|---|---|
| Подписан | 0 |
| Отписан | 1 |
| Жалобщик | 2 |
| Hardbounced | 3 |
| Не подтвержден | 4 |
| Приостановлен | 5 |
| Не валиден | 6 |
Шаг 3. Протестируйте форму
После того как вы настроите поля для формы, нажмите "Сохранить и закрыть". Опубликуйте страницу. После публикации протестируйте лендинг, отправив в форму тестовые данные.
Tilda не сразу обновит форму, поэтому лучше тестировать ее через пару минут после публикации.
Затем откройте Ваш проект —> Заявки из форм.
На скриншоте пример успешно отправленной заявки. Если вы видите ошибку, необходимо проверить следующие моменты:
- URL в Webhook прописан верный и содержит верный API Ключ
- База данных существует и она выбрана в ресурсе, который вы используете для подписки.
- В форме присутствует поле email или phone
Дополнительно
Вы также можете передавать поле matching, как и в других API запросах на импорт, для уточнения способа идентификации профиля. По умолчанию используется email матчинг, который осуществляет поиск и по email профиля, и по email из подписок. При использовании matching типа custom необходимо передать поле, по которому осуществляется поиск в field_name.
Вместо использования to_ids, можно применять поля db_id и resource_id. Поля можно прописать в Webhook URL заранее, если вам необходимо с нескольких форм отправлять данные в одну базу данных или подписывать на один ресурс.
Любое поле должно соответствовать полю в БД, если хотите, чтобы оно было сохранено, в противном случае оно будет проигнорировано. Например поля name может не быть в базе данных, чтобы передать имя в БД Altcraft вам следует назвать поле _fname или добавить в базу данных поле name.
По умолчанию идентификатор формы передается и сохраняется в поле Поставщик (_vendor). Если вы хотите изменить это поведение, то добавьте скрытое поле _vendor с необходимым значением, тогда идентификатор формы будет проигнорирован. В системе также доступны отчеты по полю Поставщик.
При обновление в БД поля профиля с типом "теги" поле полностью перезаписывается. Чтобы добавить новые значения к уже существующим, добавьте инструкцию -add к имени переменной при настройке поля в Tilda. Например, для обновления поля tag_field, используйте имя переменной tag_field-add.
