Skip to content

Configurar orquestração

O BrazeAI Decisioning Studio™ Go precisa se conectar à sua plataforma de engajamento com clientes (CEP) para orquestrar comunicações personalizadas. Este artigo explica como configurar a integração para cada CEP compatível.

CEPs compatíveis

O Decisioning Studio Go é compatível com as seguintes plataformas de engajamento com clientes:

CEP Tipo de integração Principais recursos
Braze Campaigns disparadas por API Integração nativa, disparo em tempo real
Salesforce Marketing Cloud Journey Builder com eventos de API Automação de consultas de SQL, extensões de dados

Selecione sua CEP abaixo para começar a configuração da integração.

Configurar a integração com a Braze

Para integrar o Decisioning Studio Go com a Braze, você criará uma chave de API, configurará uma campanha disparada por API e fornecerá os identificadores necessários ao portal do Decisioning Studio Go.

Etapa 1: Criar uma chave da API REST

  1. No dashboard da Braze, acesse Settings > APIs and Identifiers > API Keys.
  2. Selecione Create API Key.
  3. Digite um nome para sua chave de API. Um exemplo é “DecisioningStudioGoEmail”.
  4. Selecione as permissões com base nas seguintes categorias:
    • User Data: selecione users.track, users.delete, users.export.ids, users.export.segment
    • Messages: selecione messages.send
    • Campaigns: selecione todas as permissões listadas
    • Canvas: selecione todas as permissões listadas
    • Segments: selecione todas as permissões listadas
    • Templates: selecione todas as permissões listadas
  1. Selecione Create API key.
  2. Copie a chave de API e cole-a no portal do BrazeAI Decisioning Studio™ Go.

Etapa 2: Localizar o nome de exibição do e-mail

  1. No dashboard da Braze, acesse Settings > Email Preferences.
  2. Localize o nome de exibição a ser usado com o BrazeAI Decisioning Studio™ Go.
  3. Copie e cole o From Display Name no portal do BrazeAI Decisioning Studio™ Go como Email Display Name.
  4. Copie e cole o endereço de e-mail associado no portal do BrazeAI Decisioning Studio™ Go como From email address, que combina a parte local e o domínio.

Etapa 3: Encontrar a URL da Braze e o ID do app

Para encontrar a URL da Braze:

  1. Acesse o dashboard da Braze.
  2. Na janela do navegador, a URL da Braze começa com https:// e termina com braze.com. Um exemplo de URL da Braze é https://dashboard-01.braze.com.

Para encontrar o ID do app (chave de API):

  1. No dashboard da Braze, acesse Settings > App Settings.
  2. Acesse o app que você deseja rastrear.
  3. Copie e cole a API Key no portal do BrazeAI Decisioning Studio™ Go.

Etapa 4: Criar uma campanha disparada por API

  1. No dashboard da Braze, acesse Messaging > Campaigns.
  2. Selecione Create Campaign.
  3. Para o tipo da campanha, selecione API Campaign.
  4. Dê um nome à campanha. Um exemplo é “Decisioning Studio Go Email”.

Uma campanha da API chamada "Decisioning Studio Go Email".

  1. Para o canal de envio de mensagens, selecione Email.

Opção para selecionar o canal de envio de mensagens para a campanha da API.

  1. Em Additional Options, marque a caixa de seleção Allow users to become re-eligible to receive campaign.
  2. Para o tempo de re-elegibilidade, insira 1 e selecione Hours no menu suspenso.

Re-elegibilidade para a campanha da API selecionada.

  1. Selecione Save Campaign.

Etapa 5: Copiar os IDs da campanha e da mensagem

  1. Na sua campanha da API, copie o Campaign ID. Em seguida, acesse o portal do BrazeAI Decisioning Studio™ Go e cole o Campaign ID.

Um exemplo de ID de variação de mensagem para copiar e colar.

  1. Copie o Message Variation ID. Em seguida, acesse o portal do BrazeAI Decisioning Studio™ Go e cole o Message Variation ID.

Etapa 6: Localizar um ID de usuário teste

Para testar sua integração, você precisará de um ID de usuário:

Se o seu espaço de trabalho usa criptografia em nível de campo de identificador, qualquer novo usuário teste criado com o endpoint /users/track deve seguir os requisitos de e-mail para espaços de trabalho criptografados. Envie o campo email como o hash HMAC-SHA256 codificado em Base64 do valor do e-mail em letras minúsculas, e envie email_encrypted como o valor de e-mail criptografado gerado com suas chaves de criptografia de IPI configuradas.

  1. No dashboard da Braze, acesse Audience > Search Users.
  2. Pesquise o usuário pelo ID de usuário externo, alias, e-mail, número de telefone ou token por push.
  3. Copie o ID do usuário para referência na sua configuração.

Exemplo de perfil de usuário ao localizar um usuário pelo ID.

Configurar a integração com o SFMC

Para integrar o Decisioning Studio Go com o Salesforce Marketing Cloud, você configurará um pacote de app, criará uma automação de consulta de dados e construirá uma jornada para gerenciar envios disparados.

