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:

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 Configurações > APIs e identificadores > Chaves de API.
  2. Selecione Criar chave de API.
  3. Digite um nome para sua chave de API. Um exemplo é “DecisioningStudioGoEmail”.
  4. Selecione as permissões com base nas seguintes categorias:
    • Dados de usuários: selecione users.track, users.delete, users.export.ids, users.export.segment
    • Mensagens: selecione messages.send
    • Campanhas: selecione todas as permissões listadas
    • Canvas: selecione todas as permissões listadas
    • Segmentos: selecione todas as permissões listadas
    • Modelos: selecione todas as permissões listadas
  1. Selecione Criar chave de API.
  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 Configurações > Preferências de e-mail.
  2. Localize o nome de exibição a ser usado com o BrazeAI Decisioning Studio™ Go.
  3. Copie e cole o Nome de exibição do remetente no portal do BrazeAI Decisioning Studio™ Go como Nome de exibição do e-mail.
  4. Copie e cole o endereço de e-mail associado no portal do BrazeAI Decisioning Studio™ Go como Endereço de e-mail do remetente, 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 Configurações > Configurações do app.
  2. Acesse o app que você deseja rastrear.
  3. Copie e cole a chave de API no portal do BrazeAI Decisioning Studio™ Go.

Etapa 4: Criar uma campanha disparada por API

  1. No dashboard da Braze, acesse Envio de mensagens > Campanhas.
  2. Selecione Criar campanha.
  3. Para o tipo da campanha, selecione Campanha da API.
  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 E-mail.

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

  1. Em Opções adicionais, marque a caixa de seleção Permitir que os usuários se tornem re-elegíveis para receber a campanha.
  2. Para o tempo de re-elegibilidade, insira 1 e selecione Horas no menu suspenso.

Re-elegibilidade para a campanha da API selecionada.

  1. Selecione Salvar campanha.

Etapa 5: Copiar os IDs da campanha e da mensagem

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

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

  1. Copie o ID de variação de mensagem. Em seguida, acesse o portal do BrazeAI Decisioning Studio™ Go e cole o ID de variação de mensagem.

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 Público > Pesquisar usuários.
  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 Configuração.
  3. Acesse Apps em Ferramentas da plataforma na navegação do painel lateral e selecione Pacotes instalados.
  4. Selecione Novo 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 Adicionar componente.
  2. Para o Tipo de componente, selecione Integração de API. Em seguida, selecione Próximo.
  3. Para o Tipo de integração, selecione Servidor para servidor. Em seguida, selecione Próximo.
  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 Salvar.
  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 Nova automação.
  2. Arraste e solte um nó Programar como a Fonte inicial.

"Programar" como a fonte inicial de uma jornada.

  1. No nó Programar, selecione Configurar.
  2. Defina o seguinte para o agendamento:
    • Data de início: dia do calendário de amanhã
    • Hora: 12:00 AM
    • Fuso horário: (GMT-05:00) Eastern (US & Canada)
  3. Para Repetir, selecione Diariamente.
  4. Defina este agendamento para nunca terminar.
  5. Selecione Concluído 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 Consulta SQL no canvas.
  2. Selecione Escolher.
  3. Selecione Criar nova atividade de consulta.
  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 Próximo.
  2. No portal do BrazeAI Decisioning Studio™ Go, localize a consulta SQL de dados do sistema em Recursos de consulta de assinantes.
  3. Copie e cole a consulta na caixa de texto e selecione Próximo.

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

  1. No portal do BrazeAI Decisioning Studio™ Go, na seção Recursos a usar, 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 Extensão de dados 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 Substituir e depois Próximo.

Consulta de engajamento:

  1. Arraste e solte uma Consulta SQL no canvas.

"Consulta SQL" adicionada como uma atividade na jornada.

  1. Selecione Escolher.
  2. Selecione Criar nova atividade de consulta.
  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 Próximo.
  2. No portal do BrazeAI Decisioning Studio™ Go, localize a consulta SQL de dados do sistema em Recursos de consulta de engajamento.
  3. Copie e cole a consulta na caixa de texto e selecione Próximo.

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 Substituir e depois Próximo.

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

Uma automação de exemplo "OFE_Experimenter_Test5_Automation".

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

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

  1. Selecione Executar agora.

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 Criar nova jornada.
  3. Para o tipo de jornada, selecione Jornada de múltiplas etapas e selecione Criar.

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 Evento de API para o Journey Builder.

"Evento de API" selecionado como a fonte de entrada.

  1. No Evento de API, selecione Criar um evento.

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

  1. Selecione Selecionar extensão de dados. Localize e selecione a extensão de dados na qual o BrazeAI Decisioning Studio™ Go gravará as recomendações.
  2. Selecione Resumo para salvar suas alterações.
  3. Selecione Concluído para salvar o evento de API.

Resumo do evento de API.

Adicionar uma divisão de decisão:

  1. Arraste e solte uma Divisão de decisão após o Evento de entrada da API.
  2. Nos detalhes da Divisão de decisão, selecione Editar para a primeira jornada.

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

  1. Atualize a Divisão de decisão para usar o ID do modelo passado pela extensão de dados de recomendações. Localize o campo apropriado em Dados da jornada.

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 Concluído.
  2. Selecione Resumo 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 Concluído para salvar o nó da Divisão de decisão.

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 E-mail para cada jornada da Divisão de decisão.
  2. Selecione E-mail 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 Validar.

A jornada concluída para ativar.

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

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

  1. No resumo de Ativar jornada, selecione Ativar 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!