Como acionar uma campanha inteligente no Marketo Engage usando a API REST e os tokens

Este tutorial mostra como acionar uma Campanha inteligente no Marketo Engage usando a API REST e personalizar o email usando Meus tokens. Esse caso de uso é ideal para notificações acionadas pelo cliente, como lembretes de webinário, etapas de integração ou acompanhamentos pós-compra.

Caso de uso use-case

Uma pessoa se registra em um webinário por meio de uma plataforma externa (por exemplo, aplicativo personalizado, Pendo, Eventbrite). Você deseja:

Isso pode ser feito usando a API REST e Meus tokens.

Etapa 1: criar a campanha inteligente step-one

Etapa 2: definir o conteúdo do email step-two

Crie ou edite um ativo de email que faça referência à Pessoa e aos Meus Tokens.

Hi {{lead.First Name:default=Customer}}

You're registered for **{{my.WebinarTitle}}**.

Join here: {{my.JoinLink}}

Se você estiver usando um token para inserir dinamicamente uma URL de imagem (por exemplo, {{my.WebinarImage}}), envolva o token em uma tag de imagem do HTML:

<img src="{{my.WebinarImage}}" alt="Webinar banner" />

Etapa 3: adicionar tokens ao programa step-three

Para transmitir valores dinamicamente por meio da API, os tokens já devem existir no Marketo Engage. Você precisará criá-los na guia Meus tokens do seu programa.

Etapa 4: definir regras de qualificação de campanha e ativar a campanha step-four

Etapa 5: acionar a campanha por meio da API REST step-five

Encontrar a ID da campanha find-the-campaign-id

Para acionar uma Campanha Inteligente via API, você precisará da ID da campanha:

Usar o seguinte ponto de extremidade:

POST /rest/v1/campaigns/{campaignId}/trigger.json

Exemplo:

POST /rest/v1/campaigns/1234/trigger.json

Exemplo de corpo da solicitação example-request-body

{
  "input": {
    "leads": [
      {
        "id": 1002200
      }
    ],
    "tokens": [
      {
        "name": "{{my.WebinarTitle}}",
        "value": "Scaling Customer Engagement in 2025"
      },
      {
        "name": "{{my.JoinLink}}",
        "value": "https://webinars.company.com/join/abc123"
      },
      {
        "name": "{{my.WebinarImage}}",
        "value": "https://experienceleague.adobe.com/pt-br/docs/marketo-learn/tutorials/events/media_1c6f338a518ada11550084c8ab3a6bbf554ff6eac.jpeg"
      }
    ]
  }
}

Autorização authorization

Todas as solicitações de API REST do Marketo exigem um token de acesso OAuth 2.0.

Para recuperar o token de acesso, use o seguinte endpoint:

GET /identity/oauth/token?grant_type=client_credentials&client_id=XXX&client_secret=YYY

Depois de receber seu token de acesso, inclua-o como um parâmetro de consulta em todas as solicitações de API:

Authorization: Bearer YOUR_ACCESS_TOKEN

Práticas recomendadas best-practices

Resumo summary

Com essa abordagem, você pode personalizar comunicações usando Campanhas inteligentes acionadas de plataformas externas por meio da API. Isso é útil para cenários como confirmações de registro em webinários, emails de integração e notificações transacionais, tudo isso enquanto injeta dados em tempo real usando Meus tokens.