Netvolution (versão prévia)
O Netvolution Connector capacita as empresas a simplificar e automatizar suas campanhas de marketing de email. Ele permite segmentação de email direcionada, mensagens personalizadas e fluxos de trabalho automatizados com base no comportamento do usuário. Aproveitando o Netvolution, os profissionais de mercado podem aprimorar o engajamento, melhorar a retenção do cliente e impulsionar conversões mais altas com o mínimo de esforço.
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 | Atcom SA |
| URL | https://www.atcom.gr |
| Metadados do conector | |
|---|---|
| Publicador | Atcom S.A |
| Site | https://www.atcom.gr/ |
| Política de privacidade | https://www.atcom.gr/privacy-policy/ |
| Categorias | Comércio; Marketing |
Conector netvolution
Introdução
O Netvolution Connector permite que você projete e automatize atividades de marketing de email, incluindo o envio de emails de marketing para segmentos específicos e campanhas automatizadas com base em ações comportamentais. Esse conector fornece um conjunto de ações para gerenciar e interagir com vários recursos dentro da plataforma Netvolution.
Pré-requisitos
Antes de usar o Conector netvolution, você precisará:
- Uma implementação do Netvolution.
- Credenciais de API (chave de API).
Introdução
Para usar o Netvolution Connector, siga estas etapas:
Adicione o conector ao seu ambiente do Power Platform:
- Navegue até o portal do Power Platform.
- Vá para a seção "Conectores" e adicione um novo conector.
- Pesquise "Netvolution" e selecione-o.
Configure o Conector:
- Insira suas credenciais de API obtidas da plataforma Netvolution.
- Insira seu endereço Netvolution (sem o
httpsprefixo). - Salve a configuração.
Use o Conector em Seus Aplicativos e Fluxos:
- Adicione o conector aos fluxos do Power Apps ou do Power Automate.
- Use as ações disponíveis para interagir com os recursos do Netvolution.
Operações com suporte
O Netvolution Connector dá suporte às seguintes operações:
Obter modelos de email
- Método: GET
-
Caminho:
/cdp/mail/list-templates - Descrição: listar todos os modelos de email personalizados.
Quando um novo evento acontece
- Método: GET
-
Caminho:
/trigger/cdp/events/{eventName} -
Descrição: use isso para selecionar um evento como um gatilho. Eventos com suporte:
add_to_cart, ,view_page.view_item
Quando um contato é adicionado a um segmento
- Método: GET
-
Caminho:
/trigger/cdp/contacts/{Id} - Descrição: disparado quando um novo Contato é adicionado a um segmento.
Obter ordem para um contato
- Método: GET
-
Caminho:
/cdp/orders/{contactId} - Descrição: verifique se um Contato fez um pedido.
Verificar se o contato está na lista de supressão
- Método: GET
-
Caminho:
/cdp/suppression/check - Descrição: verifique se um contato está temporariamente na lista de supressão.
Colocar contato na lista de supressão
- Método: PUT
-
Caminho:
/cdp/suppression/add - Descrição: adicione um contato à lista de supressão por uma duração especificada.
Enviar Email
- Método: POST
-
Caminho:
/cdp/mail/send - Descrição: essa ação dispara uma campanha de email criada no Netvolution.
Verificar se o evento aconteceu
- Método: GET
-
Caminho:
/cdp/events/checkevent - Descrição: verifique se ocorreu um evento para uma determinada ID de contato em um período específico.
Obter lista de desejos
- Método: GET
-
Caminho:
/cdp/wishlist/{since} - Descrição: recupere a lista de desejos atualizada em um período especificado.
Definição de API
O conector usa a seguinte definição de API:
-
Arquivo swagger: apiDefinition.swagger.json
- Esse arquivo contém o esquema de API detalhado e os pontos de extremidade usados pelo conector.
Configurações
As configurações do conector são definidas no seguinte arquivo:
-
Arquivo de configurações: settings.json
- Esse arquivo contém várias configurações para o conector.
Ícone
O ícone do conector está incluído no seguinte arquivo:
-
Arquivo de ícone: icon.png
- Esse arquivo é usado como a representação visual do conector na interface do Power Platform.
Problemas e limitações conhecidos
- Atualmente, o conector dá suporte a operações básicas. Recursos avançados serão adicionados em versões futuras.
- Verifique se suas credenciais de API estão configuradas corretamente para evitar erros de autenticação.
Support
Para problemas ou suporte, entre em contato com a equipe de suporte do Netvolution ou consulte a documentação oficial.
Licença
Esse conector é licenciado sob a Licença do MIT. Consulte o arquivo LICENSE para obter mais detalhes.
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 |
|---|---|---|---|
| CHAVE DE API | secureString | A CHAVE para esta API | |
| Nome do host netvolution | cadeia | Netvolution Hostname (exemplo: yourdomain.netvolution.net). | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Colocar Contato na lista de supressão |
Colocar Contato na lista de supressão |
| Enviar Email |
Essa ação dispara a campanha de email criada no Netvolution. |
| Obter lista de desejos |
Obter lista de desejos |
| Obter modelos de email |
Listar todos os modelos de email personalizados. |
| Obter ordem para um contato |
Verifique se um Contato fez um pedido. |
| Verificar se o contato está na lista de supressão |
Use esta ação para verificar se um contato está temporariamente na lista de supressão. |
| Verificar se o evento aconteceu |
Verifique se o evento ocorreu para uma determinada ID de contato e por um determinado período de tempo. |
Colocar Contato na lista de supressão
Colocar Contato na lista de supressão
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID de contato
|
contactId | True | string |
Use a saída da ID de Contato com base no gatilho usado anteriormente. |
|
Nome da lista de supressão
|
listName | True | string |
Nome da lista de supressão. |
|
Intervalo de Tempo
|
timeSpan | True | string |
Especifique o número dos dias em que a ID de Contato permanecerá na Lista de Supressão desta campanha. |
Enviar Email
Essa ação dispara a campanha de email criada no Netvolution.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID de contato
|
cdpContactId | string |
ID de contato cdp do usuário. |
|
|
ID do idioma
|
languageId | string |
ID do idioma conforme especificado no site de netvolution. |
|
|
Modelo de e-mail
|
emailTemplate | string |
Selecione a campanha de email. |
Obter lista de desejos
Obter lista de desejos
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Intervalo de Tempo
|
since | True | string |
Especifique o número de dias que você deseja verificar se há listas de desejos atualizadas. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Results
|
Results | array of object |
Results |
|
CDPContactID
|
Results.CDPContactID | string |
CDPContactID |
|
UserID
|
Results.UserID | integer |
UserID |
|
WishListID
|
Results.WishListID | integer |
WishListID |
|
LastUpdated
|
Results.LastUpdated | string |
LastUpdated |
|
LanguageID
|
Results.LanguageID | integer |
LanguageID |
Obter modelos de email
Listar todos os modelos de email personalizados.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Message
|
Message | boolean |
Message |
|
Results
|
Results | integer |
Results |
Obter ordem para um contato
Verifique se um Contato fez um pedido.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID de contato
|
contactId | True | string |
Use a saída da ID de Contato com base no gatilho usado anteriormente. |
|
Desde
|
since | True | string |
Ponto no tempo em que ele verificará se um usuário fez um pedido. |
Verificar se o contato está na lista de supressão
Use esta ação para verificar se um contato está temporariamente na lista de supressão.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID de contato
|
contactId | True | string |
ID de contato cdp do usuário. |
|
Nome da Lista
|
listName | True | string |
Nome da lista de supressão. |
Verificar se o evento aconteceu
Verifique se o evento ocorreu para uma determinada ID de contato e por um determinado período de tempo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do Evento
|
eventName | string |
Selecione um evento disponível. |
|
|
ID de contato
|
contactId | string |
ID de contato cdp do usuário. |
|
|
Desde
|
since | string |
Ponto no tempo em que ele verificará posteriormente se um evento aconteceu. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Message
|
Message | boolean |
Message |
|
Results
|
Results | integer |
Results |
Gatilhos
| Quando um contato é adicionado a um segmento |
Use esse gatilho quando um novo Contato for adicionado a um segmento |
| Quando um novo evento acontece |
Use isso para selecionar um evento como um gatilho |
Quando um contato é adicionado a um segmento
Use esse gatilho quando um novo Contato for adicionado a um segmento
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Segmento
|
Id | True | string |
Use a ID do Segmento netvolution. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
NextSince
|
NextSince | string |
NextSince |
|
Results
|
Results | array of object |
Results |
|
ID
|
Results.ID | string |
ID |
|
CreatedDate
|
Results.CreatedDate | string |
CreatedDate |
|
Endereço de Email
|
Results.EmailAddress | string |
Endereço de Email |
|
eStoreSessionId
|
Results.eStoreSessionId | string |
eStoreSessionId |
|
Primeiro Nome
|
Results.FirstName | string |
Primeiro Nome |
|
LastName
|
Results.LastName | string |
LastName |
|
Data de Nascimento
|
Results.DateOfBirth | string |
Data de Nascimento |
|
Gênero
|
Results.Gender | string |
Gênero |
|
Anonimizado
|
Results.Anonymized | boolean |
Anonimizado |
|
Code
|
Results.MobilePhone.Code | string |
Code |
|
Número
|
Results.MobilePhone.Number | string |
Número |
|
Código do País
|
Results.MobilePhone.CountryCode | string |
Código do País |
|
Value
|
Results.ModifiedDate.Value | string |
Value |
|
IsAutocalculated
|
Results.ModifiedDate.IsAutocalculated | boolean |
IsAutocalculated |
|
Code
|
Results.Landline.Code | string |
Code |
|
Número
|
Results.Landline.Number | string |
Número |
|
Código do País
|
Results.Landline.CountryCode | string |
Código do País |
|
Rua
|
Results.Address.Street | string |
Rua |
|
City
|
Results.Address.City | string |
City |
|
ZipCode
|
Results.Address.ZipCode | string |
ZipCode |
|
Município
|
Results.Address.County | string |
Município |
|
País
|
Results.Address.Country | string |
País |
|
Localização
|
Results.Location | string |
Localização |
|
Segmentos
|
Results.Segments | array of object |
Segmentos |
|
SegmentID
|
Results.Segments.SegmentID | integer |
SegmentID |
|
MemberSince
|
Results.Segments.MemberSince | string |
MemberSince |
Quando um novo evento acontece
Use isso para selecionar um evento como um gatilho
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do Evento
|
eventName | True | string |
Selecione um evento disponível. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
NextSince
|
NextSince | string |
NextSince |
|
Results
|
Results | array of object |
Results |
|
LanguageID
|
Results.LanguageID | integer |
LanguageID |
|
LanguageName
|
Results.LanguageName | string |
LanguageName |
|
Nome do Evento
|
Results.EventName | string |
Nome do Evento |
|
Timestamp
|
Results.Timestamp | string |
Timestamp |
|
CDPContactID
|
Results.CDPContactID | string |
CDPContactID |
|
Família
|
Results.Browser.OS.Family | string |
Família |
|
Principal
|
Results.Browser.OS.Major | string |
Principal |
|
IsSpider
|
Results.Browser.Device.IsSpider | boolean |
IsSpider |
|
Família
|
Results.Browser.Device.Family | string |
Família |
|
Marca
|
Results.Browser.Device.Brand | string |
Marca |
|
Modelo
|
Results.Browser.Device.Model | string |
Modelo |
|
Família
|
Results.Browser.UserAgent.Family | string |
Família |
|
Principal
|
Results.Browser.UserAgent.Major | string |
Principal |
|
Menor
|
Results.Browser.UserAgent.Minor | string |
Menor |
|
Patch
|
Results.Browser.UserAgent.Patch | string |
Patch |
|
id
|
Results.List.id | string |
id |
|
nome
|
Results.List.name | string |
nome |
|
ItemParentId
|
Results.Product.ItemParentId | string |
ItemParentId |
|
Nome do Item
|
Results.Product.ItemName | string |
Nome do Item |
|
Categoria
|
Results.Product.Category | string |
Categoria |