Compartir a través de

Netvolución (versión preliminar)

El conector netvolucional permite a las empresas simplificar y automatizar sus campañas de marketing de correo electrónico. Habilita la segmentación de correo electrónico de destino, la mensajería personalizada y los flujos de trabajo automatizados en función del comportamiento del usuario. Al aprovechar Netvolución, los vendedores pueden mejorar la participación, mejorar la retención de clientes e impulsar conversiones más altas con un esfuerzo mínimo.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Atcom SA
URL https://www.atcom.gr
Metadatos del conector
Publicador Atcom S.A
Sitio web https://www.atcom.gr/
Directiva de privacidad https://www.atcom.gr/privacy-policy/
Categorías Comercio; Marketing

Conector netvolucional

Introducción

El conector netvolucional le permite diseñar y automatizar actividades de marketing de correo electrónico, incluido el envío de correos electrónicos de marketing a segmentos específicos y campañas automatizadas basadas en acciones de comportamiento. Este conector proporciona un conjunto de acciones para administrar e interactuar con varios recursos dentro de la plataforma Netvolución.

Prerrequisitos

Para poder usar el conector netvolución, necesitará lo siguiente:

  • Una implementación de Netvolución.
  • Credenciales de API (clave de API).

Introducción

Para usar netvolución Connector, siga estos pasos:

  1. Agregue el conector al entorno de Power Platform:

    • Vaya al portal de Power Platform.
    • Vaya a la sección "Conectores" y agregue un nuevo conector.
    • Busque "Netvolución" y selecciónelo.

  2. Configure el conector:

    • Escriba las credenciales de API obtenidas de la plataforma Netvolución.
    • Escriba la dirección de netvolución (sin el https prefijo).
    • Guarde la configuración.

  3. Use el conector en sus aplicaciones y flujos:

    • Agregue el conector a los flujos de Power Apps o Power Automate.
    • Use las acciones disponibles para interactuar con los recursos de Netvolución.

Operaciones admitidas

El conector netvolucional admite las siguientes operaciones:

  • Obtener plantillas de correo electrónico

    • Método : GET
    • Ruta de acceso: /cdp/mail/list-templates
    • Descripción: enumere todas las plantillas de correo electrónico personalizadas.

  • Cuando se produce un nuevo evento

    • Método : GET
    • Ruta de acceso: /trigger/cdp/events/{eventName}
    • Descripción: Úselo para seleccionar un evento como desencadenador. Eventos admitidos: add_to_cart, view_page, view_item.

  • Cuando se agrega un contacto a un segmento

    • Método : GET
    • Ruta de acceso: /trigger/cdp/contacts/{Id}
    • Descripción: se desencadena cuando se agrega un nuevo contacto a un segmento.

  • Obtener pedido para un contacto

    • Método : GET
    • Ruta de acceso: /cdp/orders/{contactId}
    • Descripción: compruebe si un contacto ha realizado un pedido.

  • Comprobar si el contacto está en la lista de supresión

    • Método : GET
    • Ruta de acceso: /cdp/suppression/check
    • Descripción: compruebe si un contacto está temporalmente en la lista de supresión.

  • Poner contacto en la lista de supresión

    • Método: PUT
    • Ruta de acceso: /cdp/suppression/add
    • Descripción: agregue un contacto a la lista de supresión durante una duración especificada.

  • Enviar correo electrónico

    • Método : POST
    • Ruta de acceso: /cdp/mail/send
    • Descripción: esta acción desencadena una campaña de correo electrónico creada en Netvolución.

  • Comprobar si se produjo el evento

    • Método : GET
    • Ruta de acceso: /cdp/events/checkevent
    • Descripción: compruebe si se produjo un evento para un determinado identificador de contacto dentro de un período específico.

  • Obtener lista de deseos

    • Método : GET
    • Ruta de acceso: /cdp/wishlist/{since}
    • Descripción: recupere la lista de deseos actualizada en un período de tiempo especificado.

Definición de API

El conector usa la siguiente definición de API:

  • Archivo swagger: apiDefinition.swagger.json
    • Este archivo contiene el esquema de API detallado y los puntos de conexión usados por el conector.

Configuración

