Skip to content

Configurar a orquestração

O BrazeAI Decisioning Studio™ Acessar 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 com suporte

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

Selecione seu CEP abaixo para começar a configurar a integração.

Configuração da integração com o Braze

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

Etapa 1: Criar uma chave de API REST

  1. No dashboard do Braze, vá para Configurações > APIs e Identificadores > Chaves de API.
  2. Selecione Create API Key (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
    • Envio de mensagens: selecione messages.send
    • Campanhas: selecione todas as permissões listadas
    • Canva: selecione todas as permissões listadas
    • Segmentos: selecione todas as permissões listadas
    • Modelos: selecione todas as permissões listadas

5. Selecione Create API key (Criar chave de API). 6. Copie a chave de API e cole-a em seu portal BrazeAI Decisioning Studio™ Acessar.

Etapa 2: Localize o nome de exibição de seu e-mail

  1. No painel do Braze, acesse Settings > Email Preferences( Configurações > Preferências de e-mail).
  2. Localize o nome de exibição a ser usado com o BrazeAI Decisioning Studio™ Acessar.
  3. Copie e cole o nome de exibição De no portal do BrazeAI Decisioning Studio™ Acessar como o nome de exibição do e-mail.
  4. Copie e cole o endereço de e-mail associado em seu portal BrazeAI Decisioning Studio™ Acessar como o endereço de e-mail De, que combina a parte de localização e o domínio.

Etapa 3: Encontre seu URL do Braze e o ID do app

Para encontrar seu URL do Braze:

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

Para encontrar seu App ID (chave de API):

  1. No dashboard do Braze, acesse Settings > App Settings (Configurações> Configurações do app).
  2. Acesse o app que deseja rastrear.
  3. Copie e cole a chave de API em seu portal BrazeAI Decisioning Studio™ Acessar.

Etapa 4: Criar uma campanha disparada por API

  1. No dashboard do Braze, acesse Envio de mensagens > Campanhas.
  2. Selecione Criar campanha.
  3. Para seu tipo de campanha, selecione Campanha API.
  4. Dê um nome à campanha. Um exemplo é o “Decisioning Studio Go Email”.

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

5. Para seu canal de envio de mensagens, selecione E-mail.

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

6. Em Additional Options (Opções adicionais), marque a caixa de seleção Allow users to become re-eligible to receive campaign (Permitir que os usuários se tornem elegíveis para receber a campanha ). 7. Para o tempo para se tornar elegível novamente, digite 1 e selecione Horas no menu suspenso.

Reelegível para a campanha da API selecionada.

8. Selecione Save Campaign (Salvar campanha).

Etapa 5: Copie suas IDs de campanha e mensagem

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

Um exemplo de ID de variação de mensagem a ser copiado e colado.

2. Copie o ID da variação de mensagens. Em seguida, acesse o portal do BrazeAI Decisioning Studio™ Acessar e cole o ID da variação da mensagem.

Etapa 6: Localize um ID de usuário teste

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

  1. No dashboard do Braze, acesse Público > Pesquisar usuários.
  2. Procure o usuário por sua ID de usuário externo, alias de usuário, e-mail, número de telefone ou token por push.
  3. Copie o ID do usuário para fazer referência em sua configuração.

Exemplo de perfil de usuário a partir da localização de um usuário com seu ID.

Configuração da integração SFMC

Para integrar o Decisioning Studio Acessar com o Salesforce Marketing Cloud, você configurará um pacote de aplicativos, criará uma automação de consulta de dados e criará um Journey para lidar com envios disparados.

Parte 1: Configure um pacote de aplicativos SFMC

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

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

6. Selecione Add Component (Adicionar componente). 7. Para o tipo de componente, selecione Integração de API. Em seguida, selecione Next. 8. Para o Tipo de integração, selecione Servidor para servidor. Em seguida, selecione Next. 9. Selecione os seguintes escopos recomendados apenas para seu pacote de aplicativos: - Canais > E-mail > Ler, escrever, enviar - Canais > OTT > Ler - Canais > Push > Ler - Canais > SMS > Ler - Canais > Social > Ler - Canais > Web > Ler - Ativos > Documentos e imagens > Ler, escrever - Ativos > Conteúdo salvo > Ler, escrever - Automation > Automations > Read, Write, Execute - Automation > Journeys > Ler, escrever, executar, ativar/interromper/pausar/enviar/agendar - Contatos > Públicos > Ler - Contatos > Lista e assinantes > Ler, escrever - Plataforma Cross Cloud > Público do mercado > Visualizar - Plataforma Cross Cloud > Membro do público do mercado > Visualizar - Cross Cloud Platform > Marketing Cloud Connect > Ler - Dados > Extensões de dados > Leitura, gravação - Dados > Locais de arquivos > Ler - Dados > Eventos de rastreamento > Leitura, gravação - Notificações de eventos > Retornos de chamada > Ler - Notificações de eventos > Inscrições > Ler

Show image of recommended scopes

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

10. Selecione Salvar. 11. Copie e cole os seguintes campos no portal do BrazeAI Decisioning Studio™ Acessar: ID do cliente, segredo do cliente, URI da base de autenticação, URI da base REST, URI da base SOAP.

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

Etapa 1: Criar uma nova automação

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

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

2. Selecione Nova automação. 3. Arraste e solte um nó Schedule como fonte inicial.

"Schedule" como a fonte inicial de uma Jornada.

4. No nó Schedule, selecione Configure. 5. Defina o seguinte para a programação: - Data de início: Dia do calendário de amanhã - Tempo: 12:00 AM - Fuso horário: (GMT-05:00) Leste (EUA & Canadá) 6. Para Repetir, selecione Diariamente. 7. Defina essa programação para nunca terminar. 8. Selecione Done (Concluído ) para salvar a programação.

Um exemplo de programação definida para 25 de janeiro de 2024 às 12 horas ET, a ser repetida todos os dias.

Etapa 2: Crie suas consultas de SQL

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

Consulta dos assinantes:

  1. Arraste e solte uma consulta de SQL na tela.
  2. Selecione Selecionar.
  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 do assinante fornecida em seu portal BrazeAI Decisioning Studio™ Acessar.

Um exemplo "OFE_Subscribers_query_Test5" e a chave externa.

5. Selecione Próximo. 6. Em seu portal BrazeAI Decisioning Studio™ Acessar, localize a consulta de SQL de dados do sistema em Recursos de consulta do assinante. 7. Copie e cole a consulta na caixa de texto e selecione Next (Avançar).

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

8. Em seu portal BrazeAI Decisioning Studio™ Acessar, na seção Recursos a serem usados, localize a chave externa da extensão de dados de direcionamento. Em seguida, cole-o na barra de pesquisa para pesquisar.

Uma chave externa colada na barra de pesquisa

9. Selecione a extensão de dados que corresponde à chave externa que você pesquisou. O nome da extensão de dados de direcionamento também é fornecido em seu portal BrazeAI Decisioning Studio™ Acessar para referência cruzada. A extensão de dados para a consulta do assinante deve terminar com um sufixo BASE_AUDIENCE_DATA.

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

10. Selecione Overwrite e, em seguida, Next.

Consulta sobre engajamento:

  1. Arraste e solte uma consulta de SQL na tela.

"Consultas de SQL" adicionadas como uma atividade no Journey.

2. Selecione Selecionar. 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 engajamento fornecida em seu portal BrazeAI Decisioning Studio™ Acessar.

Um exemplo "OFE_Engagement_query" e a chave externa.

5. Selecione Próximo. 6. Em seu portal BrazeAI Decisioning Studio™ Acessar, localize a consulta de SQL de dados do sistema em Recursos de consulta de engajamento. 7. Copie e cole a consulta na caixa de texto e selecione Next (Avançar).

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

8. Localize e selecione a extensão de dados de direcionamento para a consulta de engajamento especificada em seu portal BrazeAI Decisioning Studio™ Acessar.

9. Selecione Overwrite e, em seguida, Next.

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

Etapa 3: Executar a automação

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

Um exemplo de automação "OFE_Experimenter_Test5_Automation".

2. Em seguida, selecione Run Once para confirmar que tudo está funcionando como esperado. 3. Selecione ambas as consultas e selecione Run (Executar).

Uma automação "OFE_Experimenter_Test5_Automation" com uma lista de atividades de consultas de SQL selecionadas a serem executadas.

4. Selecione Run Now (Executar agora).

Uma atividade de consulta de SQL selecionada.

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

Parte 3: Crie sua jornada na SFMC

Etapa 1: Configurar a jornada

  1. No Salesforce Marketing Cloud, acesse Journey Builder > Journey Builder.
  2. Selecione Create New Journey (Criar nova jornada).
  3. Para seu tipo de jornada, selecione Multi-Step Journey (Jornada em várias etapas) e, em seguida, selecione Create (Criar).

Uma fonte de entrada de evento de API conectada a um nó de divisão de decisão e a vários nós de e-mail.

Etapa 2: Construir a jornada

Criar uma fonte de entrada:

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

"Evento API" selecionado como a fonte de entrada.

2. Em API Event (Evento API), selecione Create an event (Criar um evento).

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

3. Selecione Select Data Extension (Selecionar extensão de dados). Localize e selecione a extensão de dados para a qual o BrazeAI Decisioning Studio™ Acessará as recomendações. 4. Selecione Summary (Resumo ) para salvar suas alterações. 5. Selecione Concluído para salvar o evento da API.

Resumo do evento da 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 "Edit" (Editar).

3. 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 Journey Data.

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

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

O ID do modelo de e-mail a ser incluído.

5. Digite o ID do modelo de seu primeiro modelo de e-mail e selecione Concluído. 6. Selecione Summary (Resumo ) para salvar essa jornada. 7. Adicione uma jornada para cada um de seus modelos de e-mail e, em seguida, repita as etapas 4 a 6 acima para definir os critérios de filtro de modo que o ID do modelo corresponda ao valor de ID de cada modelo. 8. Selecione Concluído para salvar o nó Divisão de decisão.

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

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

  1. Arraste um nó Envio de e-mail para cada jornada da divisão de decisão.
  2. Selecione Envio de e-mail e, em seguida, selecione o modelo apropriado que deve ir em cada jornada (ou seja, o modelo com o valor de ID deve corresponder à lógica em sua divisão de decisão).

Um nó de e-mail adicionado à Jornada.

Etapa 3: Ativar a jornada

Depois de configurar sua Journey, ative-a e compartilhe os seguintes detalhes com a equipe do BrazeAI Decisioning Studio™ Acessar:

  • ID da viagem
  • Nome da viagem
  • Chave de definição de evento da API
  • Recomendações chave externa de extensão de dados
  1. No portal do BrazeAI Decisioning Studio™ Acessar, 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 viagem. Note que a Jornada está atualmente no status de Rascunho.
  4. Selecione Validate (Validar).

A jornada completa para ativar.

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

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

6. No resumo de Activate Journey, selecione Activate again ( Ativar novamente).

Resumo para a jornada.

Está tudo pronto! Agora você pode começar a disparar envios por meio do BrazeAI Decisioning Studio™ Acessar.

Configuração da integração com o Klaviyo

Para integrar o Decisioning Studio Acessar o Klaviyo, você configurará uma chave de API, criará um fluxo de modelo de espaço reservado e construirá um fluxo para lidar com envios disparados.

Parte 1: Configurar as chaves de API do Klaviyo

  1. No Klaviyo, acesse Configurações > Chaves de API.
  2. Selecione Create Private API Key (Criar chave de API privada).
  3. Digite um nome para a chave de API. Um exemplo é o “Decisioning Studio Experimenters”.
  4. Selecione as seguintes permissões para a chave de API:
    • Campanhas: Ler Acesso
    • Privacidade de dados: Acesso completo
    • Eventos: Acesso completo
    • Fluxos: Acesso completo
    • Imagens: Ler Acesso
    • Lista: Acesso completo
    • Métricas: Acesso completo
    • Perfis: Acesso completo
    • Segmentos: Ler Acesso
    • Modelos: Acesso completo
    • Webhooks: Ler Acesso

Uma chave de API da Klaviyo com as permissões selecionadas.

5. Selecione Criar. 6. Copie essa chave de API e cole-a no portal do BrazeAI Decisioning Studio™ Acessar onde for solicitado.

Parte 2: Criar um modelo de espaço reservado no Klaviyo

O BrazeAI Decisioning Studio™ Acessar importa modelos que estão associados a fluxos existentes em sua conta Klaviyo. Para usar um modelo que não esteja associado a nenhum fluxo, você pode criar um fluxo de espaço reservado contendo os modelos que gostaria de usar. O fluxo pode ser deixado como um rascunho; não precisa ser ao vivo.

Etapa 1: Configure seu fluxo

  1. No Klaviyo, selecione Flows (Fluxos).
  2. Selecione Criar fluxo > Criar do zero.
  3. Dê ao fluxo de espaço reservado um nome que você reconheça e, em seguida, selecione Criar fluxo.

Um fluxo chamado "OFE Placeholder Flow".

4. Selecione qualquer disparador e salve o fluxo. 5. Selecione Confirmar e salvar.

Etapa 2: Criar o modelo de espaço reservado

  1. Arraste e solte um nó de e-mail após o disparador.

Um fluxo com um nó de disparo seguido de um nó de e-mail.

2. No nó E-mail, selecione Selecionar modelo. 3. Em seguida, escolha o modelo a ser usado e selecione Usar modelo. 4. Selecione Salvar > Concluído. 5. (Opcional) Para adicionar mais modelos a serem usados no BrazeAI Decisioning Studio™ Acessar, adicione outro nó de e-mail e repita as etapas 2 a 4. 6. Deixe todos os e-mails no modo Rascunho e saia do Flow.

No portal do BrazeAI Decisioning Studio™ Acessar, seus modelos devem ser selecionáveis em seu fluxo de espaço reservado.

Um exemplo de um modelo Klaviyo de espaço reservado no portal do Decisioning Studio Acessar.

Parte 3: Criar um fluxo no Klaviyo

Antes de criar um fluxo no Klaviyo, você deve ter os seguintes detalhes do seu portal BrazeAI Decisioning Studio™ Acessar para referência:

  • Nome do fluxo
  • Nome do evento de gatilho

Etapa 1: Configurar o fluxo

  1. No Klaviyo, selecione Flows > Create flow( Fluxos > Criar fluxo).
  2. Selecione Construir o seu próprio.
  3. Para Nome, digite o nome do fluxo de seu portal BrazeAI Decisioning Studio™ Acessar. Em seguida, selecione Criar manualmente.

A opção "Criar manualmente" foi selecionada para um fluxo de exemplo.

4. Selecione o disparador. 5. Faça a correspondência entre o nome da métrica e o nome do evento de gatilho de seu portal BrazeAI Decisioning Studio™ Acessar.

Um exemplo de nome de métrica que corresponde ao nome do evento de gatilho "OFE_TEST_CASE_API_EVENT_TRIGGER".

6. Selecione Salvar.

Etapa 2: Adicione um e-mail ao seu fluxo (modelo único)

  1. Arraste e solte um nó de e-mail após o nó Trigger.
  2. Nos detalhes do e-mail, selecione Selecionar modelo.

Opção "Select template" (Selecionar modelo) na seção "Email details" (Detalhes do e-mail).

3. Encontre e selecione seu modelo básico. É possível procurar seu modelo pelo nome do modelo na seção Recursos a serem usados do portal BrazeAI Decisioning Studio™ Acessar.

Um exemplo de modelo básico no Klaviyo.

4. Selecione Usar modelo > Salvar. 5. Na linha de assunto, digite {{event.SubjectLine}}. 6. Para Nome do remetente e Endereço de e-mail do remetente, digite os detalhes que deseja usar.

Um exemplo de linha de assunto, nome do remetente e endereço de e-mail do remetente para "E-mail 1".

7. Selecione Concluído. 8. Desmarque a caixa de seleção Ignorar perfis enviados recentemente por e-mail e selecione Salvar. 9. No nó do e-mail, atualize o modo de Rascunho para Ativo.

O editor de fluxo do Klaviyo mostra um nó de disparo conectado a um nó de e-mail.

Está tudo pronto! Agora você pode disparar ativações por meio do BrazeAI Decisioning Studio™ Acessar.

Etapa 3: Adicione uma divisão de disparo ao seu fluxo (vários modelos)

  1. Arraste e solte um nó de divisão de disparo após o nó de disparo.
  2. Selecione o nó de divisão Trigger e defina a Dimensão como EmailTemplateID.

Diagrama de fluxo do Klaviyo mostrando um nó de disparo alimentando uma divisão de disparo configurada com Dimension EmailTemplateID.

Adicione seu modelo de e-mail:

  1. No portal do BrazeAI Decisioning Studio™ Acessar, encontre a ID do envio de e-mail para seu primeiro modelo na seção Recursos a serem usados. Digite o ID do modelo de e-mail para o campo Dimensão e, em seguida, selecione Salvar.
  2. Arraste e solte um nó de e-mail no ramo Yes da divisão Trigger.

Um fluxo do Klaviyo com um nó de divisão de disparo, que tem um ramo Sim que leva a um nó de e-mail e um ramo Não que se conecta a outra divisão de disparo.

3. Nos detalhes do e-mail, selecione Selecionar modelo. 4. Encontre e selecione seu modelo básico. É possível procurar seu modelo pelo nome do modelo base na seção Recursos a serem usados do portal BrazeAI Decisioning Studio™ Acessar. 5. Selecione Usar modelo > Salvar. 6. Na linha de assunto, digite {{event.SubjectLine}}. 7. Para Nome do remetente e Endereço de e-mail do remetente, digite os detalhes que deseja usar.

Um modelo de e-mail selecionado e campos para a linha de assunto, o nome do remetente e o endereço de e-mail do remetente.

8. Selecione Concluído. 9. Desmarque a caixa de seleção Ignorar perfis enviados recentemente por e-mail e selecione Salvar. 10. No nó do e-mail, atualize o modo de Rascunho para Ativo.

Adicione uma nova divisão de disparo para cada modelo adicional:

  1. Arraste e solte outro nó de divisão Trigger no ramo No do nó de divisão Trigger anterior.
  2. Defina a Dimensão como EmailTemplateID e preencha o valor da Dimensão com o ID do modelo de e-mail do modelo básico que está configurando.
  3. Selecione Salvar.

Diagrama de um editor de fluxo do Klaviyo mostrando um nó Trigger que leva a uma divisão Trigger. A divisão do disparador tem um ramo Sim que leva a um nó de e-mail e um ramo Não que se conecta a outra divisão do disparador que leva a nós de e-mail adicionais.

4. Arraste e solte um nó de e-mail no ramo Yes (Sim ) de sua nova divisão de disparo. 5. Repita as etapas de configuração do modelo de e-mail acima para selecionar o modelo correspondente. 6. Defina a linha de assunto como {{event.SubjectLine}} e desmarque a caixa de seleção Ignorar perfis enviados recentemente por e-mail. 7. Repita esse processo até ter um nó de divisão de disparo e um nó de e-mail para cada modelo de base que seu experimentador estiver usando. Sua última divisão do disparador não deve ter nada na ramificação “Não”.

Um fluxo do Klaviyo com vários nós de divisão de disparo que se ramificam para vários nós de e-mail.

8. Em cada um de seus nós de e-mail, atualize o modo de Rascunho para Ativo.

A opção de atualizar o status do nó para "Live".

Está tudo pronto! Agora você pode disparar ativações por meio do BrazeAI Decisioning Studio™ Acessar.

Próximos passos

Agora que você configurou a orquestração, prossiga para projetar seu agente:
Github   Editar esta página no GitHub
New Stuff!