Parte 1: Configurar um pacote de app do SFMC

  1. Acesse a página inicial do Marketing Cloud.
  2. Abra o menu no cabeçalho global e selecione Setup.
  3. Acesse Apps em Platform Tools na navegação do painel lateral e selecione Installed Packages.
  4. Selecione New para criar um pacote de app.
  5. Dê um nome e uma descrição ao pacote de app.

Um pacote de app com o nome "Experimenter 1 - Test 5".

  1. Selecione Add Component.
  2. Para o Component Type, selecione API Integration. Em seguida, selecione Next.
  3. Para o Integration Type, selecione Server-to-server. Em seguida, selecione Next.
  4. Selecione os seguintes escopos recomendados apenas para o seu pacote de app:
    • Channels > Email > Read, Write, Send
    • Channels > OTT > Read
    • Channels > Push > Read
    • Channels > SMS > Read
    • Channels > Social > Read
    • Channels > Web > Read
    • Assets > Documents and Images > Read, Write
    • Assets > Saved Content > Read, Write
    • Automation > Automations > Read, Write, Execute
    • Automation > Journeys > Read, Write, Execute, Activate/Stop/Pause/Send/Schedule
    • Contacts > Audiences > Read
    • Contacts > List and Subscribers > Read, Write
    • Cross Cloud Platform > Market Audience > View
    • Cross Cloud Platform > Market Audience Member > View
    • Cross Cloud Platform > Marketing Cloud Connect > Read
    • Data > Data Extensions > Read, Write
    • Data > File Locations > Read
    • Data > Tracking Events > Read, Write
    • Event notifications > Callbacks > Read
    • Event notifications > Subscriptions > Read
Mostrar imagem dos escopos recomendados

Os escopos recomendados para o pacote de app do Salesforce Marketing Cloud.

  1. Selecione Save.
  2. Copie e cole os seguintes campos no portal do BrazeAI Decisioning Studio™ Go: Client Id, Client Secret, Authentication Base URI, REST Base URI, SOAP Base URI.

Parte 2: Configurar uma automação de consulta de dados

Etapa 1: Criar uma nova automação

  1. Na página inicial do Salesforce Marketing Cloud, acesse Journey Builder e selecione Automation Studio.

Opção Automation Studio na navegação do Journey Builder.

  1. Selecione New Automation.
  2. Arraste e solte um nó Schedule como a Starting Source.

"Schedule" como a fonte inicial de uma jornada.

  1. No nó Schedule, selecione Configure.
  2. Defina o seguinte para o agendamento:
    • Start Date: dia do calendário de amanhã
    • Time: 12:00 AM
    • Time Zone: (GMT-05:00) Eastern (US & Canada)
  3. Para Repeat, selecione Daily.
  4. Defina este agendamento para nunca terminar.
  5. Selecione Done para salvar o agendamento.

Um agendamento de exemplo definido para 25 de janeiro de 2024 às 12h ET, para repetir todos os dias.

Etapa 2: Criar suas consultas de SQL

Em seguida, crie 2 consultas de SQL: uma consulta de assinantes e uma consulta de engajamento. Essas consultas permitem que o BrazeAI Decisioning Studio™ Go recupere dados para preencher o público e ingerir eventos de engajamento.

Consulta de assinantes:

  1. Arraste e solte uma SQL Query no canvas.
  2. Selecione Choose.
  3. Selecione Create New Query Activity.
  4. Dê um nome e uma chave externa à consulta. Recomendamos usar o nome sugerido e a chave externa para a consulta de assinantes fornecidos no portal do BrazeAI Decisioning Studio™ Go.

Um exemplo "OFE_Subscribers_query_Test5" e a chave externa.

  1. Selecione Next.
  2. No portal do BrazeAI Decisioning Studio™ Go, localize a consulta SQL de dados do sistema em Subscriber Query Resources.
  3. Copie e cole a consulta na caixa de texto e selecione Next.

Um exemplo de consulta na seção de consulta SQL.

  1. No portal do BrazeAI Decisioning Studio™ Go, na seção Resources to use, localize a chave externa da extensão de dados alvo. Em seguida, cole-a na barra de pesquisa para buscar.

Uma chave externa colada na barra de pesquisa.

  1. Selecione a extensão de dados que corresponde à chave externa pesquisada. O nome da extensão de dados alvo também é fornecido no portal do BrazeAI Decisioning Studio™ Go para referência cruzada. A Data Extension para a consulta de assinantes deve terminar com o sufixo BASE_AUDIENCE_DATA.

O nome da extensão de dados que corresponde à chave externa do exemplo.

  1. Selecione Overwrite e depois Next.

Consulta de engajamento:

  1. Arraste e solte uma SQL Query no canvas.

"SQL Query" adicionada como uma atividade na jornada.

  1. Selecione Choose.
  2. Selecione Create New Query Activity.
  3. Dê um nome e uma chave externa à consulta. Recomendamos usar o nome sugerido e a chave externa para a consulta de engajamento fornecidos no portal do BrazeAI Decisioning Studio™ Go.

