Netvolution (anteprima)

Netvolution Connector consente alle aziende di semplificare e automatizzare le campagne di marketing tramite posta elettronica. Consente la segmentazione della posta elettronica di destinazione, la messaggistica personalizzata e i flussi di lavoro automatizzati in base al comportamento degli utenti. Sfruttando Netvolution, i marketer possono migliorare l'engagement, migliorare la conservazione dei clienti e aumentare le conversioni con un minimo sforzo.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Normale	Tutte le aree di App per la logica , ad eccezione delle seguenti:      - Aree di Azure per enti pubblici      - Aree di Azure Cina      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Di alta qualità	Tutte le aree di Power Apps , ad eccezione dei seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	Atcom SA
URL	https://www.atcom.gr

Metadati del connettore
Editore	Atcom S.A
Sito web	https://www.atcom.gr/
Informativa sulla privacy	https://www.atcom.gr/privacy-policy/
Categorie	Commercio; Marketing

Connettore Netvolution

Introduzione

Netvolution Connector consente di progettare e automatizzare le attività di marketing tramite posta elettronica, tra cui l'invio di messaggi di posta elettronica a segmenti specifici e campagne automatizzate in base alle azioni comportamentali. Questo connettore fornisce un set di azioni per gestire e interagire con varie risorse all'interno della piattaforma Netvolution.

Prerequisiti

Prima di poter usare Netvolution Connector, è necessario:

• Implementazione di Netvolution.
• Credenziali API (chiave API).

Come iniziare

Per usare Netvolution Connector, seguire questa procedura:

1. Aggiungere il connettore all'ambiente Power Platform:

   • Passare al portale di Power Platform.
   • Passare alla sezione "Connettori" e aggiungere un nuovo connettore.
   • Cercare "Netvolution" e selezionarlo.

2. Configurare il connettore:

   • Immettere le credenziali API ottenute dalla piattaforma Netvolution.
   • Immettere l'indirizzo Netvolution (senza il https prefisso).
   • Salvare la configurazione.

3. Usare il connettore nelle app e nei flussi:

   • Aggiungere il connettore ai flussi di Power Apps o Power Automate.
   • Usare le azioni disponibili per interagire con le risorse Netvolution.

Operazioni supportate

Netvolution Connector supporta le operazioni seguenti:

• Ottenere modelli di posta elettronica

  • Metodo: GET
  • Percorso: /cdp/mail/list-templates
  • Descrizione: elencare tutti i modelli di posta elettronica personalizzati.

• Quando si verifica un nuovo evento

  • Metodo: GET
  • Percorso: /trigger/cdp/events/{eventName}
  • Descrizione: usare questa opzione per selezionare un evento come trigger. Eventi supportati: add_to_cart, view_page, view_item.

• Quando un contatto viene aggiunto a un segmento

  • Metodo: GET
  • Percorso: /trigger/cdp/contacts/{Id}
  • Descrizione: attivato quando un nuovo contatto viene aggiunto a un segmento.

• Ottenere un ordine per un contatto

  • Metodo: GET
  • Percorso: /cdp/orders/{contactId}
  • Descrizione: controllare se un contatto ha effettuato un ordine.

• Controllare se il contatto è nell'elenco di eliminazione

  • Metodo: GET
  • Percorso: /cdp/suppression/check
  • Descrizione: controllare se un contatto è temporaneamente presente nell'elenco di eliminazione.

• Inserisci contatto nell'elenco di eliminazione

  • Metodo: PUT
  • Percorso: /cdp/suppression/add
  • Descrizione: aggiungere un contatto all'elenco di eliminazione per una durata specificata.

• Invia messaggio e-mail

  • Metodo: POST
  • Percorso: /cdp/mail/send
  • Descrizione: questa azione attiva una campagna di posta elettronica creata in Netvolution.

• Controllare se si è verificato l'evento

  • Metodo: GET
  • Percorso: /cdp/events/checkevent
  • Descrizione: controllare se si è verificato un evento per un determinato ID contatto entro un periodo specifico.

• Get Wish List

  • Metodo: GET
  • Percorso: /cdp/wishlist/{since}
  • Descrizione: recuperare l'elenco dei desideri aggiornato entro un intervallo di tempo specificato.

Definizione API

Il connettore usa la definizione API seguente:

• File Swagger: apiDefinition.swagger.json
  • Questo file contiene lo schema api dettagliato e gli endpoint usati dal connettore.

Settings

