API REST
Busque dados de APIs REST externas diretamente nas suas mensagens no momento do envio usando o Conteúdo conectado. Isso permite personalizar mensagens com informações em tempo real dos seus próprios servidores, serviços de terceiros ou qualquer endpoint de API acessível publicamente.
Como funciona
O Conteúdo Conectado faz uma requisição HTTP para a URL que você especificar e armazena a resposta para que você possa referenciá-la com Liquid. Adicione uma tag {% connected_content %} à sua mensagem, e a Braze chama o endpoint quando a mensagem é enviada.
{% connected_content https://api.example.com/user/{{${user_id}}}/recommendations :save recs %}
We think you'll love {{recs.top_pick}}!
O Conteúdo Conectado aceita requisições GET e POST. A Braze exige que o servidor responda em até dois segundos, então projete seus endpoints para ter baixa latência.
Casos de uso comuns
| Caso de uso | Descrição |
|---|---|
| Recomendações de produtos | Busque sugestões de produtos personalizadas em um mecanismo de recomendação |
| Preços ou estoque em tempo real | Exiba preços atuais ou níveis de estoque no momento do envio |
| Conteúdo baseado no clima | Puxe dados meteorológicos locais para personalizar o envio de mensagens |
| Saldos de pontos de fidelidade | Mostre recompensas ou saldos de conta atualizados |
| Feeds de conteúdo | Insira as publicações de blog, artigos ou notícias mais recentes |
Autenticação
A Braze oferece suporte a autenticação básica, autenticação por token e OAuth em requisições de Conteúdo Conectado. Você pode armazenar credenciais com segurança no dashboard da Braze em Configurações > Gerenciamento de credenciais e referenciá-las nas suas chamadas de API.
Para saber mais, consulte Fazendo uma chamada de API de Conteúdo Conectado.
Tratamento de erros
Se o endpoint retornar um erro ou atingir o tempo limite, a Braze renderiza uma string vazia no lugar da resposta do Conteúdo Conectado. Para detectar falhas, verifique se a variável salva é nula. Então, você pode interromper a mensagem condicionalmente ou exibir um conteúdo de fallback.
Para saber mais, consulte Interrupção do Conteúdo Conectado.
Considerações de performance
Como a Braze entrega mensagens em alto volume, seu servidor precisa lidar com milhares de conexões simultâneas. Use cache quando for apropriado e defina limites de frequência nas suas mensagens para não sobrecarregar endpoints externos.
Para a referência completa de Conteúdo Conectado, consulte Conteúdo Conectado.