Attivazione di attività di segnale triggering-a-signal-activity
In un flusso di lavoro Adobe Campaign Standard possono essere presenti una o più attività External signal. Queste attività sono "listener" che attendono di essere attivate.
Le API Campaign Standard consentono di attivare un'attività External signal per richiamare un flusso di lavoro. La chiamata API può includere parametri che verranno acquisiti nelle variabili degli eventi del flusso di lavoro (un nome di pubblico per il target, un nome di file da importare, una parte del contenuto del messaggio, ecc.). In questo modo, puoi integrare facilmente le automazioni di Campaign con il sistema esterno.
Per attivare un flusso di lavoro, effettua le seguenti operazioni:
-
Esegui una richiesta GET nel flusso di lavoro per recuperare l'URL del trigger dell'attività del segnale esterno.
GET https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<workflowID> -
Esegui una richiesta POST sull'URL restituito per attivare l'attività del segnale, con il parametro "source" nel payload. Questo attributo è obbligatorio e consente di indicare l’origine della richiesta di attivazione.
Se desideri chiamare il flusso di lavoro con i parametri, aggiungili al payload con l'attributo "parameters". La sintassi è costituita dal nome del parametro seguito dal relativo valore (sono supportati i tipi seguenti: string, number, boolean e date/time).
-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 }
Richiesta di esempio
Esegui una richiesta di GET sul flusso di lavoro.
-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>'
Restituisce l’attività del segnale del flusso di lavoro e l’URL del trigger associato.
{
"PKey": "<PKEY>",
"activities": {
"activity": {
"signal1": {
...
"trigger": {
"href": "https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<PKEY>/activities/activity/<PKEY>/trigger/"
},
...
}
}
}
}
Per attivare un’attività di segnale, esegui una richiesta POST sull’URL del trigger con la "sorgente". Aggiungi gli attributi "parameters" se desideri chiamare il flusso di lavoro con i parametri.
-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 }'
Se uno dei parametri non è dichiarato nell’attività External signal, la richiesta POST restituisce l’errore seguente, che indica quale parametro risulta mancante.
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)