Activación de una actividad de señal

En un flujo de trabajo de Adobe Campaign Standard, puede haber uno o más Señal externa actividades. Estas actividades son "oyentes" que esperan a ser activados.

Las API de Campaign Standard le permiten realizar el déclencheur de un Señal externa actividad para llamar a un flujo de trabajo. La llamada de API puede incluir parámetros que se incorporarán en las variables de eventos del flujo de trabajo (un nombre de audiencia a destinatario, un nombre de archivo a importar, una parte del contenido del mensaje, etc.). De este modo, puede integrar fácilmente sus automatizaciones de Campaign con su sistema externo.

NOTA

Las actividades de señal externa no se pueden activar con más frecuencia que cada 10 minutos y el flujo de trabajo de destino ya debe estar en ejecución.

Para crear un déclencheur de un flujo de trabajo, siga los pasos a continuación:

  1. Realizar una GET en el flujo de trabajo para recuperar la URL del déclencheur de actividad Señal externa .

    GET https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<workflowID>

  2. Realizar una POST solicitud en la dirección URL devuelta para almacenar en déclencheur la actividad de señal, con la variable "source" en la carga útil. Este atributo es obligatorio, le permite indicar el origen de la solicitud de activación.

Si desea llamar al flujo de trabajo con parámetros, agréguelos a la carga útil con la variable "parameters" atributo. La sintaxis consiste en el nombre del parámetro seguido de su valor (se admiten los siguientes tipos: string, number, booleano y fecha y hora).

  -X POST <TRIGGER_URL>
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'Cache-Control: no-cache' \
  -H 'X-Api-Key: <API_KEY>' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H 'Content-Length:79' \
  -i
  -d {
  -d    "source":"<SOURCE>",
  -d    "parameters":{
  -d      "<PARAMETER_NAME":"<PARAMETER_VALUE>",
  -d      "<PARAMETER_NAME":"<PARAMETER_VALUE>",
  -d      "<PARAMETER_NAME":"<PARAMETER_VALUE>",  
  -d      "<PARAMETER_NAME":"<PARAMETER_VALUE>"
  -d    }
  -d }
NOTA

Al añadir un parámetro a la carga útil, asegúrese de que es name y type son coherentes con la información declarada en la actividad External signal . Además, el tamaño de la carga útil no debe superar los 64 Ko.


Solicitud de ejemplo

Realice una solicitud de GET en el flujo de trabajo.

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<workflowID> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

Devuelve la actividad de señal de flujo de trabajo y la dirección URL de déclencheur asociada.

{
"PKey": "<PKEY>",
"activities": {
  "activity": {
    "signal1": {
      ...
      "trigger": {
        "href": "https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<PKEY>/activities/activity/<PKEY>/trigger/"
        },
        ...
      }
    }
  }
}

Para almacenar en déclencheur una actividad de señal, realice una solicitud de POST en la dirección URL de déclencheur con el "origen". Añada los atributos "parámetros" si desea llamar al flujo de trabajo con parámetros.

-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<PKEY>/activities/activity/<PKEY>/trigger \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>' \
-i
-d '{
-d "source":"API",
-d "parameters":{
-d    "audience":"audience",
-d    "email":"anna.varney@mail.com",
-d    "template":"05",
-d    "contentURL":"http://www.adobe.com",
-d    "test":"true",
-d    "segmentCode":"my segment",
-d    "attribute":"2019-04-03 08:17:19.100Z"}
-d  }'

Si uno de los parámetros no está declarado en la actividad External signal , la solicitud del POST devuelve el error siguiente, indicando qué parámetro falta.

RST-360011 An error has occurred - please contact your administrator.
'contentURL' parameter isn't defined in signal activity.
XTK-170006 Unable to parse expression 'HandleTrigger(@name, $(source), $({parameters}))'.
RST-360000 Error while assessing 'HandleTrigger(@name, $(source), $({parameters}))' expression ('xtk:workflow:execution/activities/signal/trigger' resource)

En esta página