Share via


Netvolution (Preview)

The Netvolution Connector empowers businesses to streamline and automate their email marketing campaigns. It enables targeted email segmentation, personalized messaging, and automated workflows based on user behavior. By leveraging Netvolution, marketers can enhance engagement, improve customer retention, and drive higher conversions with minimal effort.

This connector is available in the following products and regions:

Service Class Regions
Copilot Studio Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Atcom SA
URL https://www.atcom.gr
Connector Metadata
Publisher Atcom S.A
Website https://www.atcom.gr/
Privacy policy https://www.atcom.gr/privacy-policy/
Categories Commerce;Marketing

Netvolution Connector

Introduction

The Netvolution Connector allows you to design and automate email marketing activities, including sending marketing emails to specific segments and automated campaigns based on behavioral actions. This connector provides a set of actions to manage and interact with various resources within the Netvolution platform.

Prerequisites

Before you can use the Netvolution Connector, you will need:

  • A Netvolution implementation.
  • API credentials (API key).

Getting Started

To use the Netvolution Connector, follow these steps:

  1. Add the Connector to Your Power Platform Environment:

    • Navigate to the Power Platform portal.
    • Go to the "Connectors" section and add a new connector.
    • Search for "Netvolution" and select it.
  2. Configure the Connector:

    • Enter your API credentials obtained from the Netvolution platform.
    • Enter your Netvolution address (without the https prefix).
    • Save the configuration.
  3. Use the Connector in Your Apps and Flows:

    • Add the connector to your Power Apps or Power Automate flows.
    • Use the available actions to interact with the Netvolution resources.

Supported Operations

The Netvolution Connector supports the following operations:

  • Get Email Templates

    • Method: GET
    • Path: /cdp/mail/list-templates
    • Description: List all custom email templates.
  • When a New Event Happens

    • Method: GET
    • Path: /trigger/cdp/events/{eventName}
    • Description: Use this to select an event as a trigger. Supported events: add_to_cart, view_page, view_item.
  • When a Contact is Added to a Segment

    • Method: GET
    • Path: /trigger/cdp/contacts/{Id}
    • Description: Triggered when a new Contact is added to a segment.
  • Get Order for a Contact

    • Method: GET
    • Path: /cdp/orders/{contactId}
    • Description: Check if a Contact has made an order.
  • Check if Contact is in Suppression List

    • Method: GET
    • Path: /cdp/suppression/check
    • Description: Check if a contact is temporarily in the suppression list.
  • Put Contact to Suppression List

    • Method: PUT
    • Path: /cdp/suppression/add
    • Description: Add a contact to the suppression list for a specified duration.
  • Send Email

    • Method: POST
    • Path: /cdp/mail/send
    • Description: This action triggers an email campaign created in Netvolution.
  • Check if Event Happened

    • Method: GET
    • Path: /cdp/events/checkevent
    • Description: Check if an event happened for a certain contact ID within a specific period.
  • Get Wish List

    • Method: GET
    • Path: /cdp/wishlist/{since}
    • Description: Retrieve the wish list updated within a specified timeframe.

API Definition

The connector uses the following API definition:

  • Swagger File: apiDefinition.swagger.json
    • This file contains the detailed API schema and endpoints used by the connector.

Settings

The connector settings are defined in the following file:

  • Settings File: settings.json
    • This file contains various configuration settings for the connector.

Icon

The connector icon is included in the following file:

  • Icon File: icon.png
    • This file is used as the visual representation of the connector in the Power Platform interface.

Known Issues and Limitations

  • Currently, the connector supports basic operations. Advanced features will be added in future releases.
  • Ensure that your API credentials are correctly configured to avoid authentication errors.

Support

For any issues or support, please contact the Netvolution support team or refer to the official documentation.

License

This connector is licensed under the MIT License. See the LICENSE file for more details.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API KEY securestring The KEY for this API
Netvolution Hostname string Netvolution Hostname (Example: yourdomain.netvolution.net). True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Check if Contact is in Suppression List

Use this action to check if a contact is temporarily in suppression list.

Check if event happened

Check if event happened for a certain contact id and for a certain period of time.

Get Email Templates

List all custom email templates.

Get Order for a Contact

Check if a Contact has made an order.

Get Wish List

Get Wish List

Put Contact to suppression list

Put Contact to suppression list

Send Email

This action triggers the email campaign created in Netvolution.

Check if Contact is in Suppression List

Use this action to check if a contact is temporarily in suppression list.

Parameters

Name Key Required Type Description
Contact ID
contactId True string

CDP Contact Id of the user.

List Name
listName True string

Name of the suppression list.

Returns

Check if event happened

Check if event happened for a certain contact id and for a certain period of time.

