Fazer uma chamada de API de Conteúdo conectado

Use o Conteúdo conectado para inserir qualquer informação acessível por API diretamente nas mensagens que você envia aos usuários. Você pode obter conteúdo diretamente do seu servidor web ou de APIs acessíveis publicamente.

Esta página aborda como fazer chamadas de API de Conteúdo conectado, casos de uso avançados de Conteúdo conectado, tratamento de erros e mais.

Sobre o volume de chamadas de Conteúdo conectado

Importante

Um envio não equivale a uma chamada de Conteúdo conectado. A Braze não garante uma proporção de 1:1 entre envios de mensagens e solicitações de Conteúdo conectado. O sistema é projetado para priorizar a renderização e a entrega corretas das mensagens em vez de minimizar o número de chamadas. Seus endpoints devem ser preparados para lidar com mais solicitações do que o número de destinatários ou mensagens enviadas.

A Braze pode fazer a mesma chamada de API de Conteúdo conectado mais de uma vez por destinatário. Os motivos mais comuns incluem:

• E-mail com múltiplas partes: Um único e-mail pode acionar passes de renderização separados para o corpo HTML, corpo em texto simples e versão Accelerated Mobile Pages (AMP) (se presente). Cada passe pode acionar o Conteúdo conectado naquela parte, então um destinatário pode gerar múltiplas chamadas idênticas ou semelhantes.
• Validação e novas tentativas: As cargas úteis das mensagens podem ser renderizadas múltiplas vezes por destinatário para validação, lógica de nova tentativa ou outros propósitos internos.
• Comportamento do canal: O Conteúdo conectado é executado quando a mensagem é renderizada. Para mensagens no app, a mensagem é renderizada no momento da impressão.

Se você observar mais chamadas de Conteúdo conectado nos seus registros do que envios ou destinatários, esse comportamento é esperado. Para orientações sobre como reduzir a carga e planejar para escala, consulte Práticas recomendadas para endpoints de alto volume.

Enviar uma chamada de Connected Content

Para enviar uma chamada de Connected Content, use a tag {% connected_content %}. Com essa tag, atribua ou declare variáveis usando :save. Aspectos dessas variáveis podem ser referenciados posteriormente na mensagem com Liquid.

Detalhamento da chamada de API

O exemplo a seguir usa a API Sunrise-Sunset e inclui o horário do nascer do sol de hoje em uma mensagem:

