Netvolution (Vorschau)

Der Netvolution Connector ermöglicht Unternehmen, ihre E-Mail-Marketingkampagnen zu optimieren und zu automatisieren. Sie ermöglicht gezielte E-Mail-Segmentierung, personalisiertes Messaging und automatisierte Workflows basierend auf dem Benutzerverhalten. Durch die Nutzung von Netvolution können Vermarkter das Engagement verbessern, die Kundenbindung verbessern und höhere Konvertierungen mit minimalem Aufwand fördern.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung	Class	Regions
Copilot Studio	Premium	Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:      - US Government (GCC)      - US Government (GCC High)      - China Cloud betrieben von 21Vianet      - US Department of Defense (DoD)
Logik-Apps	Norm	Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:      – Azure Government-Regionen      - Azure China-Regionen      - US Department of Defense (DoD)
Power Apps	Premium	Alle Power Apps-Regionen mit Ausnahme der folgenden:      - US Government (GCC)      - US Government (GCC High)      - China Cloud betrieben von 21Vianet      - US Department of Defense (DoD)
Power Automate	Premium	Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:      - US Government (GCC)      - US Government (GCC High)      - China Cloud betrieben von 21Vianet      - US Department of Defense (DoD)

Kontakt
Name	Atcom SA
URL	https://www.atcom.gr

Connectormetadaten
Herausgeber	Atcom S.A
Webseite	https://www.atcom.gr/
Datenschutzrichtlinie	https://www.atcom.gr/privacy-policy/
Kategorien	Handel; Marketing

Netvolution Connector

Einleitung

Mit dem Netvolution Connector können Sie E-Mail-Marketingaktivitäten entwerfen und automatisieren, einschließlich des Sendens von Marketing-E-Mails an bestimmte Segmente und automatisierte Kampagnen basierend auf Verhaltensaktionen. Dieser Connector bietet eine Reihe von Aktionen zum Verwalten und Interagieren mit verschiedenen Ressourcen innerhalb der Netvolution-Plattform.

Voraussetzungen

Bevor Sie den Netvolution Connector verwenden können, benötigen Sie Folgendes:

• Eine Netvolution-Implementierung.
• API-Anmeldeinformationen (API-Schlüssel).

Erste Schritte

Führen Sie die folgenden Schritte aus, um den Netvolution Connector zu verwenden:

1. Fügen Sie den Connector zu Ihrer Power Platform-Umgebung hinzu:

   • Navigieren Sie zum Power Platform-Portal.
   • Wechseln Sie zum Abschnitt "Connectors", und fügen Sie einen neuen Connector hinzu.
   • Suchen Sie nach "Netvolution", und wählen Sie es aus.

2. Konnektor konfigurieren:

   • Geben Sie Ihre API-Anmeldeinformationen ein, die von der Netvolution-Plattform abgerufen wurden.
   • Geben Sie Ihre Netvolution-Adresse (ohne präfix) ein https .
   • Speichern Sie die Konfiguration.

3. Verwenden Sie den Connector in Ihren Apps und Flüssen:

   • Fügen Sie den Connector zu Ihren Power Apps oder Power Automate-Flüssen hinzu.
   • Verwenden Sie die verfügbaren Aktionen, um mit den Netvolution-Ressourcen zu interagieren.

Unterstützte Vorgänge

Der Netvolution Connector unterstützt die folgenden Vorgänge:

• Abrufen von E-Mail-Vorlagen

  • Methode: GET
  • Pfad: /cdp/mail/list-templates
  • Beschreibung: Auflisten aller benutzerdefinierten E-Mail-Vorlagen.

• Wenn ein neues Ereignis auftritt

  • Methode: GET
  • Pfad: /trigger/cdp/events/{eventName}
  • Beschreibung: Verwenden Sie diese Option, um ein Ereignis als Trigger auszuwählen. Unterstützte Ereignisse: add_to_cart, view_page, view_item.

