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.

NOTE
As atividades de sinal externo não podem ser acionadas com mais frequência do que a cada 10 minutos e o workflow de destino já deve estar em execução.

Para acionar um workflow, siga as etapas abaixo:

  1. 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>

  2. 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 }
NOTE
Ao adicionar um parâmetro à carga, verifique se name e type Os valores de são consistentes com as informações declaradas na atividade External signal. Além disso, o tamanho do conteúdo não deve exceder 64Ko.

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)
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff