Netvolution (preview)

De Netvolution Connector stelt bedrijven in staat om hun e-mailmarketingcampagnes te stroomlijnen en automatiseren. Het maakt gerichte e-mailsegmentatie, gepersonaliseerde berichten en geautomatiseerde werkstromen mogelijk op basis van gebruikersgedrag. Door gebruik te maken van Netvolution kunnen marketeers de betrokkenheid verbeteren, de retentie van klanten verbeteren en hogere conversies stimuleren met minimale inspanning.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst	Class	Regions
Copilot Studio	Premium	Alle Power Automate-regio's , met uitzondering van het volgende:      - Amerikaanse overheid (GCC)      - Amerikaanse overheid (GCC High)      - China Cloud beheerd door 21Vianet      - Us Department of Defense (DoD)
Logic-apps	Standaard	Alle Logic Apps-regio's , met uitzondering van het volgende:      - Azure Government-regio's      - Azure China-regio's      - Us Department of Defense (DoD)
Power Apps	Premium	Alle Power Apps-regio's , met uitzondering van het volgende:      - Amerikaanse overheid (GCC)      - Amerikaanse overheid (GCC High)      - China Cloud beheerd door 21Vianet      - Us Department of Defense (DoD)
Power Automate	Premium	Alle Power Automate-regio's , met uitzondering van het volgende:      - Amerikaanse overheid (GCC)      - Amerikaanse overheid (GCC High)      - China Cloud beheerd door 21Vianet      - Us Department of Defense (DoD)

Contactpersoon
Naam	Atcom SA
URL	https://www.atcom.gr

Connector-metagegevens
Uitgever	Atcom S.A
Webpagina	https://www.atcom.gr/
Privacybeleid	https://www.atcom.gr/privacy-policy/
Categorieën	Handel; Marketing

Netvolution-connector

Introductie

Met de Netvolution Connector kunt u marketingactiviteiten voor e-mail ontwerpen en automatiseren, waaronder het verzenden van marketingmails naar specifieke segmenten en geautomatiseerde campagnes op basis van gedragsacties. Deze connector biedt een set acties voor het beheren en communiceren met verschillende resources binnen het Netvolution-platform.

Vereiste voorwaarden

Voordat u de Netvolution-connector kunt gebruiken, hebt u het volgende nodig:

• Een Netvolution-implementatie.
• API-referenties (API-sleutel).

Aan de slag komen

Voer de volgende stappen uit om de Netvolution-connector te gebruiken:

1. Voeg de connector toe aan uw Power Platform-omgeving:

   • Navigeer naar de Power Platform-portal.
   • Ga naar de sectie Connectors en voeg een nieuwe connector toe.
   • Zoek naar 'Netvolution' en selecteer deze.

2. De connector configureren:

   • Voer uw API-referenties in die zijn verkregen via het Netvolution-platform.
   • Voer uw Netvolution-adres in (zonder het https voorvoegsel).
   • Sla de configuratie op.

3. Gebruik de connector in uw apps en stromen:

   • Voeg de connector toe aan uw Power Apps- of Power Automate-stromen.
   • Gebruik de beschikbare acties om te communiceren met de Netvolution-resources.

Ondersteunde bewerkingen

De Netvolution Connector ondersteunt de volgende bewerkingen:

• E-mailsjablonen ophalen

  • Methode : GET
  • Pad: /cdp/mail/list-templates
  • Beschrijving: Alle aangepaste e-mailsjablonen weergeven.

• Wanneer een nieuwe gebeurtenis plaatsvindt

  • Methode : GET
  • Pad: /trigger/cdp/events/{eventName}
  • Beschrijving: Gebruik deze optie om een gebeurtenis als trigger te selecteren. Ondersteunde gebeurtenissen: add_to_cart, view_page, view_item.

• Wanneer een contactpersoon wordt toegevoegd aan een segment

  • Methode : GET
  • Pad: /trigger/cdp/contacts/{Id}
  • Beschrijving: Geactiveerd wanneer een nieuwe contactpersoon wordt toegevoegd aan een segment.