• Wenn ein Kontakt zu einem Segment hinzugefügt wird

  • Methode: GET
  • Pfad: /trigger/cdp/contacts/{Id}
  • Beschreibung: Wird ausgelöst, wenn einem Segment ein neuer Kontakt hinzugefügt wird.

• Bestellung für einen Kontakt abrufen

  • Methode: GET
  • Pfad: /cdp/orders/{contactId}
  • Beschreibung: Überprüfen Sie, ob ein Kontakt eine Bestellung vorgenommen hat.

• Überprüfen, ob sich der Kontakt in der Unterdrückungsliste befindet

  • Methode: GET
  • Pfad: /cdp/suppression/check
  • Beschreibung: Überprüfen Sie, ob sich ein Kontakt vorübergehend in der Unterdrückungsliste befindet.

• Kontakt zur Unterdrückungsliste einfügen

  • Methode: PUT
  • Pfad: /cdp/suppression/add
  • Beschreibung: Hinzufügen eines Kontakts zur Unterdrückungsliste für eine bestimmte Dauer.

• E-Mail senden

  • Methode: POST
  • Pfad: /cdp/mail/send
  • Beschreibung: Diese Aktion löst eine in Netvolution erstellte E-Mail-Kampagne aus.

• Überprüfen, ob das Ereignis aufgetreten ist

  • Methode: GET
  • Pfad: /cdp/events/checkevent
  • Beschreibung: Überprüfen Sie, ob innerhalb eines bestimmten Zeitraums ein Ereignis für eine bestimmte Kontakt-ID aufgetreten ist.

• Wunschliste abrufen

  • Methode: GET
  • Pfad: /cdp/wishlist/{since}
  • Beschreibung: Abrufen der Wunschliste, die innerhalb eines angegebenen Zeitrahmens aktualisiert wurde.

API-Definition

Der Connector verwendet die folgende API-Definition:

• Swagger Datei: apiDefinition.swagger.json
  • Diese Datei enthält das detaillierte API-Schema und die vom Connector verwendeten Endpunkte.

Einstellungen

Die Connectoreinstellungen sind in der folgenden Datei definiert:

• Einstellungsdatei: settings.json
  • Diese Datei enthält verschiedene Konfigurationseinstellungen für den Connector.

Ikone

Das Connectorsymbol ist in der folgenden Datei enthalten:

• Symboldatei: icon.png
  • Diese Datei wird als visuelle Darstellung des Connectors in der Power Platform-Schnittstelle verwendet.

Bekannte Probleme und Einschränkungen

• Derzeit unterstützt der Connector grundlegende Vorgänge. Erweiterte Features werden in zukünftigen Versionen hinzugefügt.
• Stellen Sie sicher, dass Ihre API-Anmeldeinformationen ordnungsgemäß konfiguriert sind, um Authentifizierungsfehler zu vermeiden.

Support

Für Probleme oder Support wenden Sie sich bitte an das Netvolution-Supportteam, oder wenden Sie sich an die offizielle Dokumentation.For any issues or support, please contact the Netvolution support team or refer to the official documentation.

Lizenz

Dieser Connector wird unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der LICENSE-Datei.

Eine Verbindung wird erstellt

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe	Parameter zum Erstellen einer Verbindung.	Alle Regionen	Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name	Typ	Description	Erforderlich
API-SCHLÜSSEL	securestring	Der SCHLÜSSEL für diese API
Netvolution Hostname	Schnur	Netvolution Hostname (Beispiel: yourdomain.netvolution.net).	Richtig

Drosselungsgrenzwerte

Name	Aufrufe	Verlängerungszeitraum
API-Aufrufe pro Verbindung	100	60 Sekunden

Aktionen