Parameters

Name Key Required Type Description
Event Name
eventName string

Select an available event.

Contact ID
contactId string

CDP Contact Id of the user.

Since
since string

Point in time where it will check afterwards if an event happened.

Returns

Name Path Type Description
Message
Message boolean

Message

Results
Results integer

Results

Get Email Templates

List all custom email templates.

Returns

Name Path Type Description
Message
Message boolean

Message

Results
Results integer

Results

Get Order for a Contact

Check if a Contact has made an order.

Parameters

Name Key Required Type Description
Contact ID
contactId True string

Use the output for Contact ID based on your previously used trigger.

Since
since True string

Point in time where it will check if a user has put an order.

Returns

Get Wish List

Get Wish List

Parameters

Name Key Required Type Description
Time Span
since True string

Specify the number of the days you want to check for updated wish lists.

Returns

Name Path Type 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

Put Contact to suppression list

Put Contact to suppression list

Parameters

Name Key Required Type Description
Contact ID
contactId True string

Use the output for Contact ID based on your previously used trigger.

Suppression List Name
listName True string

Name of the suppression list.

Time Span
timeSpan True string

Specify the number of the days the Contact ID will stay in the Suppression List for this campaign.

Returns

Send Email

This action triggers the email campaign created in Netvolution.

Parameters

Name Key Required Type Description
Contact ID
cdpContactId string

CDP Contact Id of the user.

Language ID
languageId string

Language id as specified in netvolution site.

Email Template
emailTemplate string

Select the email campaign.

Returns

Triggers

When a Contact is added to a segment

Use this a trigger when a new Contact is added to a segment

When a new event happens

Use this to select an event as a trigger

When a Contact is added to a segment

Use this a trigger when a new Contact is added to a segment

Parameters

Name Key Required Type Description
Segment ID
Id True string

Use the Netvolution Segment ID.

Returns

Name Path Type Description
NextSince
NextSince string

NextSince

Results
Results array of object

Results

ID
Results.ID string

ID

CreatedDate
Results.CreatedDate string

CreatedDate

EmailAddress
Results.EmailAddress string

EmailAddress

eStoreSessionId
Results.eStoreSessionId string

eStoreSessionId

FirstName
Results.FirstName string

FirstName

LastName
Results.LastName string

LastName

DateOfBirth
Results.DateOfBirth string

DateOfBirth

Gender
Results.Gender string

Gender

Anonymized
Results.Anonymized boolean

Anonymized

Code
Results.MobilePhone.Code string

Code

Number
Results.MobilePhone.Number string

Number

CountryCode
Results.MobilePhone.CountryCode string

CountryCode

Value
Results.ModifiedDate.Value string

Value

IsAutocalculated
Results.ModifiedDate.IsAutocalculated boolean

IsAutocalculated

Code
Results.Landline.Code string

Code

Number
Results.Landline.Number string

Number

CountryCode
Results.Landline.CountryCode string

CountryCode

Street
Results.Address.Street string

Street

City
Results.Address.City string

City

ZipCode
Results.Address.ZipCode string

ZipCode

County
Results.Address.County string

County

Country
Results.Address.Country string

Country

Location
Results.Location string

Location

Segments
Results.Segments array of object

Segments

SegmentID
Results.Segments.SegmentID integer

SegmentID

MemberSince
Results.Segments.MemberSince string

MemberSince

When a new event happens

Use this to select an event as a trigger

Parameters

Name Key Required Type Description
Event Name
eventName True string

Select an available event.

Returns

Name Path Type Description
NextSince
NextSince string

NextSince

Results
Results array of object

Results

LanguageID
Results.LanguageID integer

LanguageID

LanguageName
Results.LanguageName string

LanguageName

EventName
Results.EventName string

EventName

Timestamp
Results.Timestamp string

Timestamp

CDPContactID
Results.CDPContactID string

CDPContactID

Family
Results.Browser.OS.Family string

Family

Major
Results.Browser.OS.Major string

Major

IsSpider
Results.Browser.Device.IsSpider boolean

IsSpider

Family
Results.Browser.Device.Family string

Family

Brand
Results.Browser.Device.Brand string

Brand

Model
Results.Browser.Device.Model string

Model

Family
Results.Browser.UserAgent.Family string

Family

Major
Results.Browser.UserAgent.Major string

Major

Minor
Results.Browser.UserAgent.Minor string

Minor

Patch
Results.Browser.UserAgent.Patch string

Patch

id
Results.List.id string

id

name
Results.List.name string

name

ItemParentId
Results.Product.ItemParentId string

ItemParentId

ItemName
Results.Product.ItemName string

ItemName

Category
Results.Product.Category string

Category