Netvolution (Preview)

Konektor Netvolution umožňuje firmám zjednodušit a automatizovat e-mailové marketingové kampaně. Umožňuje cílené segmentace e-mailů, přizpůsobené zasílání zpráv a automatizované pracovní postupy na základě chování uživatelů. Díky využití Netvolution můžou obchodníci zvýšit zapojení, zlepšit uchovávání zákazníků a řídit vyšší převody s minimálním úsilím.

Tento konektor je dostupný v následujících produktech a oblastech:

Service	Class	Regions
Copilot Studio	Premium	Všechny oblasti Power Automate s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Logic Apps	Standard	Všechny oblasti Logic Apps s výjimkou následujících:      – Oblasti Azure Government      – Oblasti Azure China      - Ministerstvo obrany USA (DoD)
Power Apps	Premium	Všechny oblasti Power Apps s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Power Automate	Premium	Všechny oblasti Power Automate s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)

Kontakt
Název	Atcom SA
URL	https://www.atcom.gr

Metadata konektoru
Vydavatel	Atcom S.A
Internetová stránka	https://www.atcom.gr/
Zásady ochrany osobních údajů	https://www.atcom.gr/privacy-policy/
Kategorie	Obchod; Marketing

Netvolution Connector

Úvod

Konektor Netvolution umožňuje navrhovat a automatizovat e-mailové marketingové aktivity, včetně odesílání marketingových e-mailů konkrétním segmentům a automatizovaným kampaním na základě akcí chování. Tento konektor poskytuje sadu akcí pro správu a interakci s různými prostředky v rámci platformy Netvolution.

Požadavky

Než budete moct použít konektor Netvolution, budete potřebovat:

• Implementace Netvolution.
• Přihlašovací údaje rozhraní API (klíč rozhraní API).

Začínáme

Chcete-li použít konektor Netvolution, postupujte takto:

1. Přidejte konektor do prostředí Power Platform:

   • Přejděte na portál Power Platform.
   • Přejděte do části Konektory a přidejte nový konektor.
   • Vyhledejte "Netvolution" a vyberte ho.

2. Konfigurace konektoru:

   • Zadejte přihlašovací údaje rozhraní API získané z platformy Netvolution.
   • Zadejte svoji adresu Netvolution (bez předpony https ).
   • Uložte konfiguraci.

3. Použijte konektor v aplikacích a tocích:

   • Přidejte konektor do toků Power Apps nebo Power Automate.
   • K interakci s prostředky Netvolution použijte dostupné akce.

Podporované operace

Konektor Netvolution podporuje následující operace:

• Získání e-mailových šablon

  • metody: GET
  • Cesta: /cdp/mail/list-templates
  • Popis: Vypište všechny vlastní e-mailové šablony.

• Když dojde k nové události

  • metody: GET
  • Cesta: /trigger/cdp/events/{eventName}
  • Popis: Tuto možnost použijte k výběru události jako triggeru. Podporované události: add_to_cart, view_page, view_item.

• Při přidání kontaktu do segmentu

  • metody: GET
  • Cesta: /trigger/cdp/contacts/{Id}
  • Popis: Aktivuje se při přidání nového kontaktu do segmentu.

• Získání objednávky kontaktu

  • metody: GET
  • Cesta: /cdp/orders/{contactId}
  • Popis: Zkontrolujte, jestli kontakt provedl objednávku.

• Kontrola, jestli je kontakt v seznamu potlačení

  • metody: GET
  • Cesta: /cdp/suppression/check
  • Popis: Zkontrolujte, jestli je kontakt dočasně v seznamu potlačení.

• Umístit kontakt do seznamu potlačení

  • Metoda: PUT
  • Cesta: /cdp/suppression/add
  • Popis: Přidejte kontakt do seznamu potlačení pro zadanou dobu trvání.

• Odeslat e-mail

  • Metoda: POST
  • Cesta: /cdp/mail/send
  • Popis: Tato akce aktivuje e-mailovou kampaň vytvořenou v netvolution.

• Kontrola, jestli došlo k události

  • metody: GET
  • Cesta: /cdp/events/checkevent
  • Popis: Zkontrolujte, jestli v určitém období nedošlo k nějaké události pro určité ID kontaktu.

• Získat seznam přání

  • metody: GET
  • Cesta: /cdp/wishlist/{since}
  • Popis: Načtěte seznam přání aktualizovaný v zadaném časovém rámci.

Definice rozhraní API

Konektor používá následující definici rozhraní API:

• Soubor Swagger: apiDefinition.swagger.json
  • Tento soubor obsahuje podrobné schéma rozhraní API a koncové body používané konektorem.

Nastavení

Nastavení konektoru jsou definována v následujícím souboru:

• Soubor nastavení: settings.json
  • Tento soubor obsahuje různá nastavení konfigurace konektoru.

Ikona

Ikona konektoru je součástí následujícího souboru:

• Soubor ikony: icon.png
  • Tento soubor se používá jako vizuální reprezentace konektoru v rozhraní Power Platform.

Známé problémy a omezení

• Konektor v současné době podporuje základní operace. Rozšířené funkce budou přidány v budoucích verzích.
• Ujistěte se, že jsou vaše přihlašovací údaje rozhraní API správně nakonfigurované, aby nedocházelo k chybám ověřování.

Support

V případě jakýchkoli problémů nebo podpory se obraťte na tým podpory Netvolution nebo se obraťte na oficiální dokumentaci.

Licence

Tento konektor je licencovaný v rámci licence MIT. Další podrobnosti najdete v souboru LICENSE.

Vytvoření připojení

Konektor podporuje následující typy ověřování:

výchozí	Parametry pro vytvoření připojení	Všechny oblasti	Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název	Typ	Description	Povinné
KLÍČ ROZHRANÍ API	securestring	KLÍČ pro toto rozhraní API
Název hostitele netvolution	řetězec	Název hostitele netvolution (příklad: yourdomain.netvolution.net).	Pravdivé

Limity omezování

Name	Volání	Období obnovení
Volání rozhraní API na připojení	100	60 sekund

Akce

Kontrola, jestli došlo k události	Zkontrolujte, jestli k události došlo u určitého ID kontaktu a po určitou dobu.
Kontrola, jestli je kontakt v seznamu potlačení	Pomocí této akce zkontrolujte, jestli je kontakt dočasně v seznamu potlačení.
Poslat e-mail	Tato akce aktivuje e-mailovou kampaň vytvořenou v netvolution.
Umístění kontaktu do seznamu potlačení	Umístění kontaktu do seznamu potlačení
Získat seznam přání	Získat seznam přání
Získání e-mailových šablon	Zobrazit seznam všech vlastních e-mailových šablon
Získání objednávky kontaktu	Zkontrolujte, jestli kontakt provedl objednávku.

Kontrola, jestli došlo k události

ID operace:

CheckEvent

Zkontrolujte, jestli k události došlo u určitého ID kontaktu a po určitou dobu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název události	eventName		string	Vyberte dostupnou událost.
ID kontaktu	contactId		string	ID kontaktu CDP uživatele.
Jelikož	since		string	Bod v čase, kde se následně zkontroluje, jestli došlo k události.

Návraty

Name	Cesta	Typ	Description
Message	Message	boolean	Message
Results	Results	integer	Results

Kontrola, jestli je kontakt v seznamu potlačení

ID operace:

GetContactIDFromSuppressionList

Pomocí této akce zkontrolujte, jestli je kontakt dočasně v seznamu potlačení.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID kontaktu	contactId	True	string	ID kontaktu CDP uživatele.
Název seznamu:	listName	True	string	Název seznamu potlačení

Poslat e-mail

ID operace:

SendMail

Tato akce aktivuje e-mailovou kampaň vytvořenou v netvolution.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID kontaktu	cdpContactId		string	ID kontaktu CDP uživatele.
ID jazyka	languageId		string	ID jazyka zadané v lokalitě netvolution.
Šablona e-mailu	emailTemplate		string	Vyberte e-mailovou kampaň.

Umístění kontaktu do seznamu potlačení

ID operace:

PutContactIDToSuppresionList

Umístění kontaktu do seznamu potlačení

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID kontaktu	contactId	True	string	Použijte výstup pro ID kontaktu na základě dříve použité aktivační události.
Název seznamu potlačení	listName	True	string	Název seznamu potlačení
Časové rozpětí	timeSpan	True	string	Zadejte počet dnů, po které bude ID kontaktu v seznamu potlačení pro tuto kampaň.

Získat seznam přání

ID operace:

GetWishList

Získat seznam přání

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Časové rozpětí	since	True	string	Zadejte počet dní, po které chcete zkontrolovat aktualizované seznamy přání.

Návraty

Name	Cesta	Typ	Description
Results	Results	array of object	Results
CDPContactID	Results.CDPContactID	string	CDPContactID
ID uživatele	Results.UserID	integer	ID uživatele
ID přání	Results.WishListID	integer	ID přání
LastUpdated	Results.LastUpdated	string	LastUpdated
ID jazyka	Results.LanguageID	integer	ID jazyka