• Bestelling voor een contactpersoon ophalen

  • Methode : GET
  • Pad: /cdp/orders/{contactId}
  • Beschrijving: Controleer of een contactpersoon een bestelling heeft gemaakt.

• Controleren of de contactpersoon in de onderdrukkingslijst staat

  • Methode : GET
  • Pad: /cdp/suppression/check
  • Beschrijving: Controleer of een contactpersoon tijdelijk in de onderdrukkingslijst staat.

• Contact opnemen in onderdrukkingslijst plaatsen

  • Methode : PUT
  • Pad: /cdp/suppression/add
  • Beschrijving: Voeg een contactpersoon toe aan de onderdrukkingslijst voor een opgegeven duur.

• Stuur e-mail

  • methode: POST
  • Pad: /cdp/mail/send
  • Beschrijving: Met deze actie wordt een e-mailcampagne geactiveerd die is gemaakt in Netvolution.

• Controleren of er een gebeurtenis is opgetreden

  • Methode : GET
  • Pad: /cdp/events/checkevent
  • Beschrijving: Controleer of er binnen een bepaalde periode een gebeurtenis is opgetreden voor een bepaalde contact-id.

• Wenslijst ophalen

  • Methode : GET
  • Pad: /cdp/wishlist/{since}
  • Beschrijving: Haal de wenslijst op die binnen een opgegeven periode is bijgewerkt.

API-definitie

De connector maakt gebruik van de volgende API-definitie:

• Swagger-bestand: apiDefinition.swagger.json
  • Dit bestand bevat het gedetailleerde API-schema en de eindpunten die door de connector worden gebruikt.

Instellingen

De connectorinstellingen worden gedefinieerd in het volgende bestand:

• Instellingenbestand: settings.json
  • Dit bestand bevat verschillende configuratie-instellingen voor de connector.

Icon

Het connectorpictogram is opgenomen in het volgende bestand:

• Pictogrambestand: icon.png
  • Dit bestand wordt gebruikt als de visuele weergave van de connector in de Power Platform-interface.

Bekende problemen en beperkingen

• Momenteel ondersteunt de connector basisbewerkingen. In toekomstige versies worden geavanceerde functies toegevoegd.
• Zorg ervoor dat uw API-referenties correct zijn geconfigureerd om verificatiefouten te voorkomen.

Support

Neem voor eventuele problemen of ondersteuning contact op met het ondersteuningsteam van Netvolution of raadpleeg de officiële documentatie.

Licentie

Deze connector is gelicentieerd onder de MIT-licentie. Zie het LICENSE-bestand voor meer informatie.

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:

standaard	Parameters voor het maken van verbinding.	Alle regio's	Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam	Typologie	Description	Verplicht
API-SLEUTEL	beveiligde string	De SLEUTEL voor deze API
Netvolution Hostname	touw	Netvolution Hostname (voorbeeld: yourdomain.netvolution.net).	Klopt

Beperkingslimieten

Name	Aanroepen	Verlengingsperiode
API-aanroepen per verbinding	100	60 seconden

Acties

Bestelling voor een contactpersoon ophalen	Controleer of een contactpersoon een bestelling heeft gemaakt.
Contact opnemen in onderdrukkingslijst plaatsen	Contact opnemen in onderdrukkingslijst plaatsen
Controleren of de contactpersoon in de onderdrukkingslijst staat	Gebruik deze actie om te controleren of een contactpersoon tijdelijk in de onderdrukkingslijst staat.
Controleren of er een gebeurtenis is opgetreden	Controleer of de gebeurtenis is opgetreden voor een bepaalde contactpersoon-id en gedurende een bepaalde periode.
E-mailbericht verzenden	Met deze actie wordt de e-mailcampagne geactiveerd die is gemaakt in Netvolution.
E-mailsjablonen ophalen	Geef alle aangepaste e-mailsjablonen weer.
Wenslijst ophalen	Wenslijst ophalen