Le impostazioni del connettore sono definite nel file seguente:

• File delle impostazioni: settings.json
  • Questo file contiene varie impostazioni di configurazione per il connettore.

Icona

L'icona del connettore è inclusa nel file seguente:

• File icona: icon.png
  • Questo file viene usato come rappresentazione visiva del connettore nell'interfaccia di Power Platform.

Problemi noti e limitazioni

• Attualmente, il connettore supporta le operazioni di base. Le funzionalità avanzate verranno aggiunte nelle versioni future.
• Assicurarsi che le credenziali API siano configurate correttamente per evitare errori di autenticazione.

Support

Per eventuali problemi o supporto tecnico, contattare il team di supporto di Netvolution o fare riferimento alla documentazione ufficiale.

Licenza

Questo connettore è concesso in licenza con la licenza MIT. Per altri dettagli, vedere il file LICENSE.

Creare una connessione

Il connettore supporta i seguenti tipi di autenticazione:

Predefinita	Parametri per la creazione della connessione.	Tutte le aree geografiche	Non condivisibile

Predefinito

Applicabile: tutte le regioni

Parametri per la creazione della connessione.

Questa connessione non è condivisibile. Se l'app Power viene condivisa con un altro utente, a quest'ultimo verrà chiesto esplicitamente di creare una nuova connessione.

Nome	TIPO	Description	Obbligatorio
CHIAVE API	securestring	CHIAVE per questa API
Nome host Netvolution	corda	Nome host Netvolution (esempio: yourdomain.netvolution.net).	Vero

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	60 secondi

Azioni

Controllare se il contatto è nell'elenco di eliminazione	Utilizzare questa azione per verificare se un contatto è temporaneamente nell'elenco di eliminazione.
Controllare se si è verificato l'evento	Controllare se l'evento si è verificato per un determinato ID contatto e per un determinato periodo di tempo.
Get Wish List	Get Wish List
Inserisci contatto nell'elenco di eliminazione	Inserisci contatto nell'elenco di eliminazione
Invia messaggio di posta elettronica	Questa azione attiva la campagna di posta elettronica creata in Netvolution.
Ottenere modelli di posta elettronica	Elencare tutti i modelli di posta elettronica personalizzati.
Ottenere un ordine per un contatto	Controllare se un contatto ha effettuato un ordine.

Controllare se il contatto è nell'elenco di eliminazione

ID operazione:

GetContactIDFromSuppressionList

Utilizzare questa azione per verificare se un contatto è temporaneamente nell'elenco di eliminazione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contatto	contactId	True	string	ID contatto CDP dell'utente.
Nome della lista	listName	True	string	Nome dell'elenco di eliminazione.

Controllare se si è verificato l'evento

ID operazione:

CheckEvent

Controllare se l'evento si è verificato per un determinato ID contatto e per un determinato periodo di tempo.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome evento	eventName		string	Selezionare un evento disponibile.
ID contatto	contactId		string	ID contatto CDP dell'utente.
Poiché	since		string	Punto nel tempo in cui verificherà in seguito se si è verificato un evento.

Restituisce

Nome	Percorso	Tipo	Descrizione
Message	Message	boolean	Message
Results	Results	integer	Results

Get Wish List

ID operazione:

GetWishList

Get Wish List

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Intervallo di tempo	since	True	string	Specificare il numero di giorni in cui si desidera verificare la presenza di elenchi di desideri aggiornati.

Restituisce

Nome	Percorso	Tipo	Descrizione
Results	Results	array of object	Results
CDPContactID	Results.CDPContactID	string	CDPContactID
ID utente	Results.UserID	integer	ID utente
WishListID	Results.WishListID	integer	WishListID
LastUpdated	Results.LastUpdated	string	LastUpdated
LanguageID	Results.LanguageID	integer	LanguageID

Inserisci contatto nell'elenco di eliminazione

ID operazione:

PutContactIDToSuppresionList

Inserisci contatto nell'elenco di eliminazione

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contatto	contactId	True	string	Usare l'output per l'ID contatto in base al trigger usato in precedenza.
Nome elenco di eliminazione	listName	True	string	Nome dell'elenco di eliminazione.
Intervallo di tempo	timeSpan	True	string	Specificare il numero di giorni in cui l'ID contatto rimarrà nell'elenco di eliminazione per questa campagna.

Invia messaggio di posta elettronica

ID operazione:

SendMail

