Saltar al contenido principal

Activación de las campañas transaccionales

Existen dos formas de activar una campaña transaccional:

Las llamadas a la API suelen preferirse cuando se requieren envíos en tiempo real y la fuente de la transacción debe activar directamente el mensaje, sin pasar necesariamente por su CRM.

Por otro lado, los escenarios resultan útiles para activar campañas cuando se crea o se actualiza una línea en una tabla de interacción de su modelo de datos.

Configurar sus llamadas a la API​

Para poder activar una campaña transaccional mediante la API, es necesario activar la campaña. Se encontrará en la pestaña "En curso" de la interfaz.

La llamada deberá hacer referencia al nombre técnico o al id de la campaña. Estos parámetros son visibles en la interfaz actualizando las opciones en la esquina superior derecha.

Visualización del nombre técnico y del id

El nombre técnico es el nombre que elige al crear la campaña, sin caracteres especiales ni espacios. Preste atención a comunicar la referencia correcta a su desarrollador.

Activar una campaña transaccional​

Activar un email transaccional​

Existen dos llamadas dedicadas para activar un email transaccional. Ambas le permiten crear (o actualizar) un perfil en su base de datos transaccional y activar la campaña al mismo tiempo.

POST /entity/{e}/transactionalmail/{m}/contact​

Esta llamada estándar para activar emails transaccionales requiere un body en el que se envía toda la información.

Permite crear (o actualizar) un nuevo perfil en su tabla de perfiles gracias al objeto "profile" y enviar valores de personalización.

Cada "key" en los objetos de "parameters" debe corresponder al nombre de la variable de personalización definida en el contenido de su campaña (véase el punto Personalización por API).

Ejemplo de body

{
  "profile": {
    "attributes": [
      {
        "name": "emailAddress",
        "value": "john.smith@actito.com"
      }
    ],
    "dataCollection": {
      "source": "AGDPRSource",
      "way": "AGDPRWay",
      "date": "10/09/2019 22:00:00"
    }
  },
  "parameters": [
    {
      "key": "orderIdPerso",
      "values": ["123456"]
    },
    {
      "key": "firstNamePerso",
      "values": ["John"]
    },
    {
      "key": "externalData",
      "structuredValue": {
        "items": [
          {
            "name": "article 1",
            "quantity": "1",
            "unitPrice": "59",
            "productUrl": "https://www.actito.com/be_fr/article_1"
          },
          {
            "name": "article 2",
            "quantity": "1",
            "unitPrice": "79",
            "productUrl": "https://www.actito.com/be_fr/article_2"
          }
        ]
      }
    }
  ]
}
Consejo

¿Se ha fijado en el objeto "structuredValue" del ejemplo anterior? Es la forma de enviar datos en las personalizaciones de bucle, que permiten repetir varios conjuntos de datos en su email sin tener que definir de antemano el número de elementos (¡muy útil para las confirmaciones de pedido!).

Descubra más en la sección Utilizar las personalizaciones de bucle.

POST /entity/{e}/transactionalmail/{m}/contactWithAttachment​

Esta llamada adicional le permite enviar archivos adjuntos con sus emails transaccionales, lo cual resulta muy útil, por ejemplo, para los tickets digitales.

Esta llamada le permite adjuntar hasta diez archivos con un tamaño máximo total de 1 MB (por defecto). Se admiten las siguientes extensiones: csv, doc, docx, gif, html, jpeg, jpg, pdf, png, xls y xlsx.

tip

Si desea enviar archivos adjuntos más grandes, póngase en contacto con su gestor de cuenta.

aviso

Aumentar el límite de tamaño de los archivos adjuntos puede generar varios riesgos y efectos negativos en su entregabilidad:

  • Ralentización de los envíos: los mensajes más pesados pueden sobrecargar los servidores (MTA), especialmente durante los envíos masivos.
  • Rechazos por parte de algunos ISP/webmails: debido a su infraestructura, algunos proveedores no aceptan mensajes con archivos adjuntos voluminosos.
  • Aumento de los plazos de distribución: el peso de los mensajes puede alargar los plazos de entrega.

Esta llamada requiere un body multipart/form-data compuesto por un mínimo de dos archivos:

  • Un archivo JSON declarado como transactionalMail que contendrá toda la información para crear el perfil y los valores de personalización del email (igual que el body de la llamada para activar un email sin archivo adjunto), con un objeto adicional attachments para hacer referencia al nombre de dichos archivos adjuntos.
  • Uno o varios archivos adjuntos, declarados como part1 hasta part10, que corresponden a los archivos referenciados en el archivo de definición y respetan las extensiones/nombres permitidos.

Ejemplo de un transactionalMail.json