Bestelling voor een contactpersoon ophalen

Bewerkings-id:

GetOrder

Controleer of een contactpersoon een bestelling heeft gemaakt.

Parameters

Name	Sleutel	Vereist	Type	Description
Contactpersoon-id	contactId	True	string	Gebruik de uitvoer voor contactpersoon-id op basis van uw eerder gebruikte trigger.
Sinds	since	True	string	Tijdstip waarop wordt gecontroleerd of een gebruiker een bestelling heeft geplaatst.

Contact opnemen in onderdrukkingslijst plaatsen

Bewerkings-id:

PutContactIDToSuppresionList

Contact opnemen in onderdrukkingslijst plaatsen

Parameters

Name	Sleutel	Vereist	Type	Description
Contactpersoon-id	contactId	True	string	Gebruik de uitvoer voor contactpersoon-id op basis van uw eerder gebruikte trigger.
Naam van onderdrukkingslijst	listName	True	string	Naam van de onderdrukkingslijst.
Tijdspanne	timeSpan	True	string	Geef het aantal dagen op dat de contact-id in de onderdrukkingslijst voor deze campagne blijft staan.

Controleren of de contactpersoon in de onderdrukkingslijst staat

Bewerkings-id:

GetContactIDFromSuppressionList

Gebruik deze actie om te controleren of een contactpersoon tijdelijk in de onderdrukkingslijst staat.

Parameters

Name	Sleutel	Vereist	Type	Description
Contactpersoon-id	contactId	True	string	CDP Contact Id van de gebruiker.
Lijstnaam	listName	True	string	Naam van de onderdrukkingslijst.

Controleren of er een gebeurtenis is opgetreden

Bewerkings-id:

CheckEvent

Controleer of de gebeurtenis is opgetreden voor een bepaalde contactpersoon-id en gedurende een bepaalde periode.

Parameters

Name	Sleutel	Vereist	Type	Description
Gebeurtenisnaam	eventName		string	Selecteer een beschikbare gebeurtenis.
Contactpersoon-id	contactId		string	CDP Contact Id van de gebruiker.
Sinds	since		string	Tijdstip waarop deze later wordt gecontroleerd of er een gebeurtenis is opgetreden.

Retouren

Name	Pad	Type	Description
Message	Message	boolean	Message
Results	Results	integer	Results

E-mailbericht verzenden

Bewerkings-id:

SendMail

Met deze actie wordt de e-mailcampagne geactiveerd die is gemaakt in Netvolution.

Parameters

Name	Sleutel	Vereist	Type	Description
Contactpersoon-id	cdpContactId		string	CDP Contact Id van de gebruiker.
Taal-id	languageId		string	Taal-id zoals opgegeven in netvolution-site.
E-mail sjabloon	emailTemplate		string	Selecteer de e-mailcampagne.

E-mailsjablonen ophalen

Bewerkings-id:

GetEmailTemplates

Geef alle aangepaste e-mailsjablonen weer.

Retouren

Name	Pad	Type	Description
Message	Message	boolean	Message
Results	Results	integer	Results

Wenslijst ophalen

Bewerkings-id:

GetWishList

Wenslijst ophalen

Parameters

Name	Sleutel	Vereist	Type	Description
Tijdspanne	since	True	string	Geef het aantal dagen op dat u wilt controleren op bijgewerkte wenslijsten.

Retouren

Name	Pad	Type	Description
Results	Results	array of object	Results
CDPContactID	Results.CDPContactID	string	CDPContactID
Gebruikers-ID	Results.UserID	integer	Gebruikers-ID
WishListID	Results.WishListID	integer	WishListID
LastUpdated	Results.LastUpdated	string	LastUpdated
LanguageID	Results.LanguageID	integer	LanguageID

Triggers