Získání e-mailových šablon

ID operace:

GetEmailTemplates

Zobrazit seznam všech vlastních e-mailových šablon

Návraty

Name	Cesta	Typ	Description
Message	Message	boolean	Message
Results	Results	integer	Results

Získání objednávky kontaktu

ID operace:

GetOrder

Zkontrolujte, jestli kontakt provedl objednávku.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID kontaktu	contactId	True	string	Použijte výstup pro ID kontaktu na základě dříve použité aktivační události.
Jelikož	since	True	string	Bod v čase, ve kterém zkontroluje, jestli uživatel zadal objednávku.

Aktivační události

Když dojde k nové události	Tuto možnost použijte k výběru události jako triggeru.
Při přidání kontaktu do segmentu	Tuto aktivační událost použijte při přidání nového kontaktu do segmentu.

Když dojde k nové události

ID operace:

OnNewEvent

Tuto možnost použijte k výběru události jako triggeru.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název události	eventName	True	string	Vyberte dostupnou událost.

Návraty

Name	Cesta	Typ	Description
NextSince	NextSince	string	NextSince
Results	Results	array of object	Results
ID jazyka	Results.LanguageID	integer	ID jazyka
LanguageName	Results.LanguageName	string	LanguageName
Název Události	Results.EventName	string	Název Události
Časová značka	Results.Timestamp	string	Časová značka
CDPContactID	Results.CDPContactID	string	CDPContactID
Rodina	Results.Browser.OS.Family	string	Rodina
Hlavní	Results.Browser.OS.Major	string	Hlavní
IsSpider	Results.Browser.Device.IsSpider	boolean	IsSpider
Rodina	Results.Browser.Device.Family	string	Rodina
Značka	Results.Browser.Device.Brand	string	Značka
Model	Results.Browser.Device.Model	string	Model
Rodina	Results.Browser.UserAgent.Family	string	Rodina
Hlavní	Results.Browser.UserAgent.Major	string	Hlavní
Nezletilý	Results.Browser.UserAgent.Minor	string	Nezletilý
Patch	Results.Browser.UserAgent.Patch	string	Patch
identifikační číslo	Results.List.id	string	identifikační číslo
název	Results.List.name	string	název
ItemParentId	Results.Product.ItemParentId	string	ItemParentId
Název Položky	Results.Product.ItemName	string	Název Položky
Kategorie	Results.Product.Category	string	Kategorie

Při přidání kontaktu do segmentu

ID operace:

OnNewUserInSegment

Tuto aktivační událost použijte při přidání nového kontaktu do segmentu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID segmentu	Id	True	string	Použijte ID segmentu netvolution.

Návraty

Name	Cesta	Typ	Description
NextSince	NextSince	string	NextSince
Results	Results	array of object	Results
ID	Results.ID	string	ID
Datum vytvoření	Results.CreatedDate	string	Datum vytvoření
E-mailová adresa	Results.EmailAddress	string	E-mailová adresa
eStoreSessionId	Results.eStoreSessionId	string	eStoreSessionId
Křestní jméno	Results.FirstName	string	Křestní jméno
Příjmení	Results.LastName	string	Příjmení
Datum narození	Results.DateOfBirth	string	Datum narození
Pohlaví	Results.Gender	string	Pohlaví
Anonymizováno	Results.Anonymized	boolean	Anonymizováno
Code	Results.MobilePhone.Code	string	Code
Number	Results.MobilePhone.Number	string	Number
Kód země	Results.MobilePhone.CountryCode	string	Kód země
Hodnota	Results.ModifiedDate.Value	string	Hodnota
IsAutocalculated	Results.ModifiedDate.IsAutocalculated	boolean	IsAutocalculated
Code	Results.Landline.Code	string	Code
Number	Results.Landline.Number	string	Number
Kód země	Results.Landline.CountryCode	string	Kód země
Ulice	Results.Address.Street	string	Ulice
City	Results.Address.City	string	City
PSČ	Results.Address.ZipCode	string	PSČ
Kraj	Results.Address.County	string	Kraj
Country	Results.Address.Country	string	Country
Umístění	Results.Location	string	Umístění
Segments	Results.Segments	array of object	Segments
SEGMENTID	Results.Segments.SegmentID	integer	SEGMENTID
MemberSince	Results.Segments.MemberSince	string	MemberSince