API REST
Extrae datos de API REST externas directamente en tus mensajes en el momento del envío usando contenido conectado. Esto te permite personalizar mensajes con información en tiempo real de tus propios servidores, servicios de terceros o cualquier punto de conexión de API accesible públicamente.
Cómo funciona
El contenido conectado realiza una solicitud HTTP a la URL que especifiques y luego almacena la respuesta para que puedas hacer referencia a ella con Liquid. Añade una etiqueta {% connected_content %} a tu mensaje, y Braze llama al endpoint cuando se envía el mensaje.
{% connected_content https://api.example.com/user/{{${user_id}}}/recommendations :save recs %}
We think you'll love {{recs.top_pick}}!
El contenido conectado admite solicitudes GET y POST. Braze requiere que el servidor responda en un plazo de dos segundos, así que diseña tus endpoints para que tengan baja latencia.
Casos de uso comunes
| Caso de uso | Descripción |
|---|---|
| Recomendaciones de productos | Obtén selecciones de productos personalizadas desde una herramienta de recomendaciones |
| Precios o inventario en tiempo real | Muestra los precios actuales o los niveles de existencias en el momento del envío |
| Contenido basado en el clima | Extrae datos meteorológicos locales para adaptar la mensajería |
| Saldos de puntos de fidelización | Muestra recompensas o saldos de cuenta actualizados |
| Fuentes de contenido | Inserta las últimas entradas de blog, artículos o noticias |
Autenticación
Braze admite autenticación básica, autenticación por token y OAuth para las solicitudes de contenido conectado. Puedes almacenar credenciales de forma segura en el panel de Braze, en Configuración > Gestión de credenciales, y hacer referencia a ellas en tus llamadas a la API.
Para más información, consulta Realizar una llamada a la API de contenido conectado.
Manejo de errores
Si el endpoint devuelve un error o agota el tiempo de espera, Braze muestra una cadena vacía en lugar de la respuesta del contenido conectado. Puedes detectar los fallos comprobando si la variable guardada es nula y, de forma condicional, cancelar el mensaje o mostrar contenido alternativo.
Para más información, consulta Cancelar el contenido conectado.
Consideraciones de rendimiento
Como Braze entrega mensajes a gran volumen, tu servidor debe poder gestionar miles de conexiones simultáneas. Usa el almacenamiento en caché cuando corresponda y establece límites de velocidad en tus mensajes para evitar sobrecargar endpoints externos.
Para consultar la referencia completa del contenido conectado, consulta Contenido conectado.