Wanneer een contactpersoon wordt toegevoegd aan een segment	Gebruik deze trigger wanneer een nieuwe contactpersoon wordt toegevoegd aan een segment
Wanneer er een nieuwe gebeurtenis plaatsvindt	Gebruik deze optie om een gebeurtenis te selecteren als trigger

Wanneer een contactpersoon wordt toegevoegd aan een segment

Bewerkings-id:

OnNewUserInSegment

Gebruik deze trigger wanneer een nieuwe contactpersoon wordt toegevoegd aan een segment

Parameters

Name	Sleutel	Vereist	Type	Description
Segment-id	Id	True	string	Gebruik de Netvolution-segment-id.

Retouren

Name	Pad	Type	Description
NextSince	NextSince	string	NextSince
Results	Results	array of object	Results
ID-kaart	Results.ID	string	ID-kaart
CreatedDate	Results.CreatedDate	string	CreatedDate
E-mailadres	Results.EmailAddress	string	E-mailadres
eStoreSessionId	Results.eStoreSessionId	string	eStoreSessionId
Voornaam	Results.FirstName	string	Voornaam
Achternaam	Results.LastName	string	Achternaam
Geboortedatum	Results.DateOfBirth	string	Geboortedatum
Geslacht	Results.Gender	string	Geslacht
Geanonimiseerd	Results.Anonymized	boolean	Geanonimiseerd
Code	Results.MobilePhone.Code	string	Code
Number	Results.MobilePhone.Number	string	Number
CountryCode	Results.MobilePhone.CountryCode	string	CountryCode
Waarde	Results.ModifiedDate.Value	string	Waarde
IsAutocalculated	Results.ModifiedDate.IsAutocalculated	boolean	IsAutocalculated
Code	Results.Landline.Code	string	Code
Number	Results.Landline.Number	string	Number
CountryCode	Results.Landline.CountryCode	string	CountryCode
Adres	Results.Address.Street	string	Adres
City	Results.Address.City	string	City
Postcode	Results.Address.ZipCode	string	Postcode
Provincie	Results.Address.County	string	Provincie
Country	Results.Address.Country	string	Country
Locatie	Results.Location	string	Locatie
Segmenten	Results.Segments	array of object	Segmenten
SegmentID	Results.Segments.SegmentID	integer	SegmentID
MemberSince	Results.Segments.MemberSince	string	MemberSince

Wanneer er een nieuwe gebeurtenis plaatsvindt

Bewerkings-id:

OnNewEvent

Gebruik deze optie om een gebeurtenis te selecteren als trigger

Parameters

Name	Sleutel	Vereist	Type	Description
Gebeurtenisnaam	eventName	True	string	Selecteer een beschikbare gebeurtenis.

Retouren

Name	Pad	Type	Description
NextSince	NextSince	string	NextSince
Results	Results	array of object	Results
LanguageID	Results.LanguageID	integer	LanguageID
LanguageName	Results.LanguageName	string	LanguageName
Naam van het evenement	Results.EventName	string	Naam van het evenement
Tijdstempel	Results.Timestamp	string	Tijdstempel
CDPContactID	Results.CDPContactID	string	CDPContactID
Familie	Results.Browser.OS.Family	string	Familie
Majoor	Results.Browser.OS.Major	string	Majoor
IsSpider	Results.Browser.Device.IsSpider	boolean	IsSpider
Familie	Results.Browser.Device.Family	string	Familie
Merk	Results.Browser.Device.Brand	string	Merk
Model	Results.Browser.Device.Model	string	Model
Familie	Results.Browser.UserAgent.Family	string	Familie
Majoor	Results.Browser.UserAgent.Major	string	Majoor
Minderjarige	Results.Browser.UserAgent.Minor	string	Minderjarige
Patch	Results.Browser.UserAgent.Patch	string	Patch
identiteitskaart	Results.List.id	string	identiteitskaart
naam	Results.List.name	string	naam
ItemParentId	Results.Product.ItemParentId	string	ItemParentId
ItemNaam	Results.Product.ItemName	string	ItemNaam
Categorie	Results.Product.Category	string	Categorie