Show Menu
TEMAS×

Activación de una actividad de señal

En un flujo de trabajo de Adobe Campaign Standard, puede haber una o varias actividades de señal ​externa. Estas actividades son "oyentes" que esperan activarse.
Las API de Campaign Standard permiten activar una actividad de señal ​externa para llamar a un flujo de trabajo. La llamada de API puede incluir parámetros que se ingerirán en las variables de eventos del flujo de trabajo (un nombre de audiencia a destinatario, un nombre de archivo para importar, una parte del contenido del mensaje, etc.). De este modo, puede integrar fácilmente sus automatizaciones de Campaña con su sistema externo.
Las actividades de señales externas no se pueden activar con más frecuencia que cada 10 minutos y el flujo de trabajo de destino debe estar ya en ejecución.
Para activar un flujo de trabajo, siga los pasos a continuación:
  1. Realice una solicitud de GET en el flujo de trabajo para recuperar la dirección URL del activador de actividad de señal externa.
    GET https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<workflowID>
  2. Realice una solicitud de POST en la dirección URL devuelta para activar la actividad de señal, con el parámetro "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 el atributo "parameters" . La sintaxis consiste en el nombre del parámetro seguido de su valor (se admiten los siguientes tipos: cadena , número , booleano y fecha/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 }

Al agregar un parámetro a la carga útil, asegúrese de que sus valores de nombre y tipo sean coherentes con la información declarada en la actividad de señal externa. Además, el tamaño de la carga útil no debe superar los 64 Ko.
Solicitud de muestra
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 activación asociada.
{
"PKey": "<PKEY>",
"activities": {
  "activity": {
    "signal1": {
      ...
      "trigger": {
        "href": "https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<PKEY>/activities/activity/<PKEY>/trigger/"
        },
        ...
      }
    }
  }
}

Para activar una actividad de señal, realice una solicitud de POST en la dirección URL del activador con el "origen". Añada los atributos "parameters" 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 de señal externa, 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)