Trabalhar com integrações padrão external-sources

Navegue até a seção Configurações no menu esquerdo e clique em Gerenciar no cartão Integrações.

Em seguida, clique em Criar integração para iniciar uma nova configuração.

{modal="regular"}

Opcionalmente, cole um comando cURL para preencher automaticamente a URL, o método HTTP, os cabeçalhos e os parâmetros de consulta.

Forneça um Nome e uma Descrição para a integração.

Insira o ponto de extremidade de API URL.

Para variáveis de caminho, envolva um rótulo com chaves duplas na URL, por exemplo, https://api.example.com/v1/products/{{productId}}, e defina cada espaço reservado em Parâmetro de Caminho.

Selecione Habilitar navegação para vincular uma integração de Navegação ativa, de modo que seus campos de resposta possam ser mapeados para variáveis em cabeçalhos, parâmetros de consulta e caminho e a carga.

➡️ Consulte Criar integrações de Navegação

{modal="regular"}

Configure o Parâmetro de Caminho com o Nome e o Valor padrão para cada espaço reservado adicionado à URL.

Observe que Name é um rótulo voltado para o profissional de marketing apenas no editor, ele não é enviado na solicitação de API.

{modal="regular"}

Selecione o Método HTTP entre GET e POST.

Clique em Adicionar cabeçalho e/ou Adicionar parâmetros de consulta conforme necessário para sua integração. Para cada parâmetro, forneça os seguintes detalhes:

• Parâmetro: o cabeçalho real ou o nome do parâmetro de consulta conforme esperado pela API.

• Nome: um rótulo compatível com o profissional de marketing para esse parâmetro, os autores o selecionam ao mapear valores em campanhas.

• Tipo: escolha Constante para um valor fixo ou Variável para entrada dinâmica.

• Valor: insira o valor diretamente para constantes ou selecione um mapeamento de variável.

• Obrigatório: especifique se este parâmetro é obrigatório. Para parâmetros obrigatórios Variable, se nenhum valor for resolvido em tempo de execução e nenhum padrão for fornecido, a geração de solicitações falhará com um erro e a chamada de API de saída não será feita.

{modal="regular"}

Escolha um Tipo de Autenticação:

• Sem Autenticação: para APIs abertas que não exigem credenciais.

• Chave de API: autentique solicitações usando uma chave de API estática. Insira seu Nome da Chave de API ​, Valor da Chave de API ​ e especifique seu Local.

• Autenticação Básica: usar a Autenticação Básica HTTP padrão. Insira Nome de usuário e Senha.

• OAuth 2.0: faça a autenticação usando o protocolo OAuth 2.0. Clique no ícone para configurar ou atualizar a Carga.

{modal="regular"}

Defina a Configuração de política, como o período de Tempo limite, para solicitações de API e opte por habilitar a limitação, o cache e/ou tentar novamente.

Para um método POST, configure a Carga escolhendo um Tipo de corpo:

• JSON: clique no ícone e cole sua carga de solicitação JSON. Mapeie as variáveis que devem ser preenchidas na carga.

• GraphQL: cole sua consulta do GraphQL. O Journey Optimizer gera um nome de operação automaticamente e permite mapear as variáveis de consulta correspondentes.

  {modal="regular"}

Escolha o Tipo de resposta entre JSON e HTML.

Com o campo Carga de resposta, é possível decidir quais campos da saída de exemplo precisam ser usados para a personalização da mensagem.

Clique no ícone e cole uma amostra de carga de resposta JSON para detectar automaticamente os tipos de dados.

Escolha os campos a serem expostos para personalização e especifique os tipos de dados correspondentes.

{modal="regular"}

Quando a URL, o método HTTP, os cabeçalhos e os parâmetros de consulta forem definidos, clique em Enviar conexão de teste para executar um teste de conectividade e confirmar a configuração.

Na caixa de diálogo Enviar conexão de teste, insira valores padrão para quaisquer espaços reservados de Variável no caminho de URL, cabeçalhos e parâmetros de consulta.

Esses valores são incluídos na solicitação de teste. O Journey Optimizer chama o endpoint e relata se a conexão teve êxito ou falhou.

{modal="regular"}

Se o teste retornar uma resposta bem-sucedida, selecione Usar como carga de resposta para copiar o corpo da resposta no campo Carga de resposta, consulte a etapa 10 em Configurar a integração, onde os tipos de dados podem ser detectados e os campos podem ser selecionados para personalização.

{modal="regular"}

Se o teste não for bem-sucedido, expanda o menu suspenso Erro para examinar os detalhes da falha, atualize a configuração de integração conforme necessário e execute Enviar conexão de teste novamente.

{modal="regular"}

Depois de validado, clique em Ativar.

Acesse a integração recém-criada para:

• Atualização: alterar somente detalhes de Autenticação e configuração de política. As atualizações se aplicam a jornadas e campanhas ativas. Antes de salvar as alterações, use o menu Explorar referências para confirmar onde a integração é usada.

• Arquivar: arquivar uma configuração de Integração.

  {modal="regular"}

Após a ativação, clique no ícone do para acessar o menu Explorar referências e revisar o uso dessa configuração, incluindo jornadas e campanhas que dependem dele.

{modal="regular"}