La configuración del conector se define en el siguiente archivo:

  • Archivo de configuración: settings.json
    • Este archivo contiene varias opciones de configuración para el conector.

Icon

El icono del conector se incluye en el siguiente archivo:

  • Archivo de icono: icon.png
    • Este archivo se usa como representación visual del conector en la interfaz de Power Platform.

Problemas conocidos y limitaciones

  • Actualmente, el conector admite operaciones básicas. Las características avanzadas se agregarán en futuras versiones.
  • Asegúrese de que las credenciales de API están configuradas correctamente para evitar errores de autenticación.

Support

Para cualquier problema o soporte técnico, póngase en contacto con el equipo de soporte técnico de Netvolución o consulte la documentación oficial.

Licencia

Este conector tiene licencia en la licencia MIT. Consulte el archivo LICENSE para obtener más detalles.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:
Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
CLAVE DE API securestring Clave para esta API
Nombre de host de netvolución cuerda / cadena Nombre de host de netvolución (ejemplo: yourdomain.netvolution.net). Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Colocar contacto en la lista de supresión

Colocar contacto en la lista de supresión
Comprobación de si se produjo el evento

Compruebe si el evento se produjo durante un determinado identificador de contacto y durante un período de tiempo determinado.
Comprobar si el contacto está en la lista de supresión

Use esta acción para comprobar si un contacto está temporalmente en la lista de supresión.
Enviar correo

Esta acción desencadena la campaña de correo electrónico creada en Netvolución.
Obtener lista de deseos

Obtener lista de deseos
Obtener pedido para un contacto

Compruebe si un contacto ha realizado un pedido.
Obtener plantillas de correo electrónico

Enumera todas las plantillas de correo electrónico personalizadas.

Colocar contacto en la lista de supresión

Id. de la operación:
PutContactIDToSuppresionList

Colocar contacto en la lista de supresión

Parámetros

Nombre Clave Requerido Tipo Description
ID de contacto
 contactId True string

Use la salida del identificador de contacto en función del desencadenador usado anteriormente.
Nombre de lista de supresión
 listName True string

Nombre de la lista de supresión.
Intervalo de tiempo
 timeSpan True string

Especifique el número de días que el identificador de contacto permanecerá en la lista de supresión de esta campaña.

Comprobación de si se produjo el evento

Id. de la operación:
CheckEvent

Compruebe si el evento se produjo durante un determinado identificador de contacto y durante un período de tiempo determinado.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre del evento
 eventName string

Seleccione un evento disponible.
ID de contacto
 contactId string

Identificador de contacto de CDP del usuario.
Desde
 since string

Momento dado en el que comprobará después si se produjo un evento.

Devoluciones

Nombre Ruta de acceso Tipo Description
Message
 Message boolean

Message
Results
 Results integer

Results

Comprobar si el contacto está en la lista de supresión

Id. de la operación:
GetContactIDFromSuppressionList

Use esta acción para comprobar si un contacto está temporalmente en la lista de supresión.

Parámetros

Nombre Clave Requerido Tipo Description
ID de contacto
 contactId True string

Identificador de contacto de CDP del usuario.
Nombre de la lista
 listName True string

Nombre de la lista de supresión.

Enviar correo

Id. de la operación:
SendMail

Esta acción desencadena la campaña de correo electrónico creada en Netvolución.

Parámetros

Nombre Clave Requerido Tipo Description
ID de contacto
 cdpContactId string

Identificador de contacto de CDP del usuario.
Id. de idioma
 languageId string

Id. de idioma tal como se especifica en el sitio de netvolución.
Plantilla de correo electrónico
 emailTemplate string

Seleccione la campaña de correo electrónico.

Obtener lista de deseos

Id. de la operación:
GetWishList

Obtener lista de deseos

Parámetros

Nombre Clave Requerido Tipo Description
Intervalo de tiempo
 since True string

Especifique el número de días que desea comprobar si hay listas de deseos actualizadas.

Devoluciones

Nombre Ruta de acceso Tipo 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

Obtener pedido para un contacto

Id. de la operación:
GetOrder

Compruebe si un contacto ha realizado un pedido.

Parámetros

Nombre Clave Requerido Tipo Description
ID de contacto
 contactId True string

Use la salida del identificador de contacto en función del desencadenador usado anteriormente.
Desde
 since True string

