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.
