Netvolution (Pré-visualização)

O Netvolution Connector permite que as empresas otimizem e automatizem suas campanhas de marketing por e-mail. Ele permite segmentação de e-mail direcionada, mensagens personalizadas e fluxos de trabalho automatizados com base no comportamento do usuário. Ao aproveitar o Netvolution, os profissionais de marketing podem aumentar o engajamento, melhorar a retenção de clientes e gerar conversões mais altas com o mínimo de esforço.

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes:      - Regiões do Azure Government      - Regiões do Azure China      - Departamento de Defesa dos EUA (DoD)
Aplicações Power	Premium	Todas as regiões do Power Apps , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Automatize o poder	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - 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
Editora	Atcom Sa
Sítio Web	https://www.atcom.gr/
Política de privacidade	https://www.atcom.gr/privacy-policy/
Categorias	Comércio; Comercialização

Conector Netvolution

Introdução

O Netvolution Connector permite projetar e automatizar atividades de e-mail marketing, incluindo o envio de e-mails de marketing para segmentos específicos e campanhas automatizadas com base em ações comportamentais. Este conector fornece um conjunto de ações para gerenciar e interagir com vários recursos dentro da plataforma Netvolution.

Pré-requisitos

Antes de poder usar o Netvolution Connector, você precisará:

• Uma implementação Netvolution.
• Credenciais da API (chave da API).

Introdução

Para utilizar o Netvolution Connector, siga estes passos:

1. Adicione o conector ao seu ambiente de plataforma de energia:

   • Navegue até o portal da Power Platform.
   • Vá para a seção "Conectores" e adicione um novo conector.
   • Procure por "Netvolution" e selecione-o.

2. Configure o conector:

   • Insira suas credenciais de API obtidas da plataforma Netvolution.
   • Introduza o seu endereço Netvolution (sem o prefixo https ).
   • Salve a configuração.

3. Use o conector em seus aplicativos e fluxos:

   • Adicione o conector aos seus fluxos Power Apps ou Power Automatic.
   • Use as ações disponíveis para interagir com os recursos Netvolution.

Operações suportadas

O Netvolution Connector suporta as seguintes operações:

• Obter modelos de e-mail

  • Método: GET
  • Caminho: /cdp/mail/list-templates
  • Descrição: Liste todos os modelos de e-mail 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 suportados: add_to_cart, view_page, view_item.

• Quando um contato é adicionado a um segmento

  • Método: GET
  • Caminho: /trigger/cdp/contacts/{Id}
  • Descrição: acionado quando um novo contato é adicionado a um segmento.

• Obter Encomenda para um Contacto

  • Método: GET
  • Caminho: /cdp/orders/{contactId}
  • Descrição: Verifique se um Contacto fez uma encomenda.

• Verifique 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 E-mail

  • Método: POST
  • Caminho: /cdp/mail/send
  • Descrição: esta ação aciona uma campanha de e-mail criada no Netvolution.

• Verifique se o evento aconteceu

  • Método: GET
  • Caminho: /cdp/events/checkevent
  • Descrição: Verifique se um evento aconteceu para um determinado ID de contato dentro de um período específico.

• Obter lista de desejos

  • Método: GET
  • Caminho: /cdp/wishlist/{since}
  • Descrição: Recuperar a lista de desejos atualizada dentro de um período de tempo especificado.

Definição de API

O conector usa a seguinte definição de API:

• Arquivo Swagger: apiDefinition.swagger.json
  • Este arquivo contém o esquema detalhado da API 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
  • Este arquivo contém várias definições de configuração para o conector.

Ícone

O ícone do conector está incluído no seguinte arquivo:

• Arquivo de ícone: icon.png
  • Este arquivo é usado como a representação visual do conector na interface Power Platform.

Problemas conhecidos e limitações

• Atualmente, o conector suporta operações básicas. Recursos avançados serão adicionados em versões futuras.
• Certifique-se de que suas credenciais de API estejam configuradas corretamente para evitar erros de autenticação.

Support

Para quaisquer problemas ou suporte, entre em contato com a equipe de suporte da Netvolution ou consulte a documentação oficial.

Licença

Este conector está licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter mais detalhes.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição	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.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
CHAVE DA API	securestring	A CHAVE para esta API
Nome do host Netvolution	cadeia (de caracteres)	Netvolution Hostname (exemplo: yourdomain.netvolution.net).	Verdade

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	100	60 segundos

Ações

Colocar Contato na lista de supressão	Colocar Contato na lista de supressão
Enviar E-mail	Esta ação aciona a campanha de e-mail criada no Netvolution.
Obter Encomenda para um Contacto	Verifique se um Contacto fez uma encomenda.
Obter lista de desejos	Obter lista de desejos
Obter modelos de e-mail	Liste todos os modelos de e-mail personalizados.
Verifique 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.
Verifique se o evento aconteceu	Verifique se o evento aconteceu para um determinado ID de contato e por um determinado período de tempo.

Colocar Contato na lista de supressão

ID da Operação:

PutContactIDToSuppresionList

Colocar Contato na lista de supressão

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID de contato	contactId	True	string	Use a saída para ID de contato com base no gatilho usado anteriormente.
Nome da lista de supressão	listName	True	string	Nome da lista de supressão.
Período de tempo	timeSpan	True	string	Especifique o número de dias que o ID de contato permanecerá na Lista de Supressão desta campanha.