1
2
{% connected_content https://api.sunrise-sunset.org/v2?lat=40.7128&lng=-74.0060&date=today :save result %}
Hi there, today's sunrise in NYC is at {{result.sunrise}}.

Veja o que cada parte faz:

Como a resposta da API Sunrise-Sunset funciona

Esse endpoint retorna JSON com campos de nível superior como sunrise, sunset e tzid. Os horários são retornados no fuso horário do local por padrão (neste exemplo, horário de Nova York).

Por exemplo, o formato da resposta é semelhante a:

1
2
3
4
5
6
{
  "date": "2026-07-23",
  "tzid": "America/New_York",
  "sunrise": "2026-07-23T05:42:11-04:00",
  "sunset": "2026-07-23T20:21:32-04:00"
}

Mapear a resposta da API para Liquid

Como a resposta é salva como result, referencie cada campo diretamente a partir desse objeto.

1
2
3
{{result.sunrise}}
{{result.sunset}}
{{result.tzid}}

Use esse padrão sempre que salvar JSON do Connected Content:

1. Salve a resposta da API com :save.
2. Encontre o campo desejado na resposta JSON.
3. Referencie-o em Liquid como saved_variable.field_name.

Adicionar variáveis

Você também pode incluir atributos do perfil de usuário como variáveis na string de URL ao fazer solicitações de Connected Content.

Por exemplo, você pode ter um serviço web que retorna conteúdo com base no endereço de e-mail e no ID de um usuário. Se estiver passando atributos que contêm caracteres especiais, como o arroba (@), use o filtro Liquid url_param_escape para substituir quaisquer caracteres não permitidos em URLs por suas versões escapadas compatíveis com URL, conforme mostrado no atributo de endereço de e-mail a seguir.

1
2
3
Hi, here are some articles that you might find interesting:

{% connected_content http://www.yourwebsite.com/articles?email={{${email_address} | url_param_escape}}&user_id={{${user_id}}} %}

Nota

Os valores de atributo devem estar entre ${} para funcionar corretamente na nossa versão da sintaxe Liquid.

As solicitações de Connected Content suportam apenas solicitações GET e POST.

Tratamento de erros

Se a URL estiver indisponível e retornar uma página 404, a Braze renderiza uma string vazia em seu lugar. Se a URL retornar uma página HTTP 500 ou 502, a URL falhará na lógica de nova tentativa.

Se o endpoint retornar JSON, você pode detectar isso verificando se o valor connected é nulo e, em seguida, interromper condicionalmente a mensagem. A Braze permite apenas URLs que se comunicam pela porta 80 (HTTP) e 443 (HTTPS).

Detecção de host não íntegro

O Connected Content emprega um mecanismo de detecção de host não íntegro para identificar quando o host de destino apresenta uma alta taxa de lentidão significativa ou sobrecarga, resultando em timeouts, excesso de solicitações ou outros resultados que impedem a Braze de se comunicar com sucesso com o endpoint de destino. Ele atua como uma proteção para reduzir a carga desnecessária que pode estar causando dificuldades no host de destino. Também serve para estabilizar a infraestrutura da Braze e manter velocidades rápidas de envio de mensagens.

Se o host de destino apresentar uma alta taxa de lentidão significativa ou sobrecarga, a Braze interrompe temporariamente as solicitações ao host de destino por um minuto, simulando respostas que indicam a falha. Após um minuto, a Braze verifica a integridade do host usando um pequeno número de solicitações antes de retomar as solicitações em velocidade total, caso o host seja considerado íntegro. Se o host ainda estiver não íntegro, a Braze aguarda mais um minuto antes de tentar novamente.

Se as solicitações ao host de destino forem interrompidas pelo detector de host não íntegro, a Braze continua a renderizar mensagens e seguir sua lógica Liquid como se tivesse recebido um código de resposta de erro. Se você quiser garantir que essas solicitações de Connected Content sejam refeitas quando interrompidas pelo detector de host não íntegro, use a opção :retry. Para saber mais sobre a opção :retry, consulte Novas tentativas de Connected Content.

Se você acredita que a detecção de host não íntegro pode estar causando problemas, entre em contato com o suporte da Braze.

Nota

Você pode adicionar URLs específicas a uma lista de permissões para uso com Connected Content. Para acessar esse recurso, entre em contato com seu gerente de sucesso do cliente.

Dica

Para saber mais sobre códigos de erro comuns, consulte Solução de problemas de webhooks e solicitações de Connected Content.

Limites de frequência (429) versus detecção de host não íntegro

Os seguintes são mecanismos diferentes:

• 429 Too Many Requests: Seu endpoint (ou um serviço upstream) está retornando essa resposta. Isso significa que seu servidor ou middleware está recusando tráfego, geralmente porque possui seu próprio limite de frequência. A Braze não aplica um limite de frequência separado ao Connected Content; o volume de solicitações do Connected Content escala diretamente com o limite de frequência de velocidade de entrega de suas mensagens. Como as mensagens podem ser renderizadas várias vezes por destinatário (por exemplo, para HTML de e-mail, texto simples e AMP), o número de solicitações de Connected Content pode exceder esse limite de frequência — não presuma que será menor ou igual ao número de mensagens por minuto que você definiu. Se você estiver recebendo erros 429, escale seu endpoint ou middleware para lidar com o volume de solicitações esperado, ou reduza o limite de frequência de velocidade de entrega da Campaign ou do Canvas para que menos mensagens (e, consequentemente, menos chamadas de Connected Content) sejam enviadas por minuto.
• Detecção de host não íntegro: Uma proteção do lado da Braze que é acionada após uma alta taxa e volume de falhas em uma janela de um minuto. A contagem de falhas inclui os códigos de status 408, 429, 502, 503, 504 e 529. Quando acionada, a Braze interrompe temporariamente as solicitações para esse host e simula uma resposta de falha. Isso é independente do seu próprio limite de frequência. Para limites de detecção e mais detalhes, consulte Solução de problemas de webhooks e solicitações de Connected Content. Para evitar acionar a detecção de host não íntegro, certifique-se de que seu endpoint consiga lidar com o volume de chamadas descrito em Entendendo o volume de chamadas do Connected Content e Práticas recomendadas para endpoints de alto volume.

Garantir desempenho eficiente

Como a Braze entrega mensagens em uma taxa muito rápida, certifique-se de que seu servidor pode lidar com milhares de conexões simultâneas para que não fique sobrecarregado ao buscar conteúdo. Ao usar APIs públicas, confirme que seu uso não violará nenhum limite de frequência que o provedor da API possa aplicar. A Braze exige que o tempo de resposta do servidor seja inferior a dois segundos por motivos de desempenho; se o servidor levar mais de dois segundos para responder, o conteúdo não será inserido.

Para saber mais sobre planejamento de capacidade de endpoints e redução do volume de chamadas, consulte Práticas recomendadas para endpoints de alto volume.

O que você precisa saber

• A Braze não cobra por chamadas de API e elas não contam para o uso de pontos de dados.
• Há um limite de 1 MB para respostas do Connected Content.
• O Connected Content é executado quando a mensagem é renderizada. Para mensagens no app, a mensagem é renderizada no momento da impressão.
• As chamadas do Connected Content não seguem redirecionamentos. Apenas respostas 2xx são tratadas como bem-sucedidas. Se o seu endpoint retornar um redirecionamento 3xx (por exemplo, 301 ou 302), a Braze não seguirá o redirecionamento até a URL final. Para sintomas e etapas de solução de problemas, consulte Por que o Connected Content falha quando meu endpoint retorna um redirecionamento?.

Como as chamadas do Connected Content são processadas

As chamadas do Connected Content dentro de um único modelo de mensagem são executadas sequencialmente (de cima para baixo) durante a renderização do Liquid. Isso significa que chamadas posteriores podem referenciar variáveis definidas por chamadas anteriores. Neste exemplo, a primeira chamada recupera dados do usuário, e a segunda chamada usa esses dados para buscar preferências:

1
2
{% connected_content https://api.example.com/user :save user_data %}
{% connected_content https://api.example.com/preferences?user_id={{user_data.id}} :save preferences %}

Envio global e volume de solicitações

Embora as chamadas do Connected Content sejam executadas sequencialmente dentro de uma única mensagem, as mensagens são enviadas em paralelo nas suas Campaigns e Canvas. Envios de alto volume podem gerar tráfego significativo de solicitações para os seus endpoints durante os períodos de pico de envio. Para gerenciar e controlar esse tráfego — incluindo limites de frequência de envio de mensagens do espaço de trabalho, limite de frequência de velocidade de entrega e cache — consulte Práticas recomendadas para endpoints de alto volume.

Práticas recomendadas para endpoints de alto volume

Se suas mensagens usam Connected Content e você envia em alto volume, planeje para mais solicitações do que o número de destinatários ou envios:

• Estime a carga de pico: Use um multiplicador conservador ao dimensionar seu endpoint ou middleware — as solicitações de Connected Content podem exceder o número de destinatários ou mensagens enviadas. Por exemplo, para e-mail, um único destinatário pode gerar múltiplas chamadas (HTML, texto simples e AMP), então destinatários × 2 ou × 3 é frequentemente usado como uma estimativa conservadora.
• Use cache quando apropriado: Solicitações GET são armazenadas em cache por padrão. Para solicitações POST, adicione :cache_max_age quando a resposta puder ser reutilizada por um período (por exemplo, token ou conteúdo que não muda por solicitação). Consulte Respostas em cache e as Perguntas frequentes sobre cache de POST na seção a seguir.
• Defina limites de frequência de mensagens: Os limites de frequência de envio de mensagens do espaço de trabalho e o limite de frequência de velocidade de entrega em Campaigns ou Canvas limitam indiretamente o volume de solicitações de Connected Content — a Braze não aplica limite de frequência ao Connected Content em si. Esses são indicadores aproximados, não perfeitos, porque as solicitações de Connected Content não são 1:1 com as mensagens. Use-os para manter o volume de mensagens (e, consequentemente, de Connected Content) dentro do que seu endpoint pode suportar.
• Projete para idempotência e novas tentativas: A Braze pode chamar seu endpoint mais de uma vez por destinatário. Certifique-se de que seu endpoint possa tolerar solicitações duplicadas sem efeitos colaterais incorretos.

Tipos de autenticação

Usando autenticação básica

Se a URL exigir autenticação básica, a Braze pode armazenar uma credencial de autenticação básica para você usar na sua chamada de API. Você pode gerenciar credenciais de autenticação básica existentes e adicionar novas em Configurações > Connected Content.

Para adicionar uma nova credencial, selecione Adicionar credencial > Autenticação básica.

Dê um nome à sua credencial e insira o nome de usuário e a senha.

Você pode então usar essa credencial de autenticação básica nas suas chamadas de API referenciando o nome do token:

1
Hi there, here is some fun trivia for you!: {% connected_content https://yourwebsite.com/random/trivia :basic_auth credential_name %}

Nota

Se você excluir uma credencial, tenha em mente que qualquer chamada de Connected Content que tentar usá-la será interrompida.

As credenciais armazenadas se aplicam a solicitações {% connected_content %} enquanto a Braze renderiza uma mensagem. Elas não são aplicadas à solicitação HTTP principal configurada em uma etapa de webhook. Use cabeçalhos de solicitação ou uma tag {% connected_content %} dentro de um campo de cabeçalho ou corpo do webhook quando precisar recuperar segredos para essa chamada.

Usando autenticação por token

Ao usar o Connected Content da Braze, você pode descobrir que certas APIs exigem um token em vez de um nome de usuário e senha. A Braze também pode armazenar credenciais que contêm valores de cabeçalho de autenticação por token.

Para adicionar uma credencial que contém valores de token, selecione Adicionar credencial > Autenticação por token. Em seguida, adicione os pares chave-valor para os cabeçalhos da sua chamada de API e o domínio permitido.

Você pode então usar essa credencial nas suas chamadas de API referenciando o nome da credencial:

1
2
3
4
5
6
7
8
9
{% assign campaign_name="New Year Sale" %}
{% connected_content
     https://api.endpoint.com/your_path
     :method post
     :auth_credentials token_credential_abc
     :body campaign={{campaign_name}}&customer={{${user_id}}}&channel=Braze
     :content_type application/json
     :save publication
%}

Usar Open Authentication (OAuth)

Algumas configurações de API exigem a recuperação de um token de acesso que pode então ser usado para autenticar o endpoint de API que você deseja acessar.

Etapa 1: Recuperar o token de acesso

O exemplo a seguir ilustra a recuperação e o salvamento de um token de acesso em uma variável local, que pode então ser usada para autenticar a chamada de API subsequente. Um parâmetro :cache_max_age pode ser adicionado para corresponder ao tempo de validade do token de acesso e reduzir o número de chamadas de Connected Content de saída. Para saber mais, consulte Cache configurável.

1
2
3
4
5
6
7
8
9
10
{% connected_content
     https://your_API_access_token_endpoint_here/
     :method post
     :auth_credentials access_token_credential_abc
     :headers {
       "Content-Type": "YOUR-CONTENT-TYPE"
     }
     :cache_max_age 900
     :save token_response
%}

Nota

Quando o endpoint de token espera application/x-www-form-urlencoded e você passa credenciais em :body, codifique em URL quaisquer caracteres especiais nos valores dos parâmetros. Por exemplo, barras (/) se tornam %2F e sinais de mais (+) se tornam %2B. Caracteres especiais não codificados podem causar falha nas solicitações de token OAuth.

Etapa 2: Autorizar a API usando o token de acesso recuperado

Depois que o token é salvo, ele pode ser inserido dinamicamente na chamada de Connected Content subsequente para autorizar a solicitação:

1
2
3
4
5
6
7
8
9
{% connected_content
     https://your_API_endpoint_here/
     :headers {
       "Content-Type": "YOUR-CONTENT-TYPE",
       "Authorization": "{{token_response}}"
     }
     :body key1=value1&key2=value2
     :save response
%}

Editando credenciais

Você pode editar o nome da credencial para os tipos de autenticação.

• Para autenticação básica, você pode atualizar o nome de usuário e a senha. Observe que a senha inserida anteriormente não ficará visível.
• Para autenticação por token, você pode atualizar os pares chave-valor do cabeçalho e o domínio permitido. Observe que os valores de cabeçalho definidos anteriormente não ficarão visíveis.

Lista de permissões de IP do Connected Content

Quando uma mensagem usando Connected Content é enviada pela Braze, os servidores da Braze fazem automaticamente solicitações de rede aos servidores de nossos clientes ou de terceiros para obter dados. Com a lista de permissões de IP, você pode verificar se as solicitações de Connected Content estão realmente vindo da Braze, adicionando uma camada de segurança.

A Braze enviará solicitações de Connected Content a partir dos seguintes intervalos de IP. Os intervalos listados são adicionados automática e dinamicamente a quaisquer chaves de API que tenham sido habilitadas para a lista de permissões.

A Braze possui um conjunto reservado de IPs usados para todos os serviços, e nem todos estão ativos em um determinado momento. Isso foi projetado para que a Braze possa enviar a partir de um data center diferente ou realizar manutenção, se necessário, sem impactar os clientes. A Braze pode usar um, um subconjunto ou todos os IPs listados a seguir ao fazer solicitações de Connected Content.

Se as solicitações de Connected Content retornarem consistentemente 403 Forbidden e a autenticação estiver configurada corretamente, adicione esses IPs à lista de permissões no servidor que recebe a solicitação. Um 403 também pode indicar permissões insuficientes ou credenciais inválidas, então confirme tanto as configurações de rede quanto as de autenticação. Para orientações específicas sobre webhooks, consulte 403 Forbidden e lista de permissões de IP.

• united states (us)
• european union (eu)
• australia (au)
• indonesia (id)
• japan (jp)
• south korea (kr)

Usando a lista de permissões de IP com o Amazon S3

Ao usar o Connected Content para recuperar arquivos do Amazon S3, configure seu bucket para permitir solicitações HTTP GET não autenticadas a partir dos endereços IP da Braze.

1. Adicione uma política de bucket com condições de IP: Conceda s3:GetObject nos objetos do seu bucket com Principal: "*" e uma condição IpAddress que use os intervalos de IP da Braze para sua instância. Você não precisa definir ACLs de leitura pública em objetos individuais.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": "*",
      "Action": "s3:GetObject",
      "Resource": "arn:aws:s3:::your-bucket-name/*",
      "Condition": {
        "IpAddress": {
          "aws:SourceIp": ["{YOUR_BRAZE_IP_RANGE}"]
        }
      }
    }
  ]
}

Substitua {YOUR_BRAZE_IP_RANGE} pelos intervalos de IP da Braze para sua instância listados em Lista de permissões de IP do Connected Content. Você pode adicionar um ou mais intervalos como valores separados no array aws:SourceIp.

2. Revise as configurações de Bloqueio de Acesso Público do S3: Políticas de bucket que usam Principal: "*" são tratadas como acesso público pela AWS, mesmo com condições de IP. Pode ser necessário permitir o acesso público baseado em política de bucket enquanto mantém o acesso público baseado em ACL bloqueado.

3. Use a URL do objeto S3 na sua tag de Connected Content: Referencie o objeto com sua URL padrão do S3 (por exemplo, https://your-bucket.s3.amazonaws.com/path/to/object.json).

Para saber mais sobre políticas de bucket e chaves de condição, consulte a documentação da AWS.

Cabeçalho User-Agent

A Braze inclui um cabeçalho User-Agent em todas as solicitações de Connected Content e webhook, semelhante ao seguinte:

1
Braze Sender 75e404755ae1270441f07eb238f0faf25e44dfdc

Dica

Lembre-se de que o valor do hash muda regularmente. Se você estiver filtrando o tráfego por User-Agent, permita todos os valores que começam com Braze Sender.

Solução de problemas

Se a sua chamada de Connected Content não está sendo renderizada corretamente ou não está sendo renderizada, verifique os seguintes detalhes:

• Confirme que uma chamada de Connected Content foi feita: Você pode verificar se uma chamada foi feita na guia Histórico de mensagens. Você também pode fazer um envio de teste de uma única solicitação de Connected Content.
• Verifique por meio do Postman ou de uma solicitação CURL se a solicitação ideal é bem-sucedida: Se a solicitação funcionar e retornar uma resposta, compare a solicitação em detalhes (incluindo os cabeçalhos). Confirme que os cabeçalhos estão capturados em pares de chave-valor com aspas duplas.
• Valide se a autorização está sendo tratada corretamente: Confirme que a opção :basic_auth/:auth_credentials está sendo usada e que a autorização do Connected Content foi adicionada às configurações do espaço de trabalho do Connected Content. Às vezes, a URL do Connected Content exige cabeçalhos além da autenticação que precisam ser inseridos.
• Verifique se os dados estão em um formato esperado: Para o corpo da resposta, a Braze faz o parse de JSON válido em um objeto Liquid; caso contrário, a resposta é tratada como texto simples (incluindo HTML). A opção :content_type define os cabeçalhos Content-Type e Accept de saída na sua solicitação e não afeta o parse da resposta. Para o :body da solicitação, se o seu JSON contiver espaços, siga as orientações na seção Fornecendo corpo JSON.
• Confirme que os dados foram parseados corretamente: Verifique se o Liquid está referenciando corretamente o campo esperado. Para JSON aninhado, use {{sampleresult.data[0].sample_field}} para apontar para o campo aninhado desejado. Você pode verificar as propriedades do JSON aninhado imprimindo o resultado esperado com RESPONSE:{{sampleresult.data}}.
• Verifique o código de status da resposta: O código de status da resposta deve ser um código 2XX. O Connected Content não tem como consumir a resposta quando o código não é 2XX.

Você também pode usar o Webhook.site para solucionar problemas nas suas chamadas de Connected Content e diagnosticar problemas com os cabeçalhos da solicitação, o corpo da solicitação e outras informações que estão sendo enviadas na chamada.

1. Substitua a URL na sua chamada de Connected Content pela URL exclusiva gerada no site.
2. Faça a prévia e teste sua Campaign ou etapa do Canvas para ver as solicitações chegando a esse website.

Você também pode verificar se a Liquid tag inclui os parâmetros que o seu endpoint espera (por exemplo, :method, :headers, :content_type, :body e :basic_auth quando necessário). Se você depende da chave de código de status HTTP em um objeto JSON salvo, o endpoint deve retornar um objeto JSON e um status 2XX.

Para altas taxas de erro do seu host, consulte Detecção de host não íntegro e Volume de chamadas de Connected Content.

Codificação de “e” comercial em solicitações POST de e-mail

Em mensagens de e-mail, o parse de HTML converte automaticamente os “e” comerciais (&) dentro de blocos {% capture %} para &. Para solicitações POST application/x-www-form-urlencoded, isso faz com que a solicitação envie nomes de parâmetros com o prefixo amp; (por exemplo, amp;username), o que pode quebrar a chamada de API.

Para contornar esse problema, use o filtro replace para remover o prefixo amp; antes de passar o corpo para :body:

1
2
3
4
5
6
7
8
9
{% capture body_with_amps %}
grant_type=client_credentials&username=test&password=test
{% endcapture %}
{% connected_content https://api.example.com/token
   :method post
   :body {{body_with_amps | replace: "amp;", ""}}
   :content_type application/x-www-form-urlencoded
   :save token
%}

Perguntas frequentes

Por que o Connected Content falha quando meu endpoint retorna um redirecionamento (301 ou 302)?

Um redirecionamento pode fazer com que o Connected Content renderize em branco na prévia ou no envio, ou registre um erro no Message Activity Log com o código de status HTTP 301 ou 302. O Postman e outros clientes geralmente seguem redirecionamentos automaticamente, então uma URL pode funcionar no Postman, mas falhar na Braze.

Configure seu endpoint para retornar uma resposta 2xx (normalmente 200) com o corpo da resposta na URL que a Braze chama. Se essa URL retornar um redirecionamento, substitua-a pela URL de destino final.

Para verificações relacionadas quando o conteúdo renderiza em branco, consulte O Connected Content não retorna corpo de resposta.

Por que há mais chamadas de Connected Content do que usuários ou envios?

A Braze pode fazer a mesma chamada de API do Connected Content mais de uma vez por destinatário para renderizar a carga útil da mensagem. As cargas úteis das mensagens podem ser renderizadas várias vezes por destinatário para validação, lógica de nova tentativa ou outros fins internos. No entanto, observe que apenas uma das chamadas de Connected Content preenche uma mensagem.

É esperado que uma chamada de API do Connected Content possa ser feita mais de uma vez por destinatário, mesmo que a lógica de nova tentativa não seja usada na chamada. Recomendamos definir o limite de frequência de qualquer mensagem que contenha Connected Content ou configurar seus servidores para lidar melhor com o volume esperado, considerando que várias chamadas de Connected Content são feitas por envio de mensagem.

Consulte Entendendo o volume de chamadas do Connected Content e Práticas recomendadas para endpoints de alto volume para detalhes e mitigação.

Como o limite de frequência funciona com o Connected Content?

O Connected Content não tem seu próprio limite de frequência. Em vez disso, o limite de frequência é baseado na taxa de envio de mensagens. Recomendamos definir o limite de frequência de envio de mensagens acima do limite de frequência pretendido para o Connected Content, caso haja mais chamadas de Connected Content do que mensagens enviadas.

Qual é o comportamento de cache?

As solicitações GET são armazenadas em cache por padrão (consulte Respostas em cache). As solicitações POST não são armazenadas em cache por padrão, mas você pode ativar o cache adicionando :cache_max_age à chamada de Connected Content. Isso pode reduzir a carga no endpoint quando o mesmo POST (por exemplo, uma solicitação de token ou conteúdo) seria feito repetidamente dentro da janela de cache.

1
{% connected_content https://api.example.com/token :method post :body grant_type=client_credentials :cache_max_age 900 :save token %}

O cache pode ajudar a reduzir chamadas duplicadas de Connected Content, mas não garante uma única chamada por usuário. A duração do cache varia entre cinco minutos e quatro horas. Para mais detalhes, consulte Respostas em cache.

Qual é o comportamento HTTP padrão do Connected Content?

Por padrão, o Conteúdo Conectado definirá um cabeçalho Content-Type em uma solicitação HTTP GET para application/json com Accept: */*. Se você precisar de outro tipo de conteúdo, especifique-o explicitamente adicionando :content_type your/content-type à tag. A Braze definirá então tanto o cabeçalho Content-Type quanto o cabeçalho Accept para o tipo que você especificar.

1
{% connected_content https://api.sunrise-sunset.org/v2?lat=40.7128&lng=-74.0060&date=today :content_type application/json %}

Por padrão, o Conteúdo Conectado faz uma solicitação HTTP GET para a URL especificada. Para fazer uma solicitação POST, especifique :method post.

Opcionalmente, você pode fornecer um corpo POST especificando :body seguido por uma string de consulta no formato key1=value1&key2=value2&... ou uma referência a valores capturados. O Content-Type padrão é application/x-www-form-urlencoded. Se você especificar :content_type application/json e fornecer um corpo codificado em formulário, como key1=value1&key2=value2, a Braze codificará automaticamente o corpo em JSON antes de enviar.

O Conteúdo Conectado também não armazena em cache chamadas POST por padrão. Você pode atualizar esse comportamento adicionando :cache_max_age à chamada POST do Conteúdo Conectado.

• tipo de conteúdo padrão
• tipo de conteúdo application/json

1
{% connected_content https://example.com/api/endpoint :method post :body key1=value1&key2=value2 %}

1
{% connected_content https://example.com/api/endpoint :method post :body key1=value1&key2=value2 :content_type application/json %}

O que acontece se eu usar a mesma chamada de Connected Content em vários lugares?

Cada tag de Connected Content é avaliada separadamente, mesmo que várias tags usem a mesma URL e os mesmos parâmetros. Quando a URL e as configurações de cache permitem, solicitações idênticas podem ser servidas a partir do cache em vez de disparar uma nova solicitação de saída (consulte Respostas em cache para mais detalhes).