Udostępnij przez

Engagement Cloud (wersja zapoznawcza)

dotdigital Engagement Cloud to wielokanałowa platforma automatyzacji marketingu SaaS, która ułatwia tworzenie, wysyłanie i testowanie kampanii opartych na danych.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name obsługa dotdigital
adres URL https://dotdigital.com/contact-us/
Email support@dotdigital.com
Metadane łącznika
Publisher dotdigital
Witryna internetowa https://dotdigital.com/
Zasady ochrony prywatności https://dotdigital.com/trust-center/gdpr/
Kategorie Marketing; Komunikacja

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
hasło securestring Hasło dla tego interfejsu API Prawda
nazwa użytkownika securestring Nazwa użytkownika dla tego interfejsu API Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 150 270 sekund

Akcje

GetContactsImportReport

Pobiera raport ze statystykami dotyczącymi tego, co zostało pomyślnie zaimportowane i czego nie można zaimportować
GetContactsImportStatus

Pobiera stan importu wcześniej rozpoczętego importu kontaktów
Tworzenie książki adresowej

Tworzy książkę adresową
Tworzenie rejestracji programu

Tworzy rejestrację programu
Utwórz kontakt

Tworzy kontakt
Wysyłanie kampanii e-mail

Wysyła określoną kampanię do co najmniej jednej książki adresowej, segmentów lub kontaktów jako natychmiastowego lub zaplanowanego wysyłania
Wysyłanie transakcyjnej wiadomości e-mail przy użyciu wyzwolonej kampanii

Wysyła transakcyjną wiadomość e-mail przy użyciu wyzwolonej kampanii
Wyślij wiadomość SMS

Wysyła pojedynczą wiadomość SMS
Zbiorcze tworzenie lub zbiorcze aktualizowanie kontaktów w książce adresowej

Zbiorcze tworzenie lub zbiorcze aktualizowanie kontaktów w książce adresowej

GetContactsImportReport

Identyfikator operacji:
GetContactsImportReport

Pobiera raport ze statystykami dotyczącymi tego, co zostało pomyślnie zaimportowane i czego nie można zaimportować

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator importu
 Id True string

Identyfikator importu

GetContactsImportStatus

Identyfikator operacji:
GetContactsImportStatus

Pobiera stan importu wcześniej rozpoczętego importu kontaktów

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator importu
 Id True string

Identyfikator importu

Tworzenie książki adresowej

Identyfikator operacji:
CreateAddressBook

Tworzy książkę adresową

Parametry

Nazwa Klucz Wymagane Typ Opis
Region
 Region True integer

Region konta usługi Engagement Cloud (1 dla REGIONU EMEA, 2 dla NA, 3 dla APAC)
Nazwa książki adresowej
 name True string

Nazwa tworzonej książki adresowej
Widoczność
 visibility string

Wszystkie książki adresowe są domyślnie tworzone jako "Prywatne", ale można ustawić je jako "Publiczne" podczas tworzenia.

Zwraca

Nazwa Ścieżka Typ Opis
contacts
 contacts integer

contacts
id
 id integer

id
nazwa
 name string

nazwa
widoczność
 visibility string

widoczność

Tworzenie rejestracji programu

Identyfikator operacji:
CreateProgramEnrolment

Tworzy rejestrację programu

Parametry

Nazwa Klucz Wymagane Typ Opis
Region
 Region True integer

Region konta usługi Engagement Cloud (1 dla REGIONU EMEA, 2 dla NA, 3 dla APAC)
Książki adresowe
 AddressBooks array of integer

Książki adresowe
Kontakty
 Contacts array of integer

Kontakty
Program
 ProgramID True integer

Wybierz program lub wprowadź identyfikator programu

Zwraca

Nazwa Ścieżka Typ Opis
addressBooks
 addressBooks array of integer

addressBooks
contacts
 contacts array of integer

contacts
dateCreated
 dateCreated string

dateCreated
id
 id string

id
programId
 programId integer

programId
stan
 status string

stan

Utwórz kontakt

Identyfikator operacji:
CreateContact

Tworzy kontakt

Parametry

