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

Интеграция позволяет передавать данные из EDPROBIZ в NotiSend.

Вы можете:

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

Вы не можете:

• Удалять подписчика из группы.
• Удалять теги подписчика.
• Удалять поля подписчика.

Основная информация.

Для интеграции используется API сервиса NotiSend.

Документация доступна по адресу: https://notisend.ru/dev/email/api/

Шаг 1. Получение API-ключа NotiSend.

Чтобы взаимодействовать с API, необходим секретный ключ. Получите его, прежде чем переходить к следующему шагу.

В личном кабинете NotiSend перейдите в раздел “Автоматизация” и выберите API и SMTP.

Нажмите на ссылку “Параметры подключения API и SMTP”.

В разделе “API Подключение” нажмите “Активировать API ключ”.

На скриншоте ниже API ключ: 94b2ad13d1cdd1aa4de847d16e90c3f4.

Шаг 2. Создание процесса в сервисе EDPROBIZ.

Чтобы передавать данные подписчиков в сервис NotiSend, необходимо создать процесс в EDPROBIZ. Мы рекомендуем использовать процесс по заказам и будем показывать примеры настроек именно на нем.

Настройте триггер запуска процесса в соответствии с вашими задачами, например после создания заказа на конкретную позицию.

После этого добавьте в процесс блок “Вызов URL”. Именно он будет отправлять данные в сервис NotiSend.

Создание или обновление подписчика в группе получателей.

Вы можете добавлять подписчика по Email в группу получателей. Добавлять или менять значения полей и тегов подписчиков. Если подписчик уже состоит в группе, его поля и теги будут обновлены.

Заполните поля в блоке “Вызвать URL” следующим образом:

Название, Заметка – по желанию, это ни на что не влияет. Необходимо, чтобы вам проще было ориентироваться в схеме вашего процесса.

URL – https://script.edpro.biz/notisend.php

Метод – POST.

Тело запроса:

{
"apikey": "KEY12345",
"idgroup": "GROUP12345",
"email": "{order.userDetail.email}",
"values": [
{
"parameter_id": "245069",
"value": "Privet"
},
{
"parameter_id": "245324",
"value": "Пока"
}
],
"tags":[
"cold",
"hot"
]
}

Вместо KEY12345 вставьте ваш API-ключ, который вы создали в 1 шаге.

Вместо GROUP12345 вставьте ID группы подписчиков, в которой вы хотите добавлять или обновлять подписчика.

Чтобы узнать ID группы подписчиков, зайдите в раздел “Получатели” и выберите группу подписчиков. В адресной строке вы увидите ID группы.

Например, если в адресной строке вы видите ссылку https://lk.notisend.ru/mailer/recipients_lists/374805/recipients, то 374805 – ID группы подписчиков.

Как обновлять поля подписчиков.

Чтобы обновить поле подписчика, нужно знать его ID.

Для того чтобы узнать ID поля, зайдите в группу подписчиков, нажмите на кнопку “Дат…”, и наведите мышку на название поля, ID которого хотите скопировать.

Щелкните по названию поля правой кнопкой мыши и скопируйте ссылку.

Ссылка будет иметь вид: https://lk.notisend.ru/mailer/recipients_lists/374805/recipients?dir=desc&order=245069, где 245069 – ID поля.

Имейте ввиду, что поля пользователей разные для каждой группы подписчиков. Соответственно, их ID в каждой группе подписчиков также различаются.

После этого в теле запроса замените значение параметра parameter_id в массиве values на ID поля подписчика, которое вы хотите задавать или обновлять.

А параметр value в массиве values.

Например, в примере выше, мы обновляет поле с ID 245069 на значение Privet, а поле с ID 245324 на значение Пока.

Вы можете передавать неограниченное количество полей в вашем запросе.

Если вы не хотите передавать поля, просто удалите массив с ними из запроса.

Как добавлять теги подписчику.

Чтобы добавить подписчику теги, передайте их названия в массиве tags.

В примере выше мы передаем теги cold и hot.

Как добавить подписчика неподтвержденным.

По умолчанию все подписчики добавляются в статусе подтвержденных.

Если вы хотите добавлять подписчика в статусе неподтвержденного получателя передайте параметр unconfirmed со значением true.

Например, так:

{

«apikey»: «KEY12345»,
«idgroup»: «GROUP12345»,
«email»: «{order.userDetail.email}»,
«unconfirmed»: «true»,
«values»: [
{
«parameter_id»: «245069»,
«value»: «Privet»
},
{
«parameter_id»: «245324»,
«value»: «Пока»
}
],
«tags»:[
«cold»,
«hot»
]
}

Обратите внимание, что этот параметр будет работать только при первом добавлении подписчика в указанную группу.

Примеры.

В этом запросе мы:

• Добавляем подписчика в группу с ID 20485.

{

«apikey»: «KEY12345»,
«idgroup»: «20485»,
«email»: «{order.userDetail.email}»,

}

В этом запросе мы:

• Добавляем подписчика в группу с ID 20485.
• Добавляем подписчику теги new, digital, api, active.

{

«apikey»: «KEY12345»,
«idgroup»: «20485»,
«email»: «{order.userDetail.email}»,
«tags»:[
«new»,
«digital»,
«api»,
«active»
]
}

В этом запросе мы:

• Добавляем подписчика в группу с ID 20485.
• Добавляем подписчику значение имя подписчика для поля с ID 574749.
• Добавляем подписчику значение телефон подписчика для поля с ID 465283.
• Добавляем подписчику значение was для поля с ID 148084.
• Добавляем подписчику значение Выпечка хлеба для поля с ID 381939.

{

«apikey»: «KEY12345»,
«idgroup»: «GROUP12345»,
«email»: «{order.userDetail.email}»,
«values»: [
{
«parameter_id»: «574749»,
«value»: «{order.userDetail.name}»
},
{
«parameter_id»: «465283»,
«value»: «{order.user.phone}»
},
{
«parameter_id»: «148084»,
«value»: «was»
},
{
«parameter_id»: «381939»,
«value»: «Выпечка хлеба»
}
]
}