Questa azione attiva la campagna di posta elettronica creata in Netvolution.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contatto	cdpContactId		string	ID contatto CDP dell'utente.
ID lingua	languageId		string	ID lingua come specificato nel sito netvolution.
Modello di email	emailTemplate		string	Selezionare la campagna di posta elettronica.

Ottenere modelli di posta elettronica

ID operazione:

GetEmailTemplates

Elencare tutti i modelli di posta elettronica personalizzati.

Restituisce

Nome	Percorso	Tipo	Descrizione
Message	Message	boolean	Message
Results	Results	integer	Results

Ottenere un ordine per un contatto

ID operazione:

GetOrder

Controllare se un contatto ha effettuato un ordine.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contatto	contactId	True	string	Usare l'output per l'ID contatto in base al trigger usato in precedenza.
Poiché	since	True	string	Temporizzato in cui verificherà se un utente ha inserito un ordine.

Trigger

Quando si verifica un nuovo evento	Usare questa opzione per selezionare un evento come trigger
Quando un contatto viene aggiunto a un segmento	Usare questo trigger quando viene aggiunto un nuovo contatto a un segmento

Quando si verifica un nuovo evento

ID operazione:

OnNewEvent

Usare questa opzione per selezionare un evento come trigger

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome evento	eventName	True	string	Selezionare un evento disponibile.

Restituisce

Nome	Percorso	Tipo	Descrizione
NextSince	NextSince	string	NextSince
Results	Results	array of object	Results
LanguageID	Results.LanguageID	integer	LanguageID
LanguageName	Results.LanguageName	string	LanguageName
Nome dell'evento	Results.EventName	string	Nome dell'evento
Marca temporale:	Results.Timestamp	string	Marca temporale:
CDPContactID	Results.CDPContactID	string	CDPContactID
Famiglia	Results.Browser.OS.Family	string	Famiglia
Maggiore	Results.Browser.OS.Major	string	Maggiore
IsSpider	Results.Browser.Device.IsSpider	boolean	IsSpider
Famiglia	Results.Browser.Device.Family	string	Famiglia
Marchio	Results.Browser.Device.Brand	string	Marchio
Model	Results.Browser.Device.Model	string	Model
Famiglia	Results.Browser.UserAgent.Family	string	Famiglia
Maggiore	Results.Browser.UserAgent.Major	string	Maggiore
Minore	Results.Browser.UserAgent.Minor	string	Minore
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
ItemName	Results.Product.ItemName	string	ItemName
Categoria	Results.Product.Category	string	Categoria

Quando un contatto viene aggiunto a un segmento

ID operazione:

OnNewUserInSegment

Usare questo trigger quando viene aggiunto un nuovo contatto a un segmento

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID segmento	Id	True	string	Usare l'ID segmento netvolution.

Restituisce

Nome	Percorso	Tipo	Descrizione
NextSince	NextSince	string	NextSince
Results	Results	array of object	Results
Documento d'identità	Results.ID	string	Documento d'identità
CreatedDate	Results.CreatedDate	string	CreatedDate
Indirizzo email	Results.EmailAddress	string	Indirizzo email
eStoreSessionId	Results.eStoreSessionId	string	eStoreSessionId
Nome	Results.FirstName	string	Nome
Cognome	Results.LastName	string	Cognome
DataDiNascita	Results.DateOfBirth	string	DataDiNascita
Sesso	Results.Gender	string	Sesso
Anonimizzato	Results.Anonymized	boolean	Anonimizzato
Codice	Results.MobilePhone.Code	string	Codice
Number	Results.MobilePhone.Number	string	Number
Codice paese	Results.MobilePhone.CountryCode	string	Codice paese
Value	Results.ModifiedDate.Value	string	Value
IsAutocalculated	Results.ModifiedDate.IsAutocalculated	boolean	IsAutocalculated
Codice	Results.Landline.Code	string	Codice
Number	Results.Landline.Number	string	Number
Codice paese	Results.Landline.CountryCode	string	Codice paese
Via	Results.Address.Street	string	Via
Città	Results.Address.City	string	Città
CapCode	Results.Address.ZipCode	string	CapCode
Contea	Results.Address.County	string	Contea
Paese	Results.Address.Country	string	Paese
Posizione	Results.Location	string	Posizione
Segmenti	Results.Segments	array of object	Segmenti
SegmentID	Results.Segments.SegmentID	integer	SegmentID
MemberSince	Results.Segments.MemberSince	string	MemberSince