Облако Engagement (предварительная версия)

dotdigital Engagement Cloud — это платформа автоматизации маркетинга SaaS omnichannel, помогая создавать, отправлять и тестировать кампании на основе данных.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих:      — Регионы Azure для государственных организаций      — Регионы Azure Для Китая      - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)

Контакт
Имя	поддержка dotdigital
URL	https://dotdigital.com/contact-us/
Адрес электронной почты	support@dotdigital.com

Метаданные соединителя
Publisher	dotdigital
Веб-сайт	https://dotdigital.com/
Политика конфиденциальности	https://dotdigital.com/trust-center/gdpr/
Категории	Маркетинг; Коммуникация

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
пароль	securestring	Пароль для этого API	True
username	securestring	Имя пользователя для этого API	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	150	270 секунд

Действия

GetContactsImportReport	Возвращает отчет со статистикой о том, что было успешно импортировано и что не удалось импортировать
GetContactsImportStatus	Возвращает состояние импорта ранее запущенного контакта импорта
Массовые создание или массовые обновления контактов в адресной книге	Массовые создание или массовые обновления контактов в адресной книге
Отправка SMS-сообщения	Отправляет одно SMS-сообщение
Отправка кампании по электронной почте	Отправляет указанную кампанию в одну или несколько адресных книг, сегментов или контактов в виде немедленной или запланированной отправки.
Отправка транзакций электронной почты с помощью активированной кампании	Отправляет транзакционный адрес электронной почты с помощью активированной кампании
Создание адресной книги	Создание адресной книги
Создание контакта	Создает контакт
Создание программы зачисления	Создание программы зачисления

GetContactsImportReport

Идентификатор операции:

GetContactsImportReport

Возвращает отчет со статистикой о том, что было успешно импортировано и что не удалось импортировать

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор импорта	Id	True	string	Идентификатор импорта

GetContactsImportStatus

Идентификатор операции:

GetContactsImportStatus

Возвращает состояние импорта ранее запущенного контакта импорта

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор импорта	Id	True	string	Идентификатор импорта

Массовые создание или массовые обновления контактов в адресной книге

Идентификатор операции:

BulkContactsImport

Массовые создание или массовые обновления контактов в адресной книге

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Адресная книга	Address Book	True	string	Выберите адресную книгу или введите идентификатор адресной книги
Данные файлов	filedata	True	file	Файл, содержащий записи данных для импорта.

Отправка SMS-сообщения

Идентификатор операции:

SendSmsMessage

Отправляет одно SMS-сообщение

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Мобильный телефон	TelephoneNumber	True	string	Номера телефонов должны быть префиксированы их международным кодом, например +44 для Великобритании
Регион	Region	True	integer	Регион облачной учетной записи Engagement (1 для EMEA, 2 для NA, 3 для APAC)
Message	Message	True	string	Сообщения, содержащие более 160 символов или содержащие Юникод, могут нести дополнительные затраты.

Отправка кампании по электронной почте

Идентификатор операции:

SendEmailCampaign

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Регион	Region	True	integer	Регион облачной учетной записи Engagement (1 для EMEA, 2 для NA, 3 для APAC)
AddressBookIDs	AddressBookIDs		array of integer	AddressBookIDs
кампания	CampaignID	True	integer	Выберите кампанию или введите идентификатор кампании
Контактные идентификаторы	ContactIDs		array of integer	Контактные идентификаторы
Дата отправки	SendDate		date-time	Следуйте формату ГГГГ-ММ-ДДTHH:MM:SS (UTC)

Возвращаемое значение

Имя	Путь	Тип	Описание
addressBookIds	addressBookIds	array of integer	addressBookIds
campaignId	campaignId	integer	campaignId
contactIds	contactIds	array of integer	contactIds
id	id	string	id
sendDate	sendDate	string	sendDate
TestMetric	splitTestOptions.TestMetric	string	TestMetric
TestPercentage	splitTestOptions.TestPercentage	integer	TestPercentage
TestPeriodHours	splitTestOptions.TestPeriodHours	integer	TestPeriodHours
статус	status	string	статус

Отправка транзакций электронной почты с помощью активированной кампании

Идентификатор операции:

SendTransactionalEmailUsingTriggeredCampagin

Отправляет транзакционный адрес электронной почты с помощью активированной кампании

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Регион	Region	True	integer	Регион облачной учетной записи Engagement (1 для EMEA, 2 для NA, 3 для APAC)
кампания	CampaignID	True	integer	Выбранная кампания должна иметь тип "активируется"
Имя	Name		string	Имя заполнителя персонализации, например FIRSTNAME
Ценность	Value		string	Значение, используемое в персонализации, например выбор динамического содержимого FIRSTNAME
ToAddresses	ToAddresses	True	array of string	ToAddresses

Создание адресной книги

Идентификатор операции:

CreateAddressBook

Создание адресной книги

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Регион	Region	True	integer	Регион облачной учетной записи Engagement (1 для EMEA, 2 для NA, 3 для APAC)
Имя адресной книги	name	True	string	Имя создаваемой адресной книги
Видимость	visibility		string	Все адресные книги создаются как частные по умолчанию, но вы можете задать его как "Public" при создании, если вы хотите.

Возвращаемое значение

Имя	Путь	Тип	Описание
contacts	contacts	integer	contacts
id	id	integer	id
имя	name	string	имя
видимость	visibility	string	видимость

Создание контакта

Идентификатор операции:

CreateContact

Создает контакт

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Адресная книга	Address Book	True	string	Выберите адресную книгу или введите идентификатор адресной книги
Регион	Region	True	integer	Регион облачной учетной записи Engagement (1 для EMEA, 2 для NA, 3 для APAC)
key	key		string	Поле данных об облаке взаимодействия
value	value		string	Импортируемые значения
Адрес электронной почты	email	True	string	Адрес электронной почты для подписчика
Тип электронной почты	emailType		string
Тип согласия	optInType		string

Возвращаемое значение

Имя	Путь	Тип	Описание
dataFields	dataFields	array of object	Поле данных
key	dataFields.key	string	key
value	dataFields.value	string	value
электронная почта	email	string	электронная почта
emailType	emailType	string	emailType
id	id	integer	id
optInType	optInType	string	optInType
статус	status	string	статус

Создание программы зачисления

Идентификатор операции:

CreateProgramEnrolment

Создание программы зачисления

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Регион	Region	True	integer	Регион облачной учетной записи Engagement (1 для EMEA, 2 для NA, 3 для APAC)
AddressBooks	AddressBooks		array of integer	AddressBooks
Контакты	Contacts		array of integer	Контакты
Программа	ProgramID	True	integer	Выберите программу или введите идентификатор программы

Возвращаемое значение

Имя	Путь	Тип	Описание
адресные книги	addressBooks	array of integer	адресные книги
contacts	contacts	array of integer	contacts
dateCreated	dateCreated	string	dateCreated
id	id	string	id
programId	programId	integer	programId
статус	status	string	статус