Engagement Cloud (förhandsversion)

dotdigital Engagement Cloud är en SaaS omnichannel marketing automation-plattform som hjälper dig att skapa, skicka och testa datadrivna kampanjer.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänster	Class	Regioner
Copilot Studio	Premie	Alla Power Automate-regioner utom följande:      - Amerikanska myndigheter (GCC)      - Amerikanska myndigheter (GCC High)      – China Cloud drivs av 21Vianet      - US Department of Defense (DoD)
Logiska appar	Norm	Alla Logic Apps-regioner utom följande:      – Azure Government-regioner      – Regioner i Azure Kina      - US Department of Defense (DoD)
Power Apps	Premie	Alla Power Apps-regioner utom följande:      - Amerikanska myndigheter (GCC)      - Amerikanska myndigheter (GCC High)      – China Cloud drivs av 21Vianet      - US Department of Defense (DoD)
Power Automate	Premie	Alla Power Automate-regioner utom följande:      - Amerikanska myndigheter (GCC)      - Amerikanska myndigheter (GCC High)      – China Cloud drivs av 21Vianet      - US Department of Defense (DoD)

Kontakt
Namn	dotdigital-stöd
URL	https://dotdigital.com/contact-us/
E-postmeddelande	support@dotdigital.com

Metadata för anslutningsprogram
Utgivare	dotdigital
Webbplats	https://dotdigital.com/
Sekretesspolicy	https://dotdigital.com/trust-center/gdpr/
Kategorier	Marknadsföring; Kommunikation

Skapa en anslutning

Anslutningsappen stöder följande autentiseringstyper:

Standardinställning	Parametrar för att skapa anslutning.	Alla regioner	Går inte att dela

Standard

Tillämpligt: Alla regioner

Parametrar för att skapa anslutning.

Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.

Namn	Typ	Description	Krävs
lösenord	securestring	Lösenordet för det här API:et	Sann
username	securestring	Användarnamnet för det här API:et	Sann

Begränsningsgränser

Name	Anrop	Förnyelseperiod
API-anrop per anslutning	150	270 sekunder

Åtgärder

GetContactsImportReport	Hämtar en rapport med statistik om vad som har importerats och vad som inte kunde importeras
GetContactsImportStatus	Hämtar importstatus för en tidigare startad kontaktimport
Massgenerering eller massuppdateringar av kontakter i en adressbok	Massgenerering eller massuppdateringar av kontakter i en adressbok
Skapa adressbok	Skapar en adressbok
Skapa kontakt	Skapar en kontakt
Skapa programregistrering	Skapar en programregistrering
Skicka e-postkampanj	Skickar en angiven kampanj till en eller flera adressböcker, segment eller kontakter, antingen som en omedelbar eller schemalagd sändning
Skicka SMS	Skickar ett enda SMS-meddelande
Skicka transaktionell e-post med en utlöst kampanj	Skickar ett transaktionellt e-postmeddelande med en utlöst kampanj

GetContactsImportReport

Åtgärds-ID:

GetContactsImportReport

Hämtar en rapport med statistik om vad som har importerats och vad som inte kunde importeras

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Import-ID	Id	True	string	ID:t för importen

GetContactsImportStatus

Åtgärds-ID:

GetContactsImportStatus

Hämtar importstatus för en tidigare startad kontaktimport

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Import-ID	Id	True	string	ID:t för importen

Massgenerering eller massuppdateringar av kontakter i en adressbok

Åtgärds-ID:

BulkContactsImport

Massgenerering eller massuppdateringar av kontakter i en adressbok

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Adressbok	Address Book	True	string	Välj adressboken eller ange adressboks-ID:t
Fildata	filedata	True	file	Fil som innehåller de dataposter som ska importeras.

Skapa adressbok

Åtgärds-ID:

CreateAddressBook

Skapar en adressbok

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Region	Region	True	integer	Engagement Cloud-kontoregion (1 för EMEA, 2 för NA, 3 för APAC)
Adressboksnamn	name	True	string	Namnet på adressboken som du skapar
Synlighet	visibility		string	Alla adressböcker skapas som privat som standard, men du kan ange den som "Offentlig" när du skapar den om du vill.

Returer

Name	Sökväg	Typ	Description
contacts	contacts	integer	contacts
Id-nummer	id	integer	Id-nummer
name	name	string	name
synlighet	visibility	string	synlighet