Nazwa Klucz Wymagane Typ Opis
Książka adresowa
 Address Book True string

Wybierz książkę adresową lub wprowadź identyfikator książki adresowej
Region
 Region True integer

Region konta usługi Engagement Cloud (1 dla REGIONU EMEA, 2 dla NA, 3 dla APAC)
klucz
 key string

Pole danych kontaktu z chmurą w chmurze
value
 value string

Wartość do zaimportowania
Email
 email True string

Adres e-mail subskrybenta
Typ wiadomości e-mail
 emailType string
Typ zgody
 optInType string

Zwraca

Nazwa Ścieżka Typ Opis
dataFields
 dataFields array of object

Pole danych
klucz
 dataFields.key string

klucz
value
 dataFields.value string

value
e-mail
 email string

e-mail
typ adresu e-mail
 emailType string

typ adresu e-mail
id
 id integer

id
optInType
 optInType string

optInType
stan
 status string

stan

Wysyłanie kampanii e-mail

Identyfikator operacji:
SendEmailCampaign

Wysyła określoną kampanię do co najmniej jednej książki adresowej, segmentów lub kontaktów jako natychmiastowego lub zaplanowanego wysyłania

Parametry

Nazwa Klucz Wymagane Typ Opis
Region
 Region True integer

Region konta usługi Engagement Cloud (1 dla REGIONU EMEA, 2 dla NA, 3 dla APAC)
Identyfikatory elementów AddressBook
 AddressBookIDs array of integer

Identyfikatory elementów AddressBook
Campaign
 CampaignID True integer

Wybierz kampanię lub wprowadź identyfikator kampanii
Identyfikatory kontaktów
 ContactIDs array of integer

Identyfikatory kontaktów
Data wysłania
 SendDate date-time

Postępuj zgodnie z formatem RRRR-MM-DDTHH:MM:SS (UTC)

Zwraca

Nazwa Ścieżka Typ Opis
addressBookIds
 addressBookIds array of integer

addressBookIds
identyfikator kampanii
 campaignId integer

identyfikator kampanii
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
stan
 status string

stan

Wysyłanie transakcyjnej wiadomości e-mail przy użyciu wyzwolonej kampanii

Identyfikator operacji:
SendTransactionalEmailUsingTriggeredCampagin

Wysyła transakcyjną wiadomość e-mail przy użyciu wyzwolonej kampanii

Parametry

Nazwa Klucz Wymagane Typ Opis
Region
 Region True integer

Region konta usługi Engagement Cloud (1 dla REGIONU EMEA, 2 dla NA, 3 dla APAC)
Campaign
 CampaignID True integer

Wybrana kampania musi mieć typ "wyzwolony"
Name
 Name string

Nazwa zastępcza personalizacji, na przykład FIRSTNAME
Wartość
 Value string

Wartość, która ma być używana w personalizacji, na przykład wybierz dynamiczną zawartość FIRSTNAME
ToAddresses
 ToAddresses True array of string

ToAddresses

Wyślij wiadomość SMS

Identyfikator operacji:
SendSmsMessage

Wysyła pojedynczą wiadomość SMS

Parametry

Nazwa Klucz Wymagane Typ Opis
Telefon komórkowy
 TelephoneNumber True string

Numery telefonów muszą być poprzedzone ich kodem międzynarodowym, na przykład +44 dla Wielkiej Brytanii
Region
 Region True integer

Region konta usługi Engagement Cloud (1 dla REGIONU EMEA, 2 dla NA, 3 dla APAC)
Message
 Message True string

Komunikaty zawierające ponad 160 znaków lub "Unicode" mogą wiązać się z dodatkowymi kosztami

Zbiorcze tworzenie lub zbiorcze aktualizowanie kontaktów w książce adresowej

Identyfikator operacji:
BulkContactsImport

Zbiorcze tworzenie lub zbiorcze aktualizowanie kontaktów w książce adresowej

Parametry

Nazwa Klucz Wymagane Typ Opis
Książka adresowa
 Address Book True string

Wybierz książkę adresową lub wprowadź identyfikator książki adresowej
Dane pliku
 filedata True file

Plik zawierający rekordy danych do zaimportowania.