Enviar E-mail

ID da Operação:

SendMail

Esta ação aciona a campanha de e-mail criada no Netvolution.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID de contato	cdpContactId		string	CDP Contact Id do usuário.
ID do idioma	languageId		string	ID do idioma conforme especificado no site netvolution.
Modelo de e-mail	emailTemplate		string	Selecione a campanha de e-mail.

Obter Encomenda para um Contacto

ID da Operação:

GetOrder

Verifique se um Contacto fez uma encomenda.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID de contato	contactId	True	string	Use a saída para ID de contato com base no gatilho usado anteriormente.
Uma vez que	since	True	string	Ponto no tempo onde irá verificar se um utilizador fez uma encomenda.

Obter lista de desejos

ID da Operação:

GetWishList

Obter lista de desejos

Parâmetros

Name	Chave	Necessário	Tipo	Description
Período de tempo	since	True	string	Especifique o número de dias que deseja verificar se há listas de desejos atualizadas.

Devoluções

Name	Caminho	Tipo	Description
Results	Results	array of object	Results
CDPContactID	Results.CDPContactID	string	CDPContactID
ID de utilizador	Results.UserID	integer	ID de utilizador
WishListID	Results.WishListID	integer	WishListID
Última atualização	Results.LastUpdated	string	Última atualização
ID do idioma	Results.LanguageID	integer	ID do idioma

Obter modelos de e-mail

ID da Operação:

GetEmailTemplates

Liste todos os modelos de e-mail personalizados.

Devoluções

Name	Caminho	Tipo	Description
Message	Message	boolean	Message
Results	Results	integer	Results

Verifique se o contato está na lista de supressão

ID da Operação:

GetContactIDFromSuppressionList

Use esta ação para verificar se um contato está temporariamente na lista de supressão.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID de contato	contactId	True	string	CDP Contact Id do usuário.
Nome da lista	listName	True	string	Nome da lista de supressão.

Verifique se o evento aconteceu

ID da Operação:

CheckEvent

Verifique se o evento aconteceu para um determinado ID de contato e por um determinado período de tempo.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Nome do Evento	eventName		string	Selecione um evento disponível.
ID de contato	contactId		string	CDP Contact Id do usuário.
Uma vez que	since		string	Ponto no tempo em que irá verificar posteriormente se um evento aconteceu.

Devoluções

Name	Caminho	Tipo	Description
Message	Message	boolean	Message
Results	Results	integer	Results

Acionadores

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

ID da Operação:

OnNewUserInSegment

Use esse gatilho quando um novo contato for adicionado a um segmento

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do Segmento	Id	True	string	Use o ID do segmento Netvolution.

Devoluções

Name	Caminho	Tipo	Description
PróximoDesde	NextSince	string	PróximoDesde
Results	Results	array of object	Results
ID	Results.ID	string	ID
Data de Criação	Results.CreatedDate	string	Data de Criação
Endereço de Email	Results.EmailAddress	string	Endereço de Email
eStoreSessionId	Results.eStoreSessionId	string	eStoreSessionId
Primeiro Nome	Results.FirstName	string	Primeiro Nome
Apelido	Results.LastName	string	Apelido
Data de Nascimento	Results.DateOfBirth	string	Data de Nascimento
Sexo	Results.Gender	string	Sexo
Anonimizado	Results.Anonymized	boolean	Anonimizado
Código	Results.MobilePhone.Code	string	Código
Número	Results.MobilePhone.Number	string	Número
Código de País	Results.MobilePhone.CountryCode	string	Código de País
Valor	Results.ModifiedDate.Value	string	Valor
IsAutocalculated	Results.ModifiedDate.IsAutocalculated	boolean	IsAutocalculated
Código	Results.Landline.Code	string	Código
Número	Results.Landline.Number	string	Número
Código de País	Results.Landline.CountryCode	string	Código de País
Rua	Results.Address.Street	string	Rua
City	Results.Address.City	string	City
CEP	Results.Address.ZipCode	string	CEP
Concelho	Results.Address.County	string	Concelho
Country	Results.Address.Country	string	Country
Localização	Results.Location	string	Localização
Segmentos	Results.Segments	array of object	Segmentos
ID do Segmento	Results.Segments.SegmentID	integer	ID do Segmento
MembroDesde	Results.Segments.MemberSince	string	MembroDesde

Quando um novo evento acontece

ID da Operação:

OnNewEvent

Use isso para selecionar um evento como um gatilho

Parâmetros

Name	Chave	Necessário	Tipo	Description
Nome do Evento	eventName	True	string	Selecione um evento disponível.

Devoluções

Name	Caminho	Tipo	Description
PróximoDesde	NextSince	string	PróximoDesde
Results	Results	array of object	Results
ID do idioma	Results.LanguageID	integer	ID do idioma
LanguageName	Results.LanguageName	string	LanguageName
Nome do Evento	Results.EventName	string	Nome do Evento
Data e Hora	Results.Timestamp	string	Data e Hora
CDPContactID	Results.CDPContactID	string	CDPContactID
Família	Results.Browser.OS.Family	string	Família
Maior	Results.Browser.OS.Major	string	Maior
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
Maior	Results.Browser.UserAgent.Major	string	Maior
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