Abrufen von E-Mail-Vorlagen	Listet alle benutzerdefinierten E-Mail-Vorlagen auf.
Bestellung für einen Kontakt abrufen	Überprüfen Sie, ob ein Kontakt eine Bestellung getätigt hat.
E-Mail senden	Diese Aktion löst die in Netvolution erstellte E-Mail-Kampagne aus.
Kontakt zur Unterdrückungsliste einfügen	Kontakt zur Unterdrückungsliste einfügen
Wunschliste abrufen	Wunschliste abrufen
Überprüfen, ob das Ereignis aufgetreten ist	Überprüfen Sie, ob das Ereignis für eine bestimmte Kontakt-ID und für einen bestimmten Zeitraum aufgetreten ist.
Überprüfen, ob sich der Kontakt in der Unterdrückungsliste befindet	Verwenden Sie diese Aktion, um zu überprüfen, ob ein Kontakt vorübergehend in der Unterdrückungsliste enthalten ist.

Abrufen von E-Mail-Vorlagen

Vorgangs-ID:

GetEmailTemplates

Listet alle benutzerdefinierten E-Mail-Vorlagen auf.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Nachricht	Message	boolean	Nachricht
Ergebnisse	Results	integer	Ergebnisse

Bestellung für einen Kontakt abrufen

Vorgangs-ID:

GetOrder

Überprüfen Sie, ob ein Kontakt eine Bestellung getätigt hat.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Kontakt-ID	contactId	True	string	Verwenden Sie die Ausgabe für die Kontakt-ID basierend auf Dem zuvor verwendeten Trigger.
Seit	since	True	string	Punkt, an dem überprüft wird, ob ein Benutzer eine Bestellung aufgegeben hat.

E-Mail senden

Vorgangs-ID:

SendMail

Diese Aktion löst die in Netvolution erstellte E-Mail-Kampagne aus.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Kontakt-ID	cdpContactId		string	CDP-Kontakt-ID des Benutzers.
Sprach-ID	languageId		string	Sprach-ID wie auf der Netvolution-Website angegeben.
E-Mail-Vorlage	emailTemplate		string	Wählen Sie die E-Mail-Kampagne aus.

Kontakt zur Unterdrückungsliste einfügen

Vorgangs-ID:

PutContactIDToSuppresionList

Kontakt zur Unterdrückungsliste einfügen

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Kontakt-ID	contactId	True	string	Verwenden Sie die Ausgabe für die Kontakt-ID basierend auf Dem zuvor verwendeten Trigger.
Name der Unterdrückungsliste	listName	True	string	Name der Unterdrückungsliste.
Zeitspanne	timeSpan	True	string	Geben Sie die Anzahl der Tage an, an der die Kontakt-ID in der Unterdrückungsliste für diese Kampagne verbleibt.

Wunschliste abrufen

Vorgangs-ID:

GetWishList

Wunschliste abrufen

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Zeitspanne	since	True	string	Geben Sie die Anzahl der Tage an, die Sie auf aktualisierte Wunschlisten überprüfen möchten.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Ergebnisse	Results	array of object	Ergebnisse
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

Überprüfen, ob das Ereignis aufgetreten ist

Vorgangs-ID:

CheckEvent

Überprüfen Sie, ob das Ereignis für eine bestimmte Kontakt-ID und für einen bestimmten Zeitraum aufgetreten ist.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Ereignisname	eventName		string	Wählen Sie ein verfügbares Ereignis aus.
Kontakt-ID	contactId		string	CDP-Kontakt-ID des Benutzers.
Seit	since		string	Punkt, zu dem es danach überprüft, ob ein Ereignis aufgetreten ist.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Nachricht	Message	boolean	Nachricht
Ergebnisse	Results	integer	Ergebnisse

Überprüfen, ob sich der Kontakt in der Unterdrückungsliste befindet

Vorgangs-ID:

GetContactIDFromSuppressionList

Verwenden Sie diese Aktion, um zu überprüfen, ob ein Kontakt vorübergehend in der Unterdrückungsliste enthalten ist.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Kontakt-ID	contactId	True	string	CDP-Kontakt-ID des Benutzers.
Listenname	listName	True	string	Name der Unterdrückungsliste.