Um exemplo "OFE_Engagement_query" e a chave externa.

  1. Selecione Next.
  2. No portal do BrazeAI Decisioning Studio™ Go, localize a consulta SQL de dados do sistema em Engagement Query Resources.
  3. Copie e cole a consulta na caixa de texto e selecione Next.

Um exemplo de consulta na seção de consulta SQL.

  1. Localize e selecione a extensão de dados alvo para a consulta de engajamento especificada no portal do BrazeAI Decisioning Studio™ Go.
  1. Selecione Overwrite e depois Next.

O nome da extensão de dados que corresponde à chave externa do exemplo.

Etapa 3: Executar a automação

  1. Dê um nome à automação e selecione Save.

Uma automação de exemplo "OFE_Experimenter_Test5_Automation".

  1. Em seguida, selecione Run Once para confirmar que tudo está funcionando como esperado.
  2. Selecione ambas as consultas e clique em Run.

Uma automação "OFE_Experimenter_Test5_Automation" com uma lista de atividades de consulta SQL selecionadas para executar.

  1. Selecione Run Now.

Uma atividade de consulta SQL selecionada.

Agora você pode verificar se a automação está sendo executada com sucesso. Entre em contato com o suporte da Braze para mais assistência se a automação não estiver funcionando como esperado.

Parte 3: Criar sua jornada no SFMC

Etapa 1: Configurar a jornada

  1. No Salesforce Marketing Cloud, acesse Journey Builder > Journey Builder.
  2. Selecione Create New Journey.
  3. Para o tipo de jornada, selecione Multi-Step Journey e selecione Create.

Uma fonte de entrada de evento de API conectada a um nó de divisão de decisão e múltiplos nós de e-mail.

Etapa 2: Construir a jornada

Criar uma fonte de entrada:

  1. Para a fonte de entrada, arraste API Event para o Journey Builder.

"API Event" selecionado como a fonte de entrada.

  1. No API Event, selecione Create an event.

A opção "criar um evento" no evento de API.

  1. Selecione Select Data Extension. Localize e selecione a extensão de dados na qual o BrazeAI Decisioning Studio™ Go gravará as recomendações.
  2. Selecione Summary para salvar suas alterações.
  3. Selecione Done para salvar o evento de API.

Resumo do evento de API.

Adicionar uma divisão de decisão:

  1. Arraste e solte uma Decision Split após o API Entry Event.
  2. Nos detalhes da Decision Split, selecione Edit para a primeira jornada.

Detalhes da divisão de decisão com o botão "Edit".

  1. Atualize a Decision Split para usar o ID do modelo passado pela extensão de dados de recomendações. Localize o campo apropriado em Journey Data.

A seção de dados da jornada na jornada 1 da divisão de decisão.

  1. Selecione seu evento de entrada e localize o campo de ID do modelo desejado, depois arraste-o para o espaço de trabalho.

O ID do modelo de e-mail a incluir.

  1. Insira o ID do modelo do seu primeiro modelo de e-mail e selecione Done.
  2. Selecione Summary para salvar esta jornada.
  3. Adicione uma jornada para cada um dos seus modelos de e-mail e repita as etapas 4-6 acima para definir os critérios de filtro de modo que o ID do modelo corresponda ao valor de ID de cada modelo.
  4. Selecione Done para salvar o nó da Decision Split.

Duas jornadas em uma divisão de decisão para cada ID de modelo de e-mail.

Adicionar um e-mail para cada divisão de decisão:

  1. Arraste um nó de Email para cada jornada da Decision Split.
  2. Selecione Email e escolha o modelo apropriado para cada jornada (ou seja, o modelo cujo valor de ID corresponda à lógica da sua divisão de decisão).

Um nó de e-mail adicionado à jornada.

Etapa 3: Ativar a jornada

Após configurar sua jornada, ative-a e compartilhe os seguintes detalhes com a equipe do BrazeAI Decisioning Studio™ Go:

  • ID da jornada
  • Nome da jornada
  • Chave de definição do evento de API
  • Chave externa da extensão de dados de recomendações
  1. No portal do BrazeAI Decisioning Studio™ Go, copie o Nome da jornada.
  2. Em seguida, no Salesforce Marketing Cloud Journey Builder, cole o nome da jornada na barra de pesquisa.
  3. Selecione o nome da jornada. Observe que a jornada está atualmente em status de rascunho.
  4. Selecione Validate.

A jornada concluída para ativar.

  1. Em seguida, revise os resultados da validação e selecione Activate.

Recomendações listadas na seção de regras de validação.

  1. No resumo de Activate Journey, selecione Activate novamente.

Resumo da jornada.

Tudo pronto! Agora você pode começar a disparar envios pelo BrazeAI Decisioning Studio™ Go.

Próximos passos

Agora que você configurou a orquestração, prossiga para projetar seu agente:
New Stuff!