{
  "profile": {
    "attributes": [
      {
        "name": "emailAddress",
        "value": "john.smith@actito.com"
      }
    ],
    "dataCollection": {
      "source": "AGDPRSource",
      "way": "AGDPRWay",
      "date": "10/09/2019 22:00:00"
    }
  },
  "parameters": [
    {
      "key": "orderIdPerso",
      "values": ["123456"]
    },
    {
      "key": "firstNamePerso",
      "values": ["John"]
    },
    {
      "key": "externalData",
      "structuredValue": {
        "items": [
          {
            "name": "article 1",
            "quantity": "1",
            "unitPrice": "59",
            "productUrl": "https://www.actito.com/be_fr/article_1"
          },
          {
            "name": "article 2",
            "quantity": "1",
            "unitPrice": "79",
            "productUrl": "https://www.actito.com/be_fr/article_2"
          }
        ]
      }
    }
  ],
  "attachments": {
    "part1": "MyFirstAttachedFile.csv",
    "part2": "Legal.pdf"
  }
}
Consejo

Tenga en cuenta que part1 es un parámetro obligatorio: para utilizar esta llamada, se requiere al menos un archivo adjunto.

Si no necesita enviar ningún archivo adjunto, utilice la llamada estándar.

Activar un SMS transaccional​

Existe una llamada a la API para activar un SMS transaccional.

POST /entity/{e}/transactionalsms/{s}/contact​

Esta llamada estándar para crear un SMS transaccional requiere un body en el que se envía toda la información.

Permite crear (o actualizar) un nuevo perfil en su base de datos gracias al objeto "profile" y enviar valores de personalización.

Cada "key" en los objetos de "parameters" debe corresponder al nombre de la variable de personalización definida en el contenido de su campaña.

{
  "profile": {
    "attributes": [
      {
        "name": "phoneNumber",
        "value": "+32000000000"
      }
    ],
    "dataCollection": {
      "source": "AGDPRSource",
      "way": "AGDPRWay",
      "date": "10/09/2019 22:00:00"
    }
  },
  "parameters": [
    {
      "key": "profileAgePerso",
      "values": ["25"]
    },
    {
      "key": "birthPlacePerso",
      "values": ["New-York City"]
    }
  ]
}

Configurar un escenario​

También es posible activar su campaña transaccional gracias al módulo Escenarios de Actito en lugar de mediante la API. En particular, si utiliza su modelo de datos principal y no una base de datos dedicada. Esta forma de proceder es menos frecuente, ya que toda la información necesaria para activar el escenario no está necesariamente almacenada en su modelo de datos de Actito (por ejemplo, renovación de contraseña).

Utilizar el evento de inicio "Otra interacción"​

Gracias al bloque de inicio "Otra interacción", es posible activar un escenario cuando se crea (o se actualiza) una nueva línea en una tabla de interacción de su modelo de datos.

Por ejemplo, una nueva línea en una tabla "Pedidos" podría activar un escenario que envíe un email transaccional de confirmación de pedido, o actualizar el estado de un pedido existente a "Enviado" podría activar un escenario de confirmación de envío.

Bloque de inicio Otra interacción

En el bloque, podrá elegir la tabla de interacción y el evento activador (si hay varios eventos configurados en su tabla).

Por defecto, todas las tablas tienen un evento correspondiente a la creación de una nueva línea. También es posible definir eventos para la actualización de líneas existentes (por ejemplo, cuando el campo "Estado" de su tabla "Pedidos" se actualiza del valor "CONFIRMADO" al valor "ENVIADO").

Elección de la tabla de interacción y del evento

Consejo

Los eventos correspondientes a "actualizaciones" deben definirse en la estructura de su tabla de interacción.

Si necesita ayuda para modificar la estructura de su tabla, póngase en contacto con el soporte de Actito o con su gestor de cuenta.

A continuación, podrá añadir un bloque "Enviar un email" y seleccionar su campaña transaccional...

Bloque Enviar un email

... o añadir un bloque "Enviar un SMS" y seleccionar su campaña de SMS transaccional.

Bloque Enviar un SMS

La ventaja de los escenarios es que puede seguir construyendo su flujo utilizando los distintos bloques disponibles, además de enviar su comunicación transaccional.

Puede combinar canales, o enviar un email (no transaccional) de satisfacción unos días después del pedido, por ejemplo.

nota

Tenga en cuenta que siempre es necesario alimentar su tabla de interacción para activar el bloque de inicio del escenario.

La alimentación puede realizarse mediante una llamada a la API si tiene una restricción de tiempo real, y mediante una importación masiva por API o una sincronización ETL si desea importar una gran cantidad de datos de una sola vez.

Utilizar el evento de inicio "Iniciar"​

También es posible iniciar el escenario que contiene su campaña transaccional con el bloque de inicio "Iniciar" y una llamada a la API.

Esta solución es útil si desea combinar distintos modos de comunicación en momentos diferentes (como enviar una confirmación de pedido y un formulario de satisfacción siete días después), pero el activador de la transacción no es una nueva línea o una línea actualizada en una tabla de interacción de su modelo de datos.

Bloque de inicio Iniciar

nota

Tenga en cuenta que, en este caso, todos los valores de personalización de la campaña deben almacenarse en su modelo de datos de Actito y no pueden insertarse en la llamada a la API que activa el escenario.

¿Te ha sido útil esta página?