Momento dado en el que comprobará si un usuario ha puesto un pedido.

Obtener plantillas de correo electrónico

Id. de la operación:
GetEmailTemplates

Enumera todas las plantillas de correo electrónico personalizadas.

Devoluciones

Nombre Ruta de acceso Tipo Description
Message
 Message boolean

Message
Results
 Results integer

Results

Desencadenadores

Cuando se agrega un contacto a un segmento

Use este desencadenador cuando se agregue un nuevo contacto a un segmento.
Cuando se produce un nuevo evento

Úselo para seleccionar un evento como desencadenador

Cuando se agrega un contacto a un segmento

Id. de la operación:
OnNewUserInSegment

Use este desencadenador cuando se agregue un nuevo contacto a un segmento.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de segmento
 Id True string

Use el identificador de segmento de netvolución.

Devoluciones

Nombre Ruta de acceso Tipo Description
NextSince
 NextSince string

NextSince
Results
 Results array of object

Results
identificación
 Results.ID string

identificación
CreatedDate
 Results.CreatedDate string

CreatedDate
Dirección de correo electrónico
 Results.EmailAddress string

Dirección de correo electrónico
eStoreSessionId
 Results.eStoreSessionId string

eStoreSessionId
Primer Nombre
 Results.FirstName string

Primer Nombre
Apellido
 Results.LastName string

Apellido
Fecha de nacimiento
 Results.DateOfBirth string

Fecha de nacimiento
Gender
 Results.Gender string

Gender
Anonimizado
 Results.Anonymized boolean

Anonimizado
Código
 Results.MobilePhone.Code string

Código
Number
 Results.MobilePhone.Number string

Number
Código de país
 Results.MobilePhone.CountryCode string

Código de país
Importancia
 Results.ModifiedDate.Value string

Importancia
IsAutocalculated
 Results.ModifiedDate.IsAutocalculated boolean

IsAutocalculated
Código
 Results.Landline.Code string

Código
Number
 Results.Landline.Number string

Number
Código de país
 Results.Landline.CountryCode string

Código de país
Calle
 Results.Address.Street string

Calle
City
 Results.Address.City string

City
ZipCode
 Results.Address.ZipCode string

ZipCode
Provincia
 Results.Address.County string

Provincia
País
 Results.Address.Country string

País
Ubicación
 Results.Location string

Ubicación
Segmentos
 Results.Segments array of object

Segmentos
SegmentID
 Results.Segments.SegmentID integer

SegmentID
MemberSince
 Results.Segments.MemberSince string

MemberSince

Cuando se produce un nuevo evento

Id. de la operación:
OnNewEvent

Úselo para seleccionar un evento como desencadenador

Parámetros

Nombre Clave Requerido Tipo Description
Nombre del evento
 eventName True string

Seleccione un evento disponible.

Devoluciones

Nombre Ruta de acceso Tipo Description
NextSince
 NextSince string

NextSince
Results
 Results array of object

Results
LanguageID
 Results.LanguageID integer

LanguageID
LanguageName
 Results.LanguageName string

LanguageName
Nombre del evento
 Results.EventName string

Nombre del evento
Marca de tiempo
 Results.Timestamp string

Marca de tiempo
CDPContactID
 Results.CDPContactID string

CDPContactID
Familia
 Results.Browser.OS.Family string

Familia
Destacado
 Results.Browser.OS.Major string

Destacado
IsSpider
 Results.Browser.Device.IsSpider boolean

IsSpider
Familia
 Results.Browser.Device.Family string

Familia
Marca
 Results.Browser.Device.Brand string

Marca
Modelo
 Results.Browser.Device.Model string

Modelo
Familia
 Results.Browser.UserAgent.Family string

Familia
Destacado
 Results.Browser.UserAgent.Major string

Destacado
Minor
 Results.Browser.UserAgent.Minor string

Minor
Patch
 Results.Browser.UserAgent.Patch string

Patch
id
 Results.List.id string

id
nombre
 Results.List.name string

nombre
ItemParentId
 Results.Product.ItemParentId string

ItemParentId
NombreDelArtículo
 Results.Product.ItemName string

NombreDelArtículo
Categoría
 Results.Product.Category string

Categoría