Auslöser

Wenn ein Kontakt zu einem Segment hinzugefügt wird	Verwenden Sie diesen Auslöser, wenn einem Segment ein neuer Kontakt hinzugefügt wird.
Wenn ein neues Ereignis eintritt	Verwenden Sie diese Option, um ein Ereignis als Trigger auszuwählen.

Wenn ein Kontakt zu einem Segment hinzugefügt wird

Vorgangs-ID:

OnNewUserInSegment

Verwenden Sie diesen Auslöser, wenn einem Segment ein neuer Kontakt hinzugefügt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Segment-ID	Id	True	string	Verwenden Sie die Netvolution-Segment-ID.

Gibt zurück

Name	Pfad	Typ	Beschreibung
NextSince	NextSince	string	NextSince
Ergebnisse	Results	array of object	Ergebnisse
ID	Results.ID	string	ID
CreatedDate	Results.CreatedDate	string	CreatedDate
E-Mail-Adresse	Results.EmailAddress	string	E-Mail-Adresse
eStoreSessionId	Results.eStoreSessionId	string	eStoreSessionId
Vorname	Results.FirstName	string	Vorname
Nachname	Results.LastName	string	Nachname
Geburtsdatum	Results.DateOfBirth	string	Geburtsdatum
Geschlecht	Results.Gender	string	Geschlecht
Anonymisiert	Results.Anonymized	boolean	Anonymisiert
Code	Results.MobilePhone.Code	string	Code
Number	Results.MobilePhone.Number	string	Number
Ländercode	Results.MobilePhone.CountryCode	string	Ländercode
Wert	Results.ModifiedDate.Value	string	Wert
IsAutocalculated	Results.ModifiedDate.IsAutocalculated	boolean	IsAutocalculated
Code	Results.Landline.Code	string	Code
Number	Results.Landline.Number	string	Number
Ländercode	Results.Landline.CountryCode	string	Ländercode
Straße	Results.Address.Street	string	Straße
Stadt	Results.Address.City	string	Stadt
ZipCode	Results.Address.ZipCode	string	ZipCode
Bezirk	Results.Address.County	string	Bezirk
Country	Results.Address.Country	string	Country
Standort	Results.Location	string	Standort
Segmente	Results.Segments	array of object	Segmente
SegmentID	Results.Segments.SegmentID	integer	SegmentID
MemberSince	Results.Segments.MemberSince	string	MemberSince

Wenn ein neues Ereignis eintritt

Vorgangs-ID:

OnNewEvent

Verwenden Sie diese Option, um ein Ereignis als Trigger auszuwählen.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Ereignisname	eventName	True	string	Wählen Sie ein verfügbares Ereignis aus.

Gibt zurück

Name	Pfad	Typ	Beschreibung
NextSince	NextSince	string	NextSince
Ergebnisse	Results	array of object	Ergebnisse
LanguageID	Results.LanguageID	integer	LanguageID
LanguageName	Results.LanguageName	string	LanguageName
Ereignisname	Results.EventName	string	Ereignisname
Zeitstempel	Results.Timestamp	string	Zeitstempel
CDPContactID	Results.CDPContactID	string	CDPContactID
Familie	Results.Browser.OS.Family	string	Familie
Haupt	Results.Browser.OS.Major	string	Haupt
IsSpider	Results.Browser.Device.IsSpider	boolean	IsSpider
Familie	Results.Browser.Device.Family	string	Familie
Marke	Results.Browser.Device.Brand	string	Marke
Model	Results.Browser.Device.Model	string	Model
Familie	Results.Browser.UserAgent.Family	string	Familie
Haupt	Results.Browser.UserAgent.Major	string	Haupt
Geringfügig	Results.Browser.UserAgent.Minor	string	Geringfügig
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
Kategorie	Results.Product.Category	string	Kategorie