Acionamento de uma atividade de sinal triggering-a-signal-activity
Em um fluxo de trabalho do Adobe Campaign Standard, pode haver um ou mais Sinal externo atividades. Essas atividades são "ouvintes" que aguardam para serem acionados.
As APIs Campaign Standard permitem acionar um Sinal externo atividade para chamar um workflow. A chamada de API pode incluir parâmetros que serão assimilados nas variáveis de eventos do fluxo de trabalho (um nome de público-alvo para direcionamento, um nome de arquivo para importar, uma parte do conteúdo da mensagem etc.). Dessa forma, você pode integrar facilmente as automações do Campaign ao sistema externo.
Para acionar um workflow, siga as etapas abaixo:
-
Execute um GET no fluxo de trabalho para recuperar o URL do acionador da atividade de sinal externo.
GET https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<workflowID>
-
Execute um POST no URL retornado para acionar a atividade de sinal, com a variável "source" parâmetro na carga útil. Esse atributo é obrigatório e permite indicar a origem da solicitação de acionamento.
Se quiser chamar o workflow com parâmetros, adicione-os à carga com o "parâmetros" atributo. A sintaxe consiste no nome do parâmetro seguido por seu valor (os seguintes tipos são compatíveis: string, número, booleano e data/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 }
Exemplo de solicitação
Execute uma solicitação GET no workflow.
-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>'
Ele retorna a atividade do sinal de workflow e o url de acionador associado.
{
"PKey": "<PKEY>",
"activities": {
"activity": {
"signal1": {
...
"trigger": {
"href": "https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<PKEY>/activities/activity/<PKEY>/trigger/"
},
...
}
}
}
}
Para acionar uma atividade de sinal, execute uma solicitação POST no url do acionador com a "origem". Adicione os atributos "parameters" se quiser chamar o workflow com 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 }'
Se um dos parâmetros não for declarado na atividade External signal, a solicitação POST retornará o erro abaixo, indicando qual parâmetro está ausente.
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)