Show Menu
TÓPICOS×

Acionamento de uma atividade de sinal

Em um fluxo de trabalho do Adobe Campaign Standard, pode haver uma ou mais atividades de sinal ​externo. Essas atividades são "ouvintes" que esperam para serem acionadas.
As APIs de Campaign Standard permitem disparar uma atividade de sinal ​externo para chamar um fluxo de trabalho. A chamada da API pode incluir parâmetros que serão assimilados nas variáveis de eventos do fluxo de trabalho (um nome de audiência para público alvo, um nome de arquivo a ser importado, uma parte do conteúdo da mensagem etc.). Dessa forma, você pode integrar facilmente suas automações de Campanha ao seu sistema externo.
Atividades de sinal externo não podem ser acionadas com mais frequência do que a cada 10 minutos e o fluxo de trabalho de destino já deve estar em execução.
Para acionar um fluxo de trabalho, siga as etapas abaixo:
  1. Execute uma solicitação de GET no fluxo de trabalho para recuperar o URL de disparo da atividade de sinal externo.
    GET https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<workflowID>
  2. Execute uma solicitação de POST no URL retornado para disparar a atividade do sinal, com o parâmetro "source" na carga. Esse atributo é obrigatório, permite que você indique a fonte de solicitação de acionamento.
Se você quiser chamar o fluxo de trabalho com parâmetros, adicione-os à carga com o atributo "parameters" . A sintaxe consiste no nome do parâmetro seguido pelo seu valor (os seguintes tipos são suportados: 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 }

Ao adicionar um parâmetro à carga, verifique se seus valores de nome e tipo são consistentes com as informações declaradas na atividade de sinal externo. Além disso, a carga útil não deve exceder 64 Ko.
Solicitação de amostra
Execute uma solicitação de GET no fluxo de trabalho.
-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 fluxo de trabalho e o url de disparo associado.
{
"PKey": "<PKEY>",
"activities": {
  "activity": {
    "signal1": {
      ...
      "trigger": {
        "href": "https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<PKEY>/activities/activity/<PKEY>/trigger/"
        },
        ...
      }
    }
  }
}

Para disparar uma atividade de sinal, execute uma solicitação de POST no url de disparo com a "fonte". Adicione os atributos "parâmetros" se desejar chamar o fluxo de trabalho 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 de sinal externo, a solicitação de 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)