Compartilhar via


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:

  1. 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.
  2. Configure o Conector:

    • Insira suas credenciais de API obtidas da plataforma Netvolution.
    • Insira seu endereço Netvolution (sem o https prefixo).
    • Salve a configuração.
  3. 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