Skapa kontakt

Åtgärds-ID:

CreateContact

Skapar en kontakt

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Adressbok	Address Book	True	string	Välj adressboken eller ange adressboks-ID:t
Region	Region	True	integer	Engagement Cloud-kontoregion (1 för EMEA, 2 för NA, 3 för APAC)
key	key		string	Kontaktdatafält för Engagement Cloud
värde	value		string	Värde som ska importeras
E-postmeddelande	email	True	string	E-postadressen för prenumeranten
E-posttyp	emailType		string
Typ av anmälning	optInType		string

Returer

Name	Sökväg	Typ	Description
dataFält	dataFields	array of object	Datafält
key	dataFields.key	string	key
värde	dataFields.value	string	värde
Mejladress	email	string	Mejladress
emailType	emailType	string	emailType
Id-nummer	id	integer	Id-nummer
optInType	optInType	string	optInType
status	status	string	status

Skapa programregistrering

Åtgärds-ID:

CreateProgramEnrolment

Skapar en programregistrering

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Region	Region	True	integer	Engagement Cloud-kontoregion (1 för EMEA, 2 för NA, 3 för APAC)
AddressBooks	AddressBooks		array of integer	AddressBooks
Kontakter	Contacts		array of integer	Kontakter
Program	ProgramID	True	integer	Välj programmet eller ange program-ID:t

Returer

Name	Sökväg	Typ	Description
addressBooks	addressBooks	array of integer	addressBooks
contacts	contacts	array of integer	contacts
dateCreated	dateCreated	string	dateCreated
Id-nummer	id	string	Id-nummer
programId	programId	integer	programId
status	status	string	status

Skicka e-postkampanj

Åtgärds-ID:

SendEmailCampaign

Skickar en angiven kampanj till en eller flera adressböcker, segment eller kontakter, antingen som en omedelbar eller schemalagd sändning

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Region	Region	True	integer	Engagement Cloud-kontoregion (1 för EMEA, 2 för NA, 3 för APAC)
AddressBookIDs	AddressBookIDs		array of integer	AddressBookIDs
Kampanj	CampaignID	True	integer	Välj kampanjen eller ange kampanj-ID:t
Kontakt-ID:er	ContactIDs		array of integer	Kontakt-ID:er
Sändningsdatum	SendDate		date-time	Följ formatet YYYY-MM-DDTHH:MM:SS (UTC)

Returer

Name	Sökväg	Typ	Description
addressBookIds	addressBookIds	array of integer	addressBookIds
campaignId	campaignId	integer	campaignId
contactIds	contactIds	array of integer	contactIds
Id-nummer	id	string	Id-nummer
sendDate	sendDate	string	sendDate
TestMetric	splitTestOptions.TestMetric	string	TestMetric
TestPercentage	splitTestOptions.TestPercentage	integer	TestPercentage
TestPeriodHours	splitTestOptions.TestPeriodHours	integer	TestPeriodHours
status	status	string	status

Skicka SMS

Åtgärds-ID:

SendSmsMessage

Skickar ett enda SMS-meddelande

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Mobiltelefon	TelephoneNumber	True	string	Telefonnummer måste föregås av deras internationella kod, till exempel +44 för Storbritannien
Region	Region	True	integer	Engagement Cloud-kontoregion (1 för EMEA, 2 för NA, 3 för APAC)
Message	Message	True	string	Meddelanden som är över 160 tecken eller innehåller "Unicode" kan medföra extra kostnader

Skicka transaktionell e-post med en utlöst kampanj

Åtgärds-ID:

SendTransactionalEmailUsingTriggeredCampagin

Skickar ett transaktionellt e-postmeddelande med en utlöst kampanj

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Region	Region	True	integer	Engagement Cloud-kontoregion (1 för EMEA, 2 för NA, 3 för APAC)
Kampanj	CampaignID	True	integer	Den valda kampanjen måste vara av typen "utlöst"
Namn	Name		string	Platshållarnamnet för anpassningen, till exempel FIRSTNAME
Värde	Value		string	Värdet som ska användas i anpassningen väljer till exempel dynamiskt innehåll FIRSTNAME
ToAddresses	ToAddresses	True	array of string	ToAddresses