Nuvem do Engagement (versão prévia)
o dotdigital Engagement Cloud é uma plataforma de automação de marketing omnichannel saaS que ajuda você a criar, enviar e testar campanhas controladas por dados.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte dotdigital |
| URL | https://dotdigital.com/contact-us/ |
| support@dotdigital.com |
| Metadados do conector | |
|---|---|
| Publicador | dotdigital |
| Site | https://dotdigital.com/ |
| Política de privacidade | https://dotdigital.com/trust-center/gdpr/ |
| Categorias | Marketing; Comunicação |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| senha | secureString | A senha dessa api | Verdade |
| nome de usuário | secureString | O nome de usuário para esta api | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 150 | 270 segundos |
Ações
| Criar catálogo de endereços |
Cria um catálogo de endereços |
| Criar contato |
Cria um contato |
| Criar inscrição do programa |
Cria uma inscrição de programa |
| Em massa cria ou atualiza contatos em massa em um catálogo de endereços |
Em massa cria ou atualiza contatos em massa em um catálogo de endereços |
| Enviar campanha de email |
Envia uma campanha especificada para um ou mais catálogos de endereços, segmentos ou contatos, como um envio imediato ou agendado |
| Enviar email transacional usando uma campanha disparada |
Envia um email transacional usando uma campanha disparada |
| Enviar mensagem SMS |
Envia uma única mensagem SMS |
|
Get |
Obtém um relatório com estatísticas sobre o que foi importado com êxito e o que não pôde ser importado |
|
Get |
Obtém o status de importação de uma importação de contato iniciada anteriormente |
Criar catálogo de endereços
Cria um catálogo de endereços
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Região
|
Region | True | integer |
Região da conta do Engagement Cloud (1 para EMEA, 2 para NA, 3 para APAC) |
|
Nome do catálogo de endereços
|
name | True | string |
O nome do catálogo de endereços que você está criando |
|
Visibilidade
|
visibility | string |
Todos os catálogos de endereços são criados como "Privados" por padrão, mas você pode defini-los como "Públicos" na criação, caso deseje. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
contacts
|
contacts | integer |
contacts |
|
id
|
id | integer |
id |
|
nome
|
name | string |
nome |
|
visibilidade
|
visibility | string |
visibilidade |
Criar contato
Cria um contato
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Catálogo de Endereços
|
Address Book | True | string |
Selecione o catálogo de endereços ou insira a ID do catálogo de endereços |
|
Região
|
Region | True | integer |
Região da conta do Engagement Cloud (1 para EMEA, 2 para NA, 3 para APAC) |
|
chave
|
key | string |
Campo de dados de contato do Engagement Cloud |
|
|
value
|
value | string |
Valor a ser importado |
|
|
Email
|
True | string |
O endereço de email do assinante |
|
|
Tipo de email
|
emailType | string | ||
|
Tipo de aceitação
|
optInType | string |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dataFields
|
dataFields | array of object |
Campo de dados |
|
chave
|
dataFields.key | string |
chave |
|
value
|
dataFields.value | string |
value |
|
email
|
string |
|
|
|
emailType
|
emailType | string |
emailType |
|
id
|
id | integer |
id |
|
optInType
|
optInType | string |
optInType |
|
status
|
status | string |
status |
Criar inscrição do programa
Cria uma inscrição de programa
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Região
|
Region | True | integer |
Região da conta do Engagement Cloud (1 para EMEA, 2 para NA, 3 para APAC) |
|
AddressBooks
|
AddressBooks | array of integer |
AddressBooks |
|
|
Contatos
|
Contacts | array of integer |
Contatos |
|
|
Programa
|
ProgramID | True | integer |
Selecione o programa ou insira a ID do programa |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
addressBooks
|
addressBooks | array of integer |
addressBooks |
|
contacts
|
contacts | array of integer |
contacts |
|
dateCreated
|
dateCreated | string |
dateCreated |
|
id
|
id | string |
id |
|
programId
|
programId | integer |
programId |
|
status
|
status | string |
status |
Em massa cria ou atualiza contatos em massa em um catálogo de endereços
Em massa cria ou atualiza contatos em massa em um catálogo de endereços
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Catálogo de Endereços
|
Address Book | True | string |
Selecione o catálogo de endereços ou insira a ID do catálogo de endereços |
|
Dados do arquivo
|
filedata | True | file |
Arquivo que contém os registros de dados a serem importados. |
Enviar campanha de email
Envia uma campanha especificada para um ou mais catálogos de endereços, segmentos ou contatos, como um envio imediato ou agendado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Região
|
Region | True | integer |
Região da conta do Engagement Cloud (1 para EMEA, 2 para NA, 3 para APAC) |
|
AddressBookIDs
|
AddressBookIDs | array of integer |
AddressBookIDs |
|
|
Campanha
|
CampaignID | True | integer |
Selecione a campanha ou insira a ID da campanha |
|
ContactIDs
|
ContactIDs | array of integer |
ContactIDs |
|
|
Data de envio
|
SendDate | date-time |
Siga o formato YYYY-MM-DDTHH:MM:SS (UTC) |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
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
|
status | string |
status |
Enviar email transacional usando uma campanha disparada
Envia um email transacional usando uma campanha disparada
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Região
|
Region | True | integer |
Região da conta do Engagement Cloud (1 para EMEA, 2 para NA, 3 para APAC) |
|
Campanha
|
CampaignID | True | integer |
A campanha selecionada deve ser do tipo "disparado" |
|
Nome
|
Name | string |
O nome do espaço reservado da personalização, por exemplo, FIRSTNAME |
|
|
Value
|
Value | string |
O valor a ser usado na personalização, por exemplo, selecione FIRSTNAME de conteúdo dinâmico |
|
|
ToAddresses
|
ToAddresses | True | array of string |
ToAddresses |
Enviar mensagem SMS
Envia uma única mensagem SMS
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Telefone celular
|
TelephoneNumber | True | string |
Os números de telefone devem ser prefixados por seu código internacional, por exemplo, +44 para o Reino Unido |
|
Região
|
Region | True | integer |
Região da conta do Engagement Cloud (1 para EMEA, 2 para NA, 3 para APAC) |
|
Message
|
Message | True | string |
Mensagens com mais de 160 caracteres ou que contêm 'Unicode' podem incorrer em custos extras |
GetContactsImportReport
Obtém um relatório com estatísticas sobre o que foi importado com êxito e o que não pôde ser importado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID de importação
|
Id | True | string |
A ID da importação |
GetContactsImportStatus
Obtém o status de importação de uma importação de contato iniciada anteriormente
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID de importação
|
Id | True | string |
A ID da importação |