Ir al contenido

Contentful

Contentful es un sistema de gestión de contenidos headless que permite a los equipos crear, gestionar y distribuir contenido estructurado en cualquier canal. La aplicación de Braze para Contentful conecta ese contenido directamente con tu mensajería de Braze: puedes incorporar entradas de Contentful en los mensajes de forma dinámica en el momento del envío con contenido conectado, o sincronizar campos seleccionados en Content Blocks de Braze para reutilizarlos en Campaigns y Canvas.

Esta integración está gestionada por Contentful.

Acerca de esta integración

Esta página explica cómo configurar la aplicación de Braze en Contentful y cómo utilizar activos de Contentful en Braze. Con esta integración, puedes:

  • Generar una llamada de contenido conectado de Braze lista para pegar para una entrada publicada, junto con las etiquetas de Liquid necesarias para hacer referencia a cada campo en un mensaje de Braze.
  • Sincronizar campos seleccionados de una entrada en un bloque de contenido de Braze, con una configuración regional elegida, para que el contenido esté disponible de forma nativa en el panel de Braze.

El resultado es una única fuente de verdad para el contenido. Los editores de contenido siguen trabajando en Contentful con sus flujos de trabajo de revisión y localización existentes, y los especialistas en marketing crean Campaigns en Braze con contenido que ya está aprobado y actualizado.

Requisitos previos

Antes de empezar, necesitas lo siguiente:

Requisito Descripción
Una cuenta de Contentful Una cuenta de Contentful con acceso de administrador de espacio al espacio donde instalas la aplicación.
Una clave de API de Contentful Una clave de la API de entrega de contenido (CDA) de Contentful con acceso de lectura. Créala en Contentful desde Configuración > Claves de API.
Una clave de API REST de Braze Una clave de API REST de Braze con los permisos content_blocks.create, content_blocks.update, content_blocks.info y content_blocks.list. Crea esta clave en el panel de Braze desde Configuración > Claves de API. Solo es obligatoria para la sincronización de Content Blocks.
Un endpoint REST de Braze La URL de tu endpoint REST de Braze. Tu endpoint depende de la URL de Braze de tu instancia. Solo es obligatorio para la sincronización de Content Blocks.

Integración

Paso 1: Instalar la aplicación de Braze en Contentful

  1. Inicia sesión en la aplicación web de Contentful.
  2. Selecciona Apps > Marketplace.
  3. Localiza la aplicación de Braze y selecciónala.
  4. Selecciona Install. Aparecerá la ventana Manage app access.
  5. En Environments, selecciona los entornos en los que deseas instalar la aplicación.
  6. Selecciona Authorize access. Aparecerá la pantalla de configuración de la aplicación.
  7. En Contentful API key, introduce tu clave de API de Content Delivery.
  8. Para habilitar la sincronización de Content Blocks, introduce tu clave de API REST de Braze y selecciona tu endpoint REST de Braze.
  9. Selecciona Install to selected environments.

Paso 2: Añadir la aplicación de Braze a un tipo de contenido

  1. En la aplicación web de Contentful, ve a la pestaña Content model.
  2. Selecciona un tipo de contenido existente o crea uno nuevo.
  3. Desplázate hasta la sección Sidebar.
  4. Añade Braze de la lista de elementos disponibles.
  5. Selecciona Save.

Repite este proceso para cada tipo de contenido que desees poner a disposición de Braze.

Paso 3: Conectar una entrada a Braze

  1. Ve a la pestaña Content y selecciona Add entry, eligiendo un tipo de contenido que tenga la aplicación de Braze en su barra lateral. También puedes abrir una entrada existente.
  2. Rellena los campos de la entrada y publica la entrada. Braze solo puede recuperar contenido publicado.
  3. En la barra lateral de la entrada, selecciona Generate Braze Connected Content para generar una llamada de contenido conectado y etiquetas de Liquid que puedas pegar en un mensaje de Braze, o Create Content Block para enviar los campos seleccionados a Braze como un bloque de contenido.

Sincronizar Content Blocks

Paso 1: Sincronizar una entrada con un Content Block de Braze

  1. Abre una entrada publicada que tenga la aplicación de Braze en su barra lateral.
  2. En la barra lateral, selecciona Create Content Block.
  3. Selecciona la configuración regional que deseas usar. Se crea un Content Block por cada configuración regional seleccionada.
  4. Selecciona los campos que deseas incluir en el Content Block.
  5. Selecciona Send to Braze. El Content Block se crea en tu espacio de trabajo de Braze y está disponible en Content > Content Block.

Paso 2: Mantener actualizado el contenido sincronizado

Elige el método que se ajuste a la frecuencia con la que cambia el contenido:

  • La sincronización de Content Blocks es adecuada para contenido que es estable en el momento del envío y se reutiliza en muchos mensajes. Se renderiza sin una llamada externa.
  • El contenido conectado es adecuado para contenido que puede cambiar entre el momento en que se crea una Campaign y el momento en que se entrega, ya que el contenido se obtiene en el momento de la entrega.

Para obtener más información sobre cómo funciona la aplicación de Braze en Contentful, consulta la documentación de la aplicación de Braze de Contentful.

Usar contenido conectado

Paso 1: Añadir la llamada de contenido conectado a un mensaje de Braze

  1. En Contentful, abre una entrada publicada y selecciona Generate Braze Connected Content en la barra lateral.
  2. Selecciona los campos que deseas incluir y luego selecciona Next.
  3. Si la entrada tiene múltiples configuraciones regionales, selecciona las que deseas incluir y luego selecciona Next.
  4. Copia la llamada de contenido conectado generada.
  5. En Braze, crea o abre una Campaign o un mensaje de Canvas.
  6. Pega la llamada de contenido conectado en la parte superior del cuerpo del mensaje.
  7. Pega las etiquetas de Liquid donde deba aparecer el contenido.

Paso 2: Hacer referencia a campos con Liquid

La notación de punto JSON te permite especificar qué parte del cuerpo de respuesta de Contentful incluir en tu mensaje. Esto varía según tu caso de uso. La aplicación genera la etiqueta de Liquid correcta para cada campo. Las etiquetas tienen un espacio de nombres por configuración regional cuando la entrada está localizada, y por tipo de contenido cuando no lo está.

Escenario Ejemplo de etiqueta de Liquid
Entrada localizada (en-US) {{response.data.enUS.body}}
Entrada localizada (es-AR) {{response.data.esAR.body}}
Entrada no localizada {{response.data.blogPost.body}}
Lista de texto corto, unida {{response.data.recipe.ingredients | join: ', '}}
Lista de texto corto, elemento individual {{response.data.recipe.ingredients[0]}}
Campo de ubicación {{response.data.venue.address.lat}} y {{response.data.venue.address.lon}}
Archivo multimedia individual {{response.data.blogPost.image.url}}
Colección de activos, elemento individual {{response.data.blogPost.imagesCollection.items[0].url}}
Referencias múltiples, elemento individual {{response.data.event.contactList[0].name}}
Referencias múltiples, en bucle {% for contact in response.data.event.contactList %} {{contact.name}} {% endfor %}

Los campos multimedia también exponen title, description, contentType, fileName, size, width y height, además de url.

Paso 3: Previsualizar y enviar

  1. Usa la pestaña Preview & Test de Braze para confirmar que la llamada de contenido conectado se resuelve y que las etiquetas de Liquid muestran los valores esperados.
  2. Envía un mensaje de prueba a ti mismo o a un usuario de prueba.
  3. Lanza la Campaign o el Canvas una vez que el contenido se muestre correctamente.

Consideraciones

  • Las entradas deben estar publicadas. Braze obtiene el contenido a través de la Content Delivery API, que solo devuelve entradas publicadas. Los borradores o las entradas modificadas pero no publicadas no se renderizan.
  • El contenido conectado añade una solicitud en el momento del envío. El contenido se obtiene cuando se entrega cada mensaje. Sigue las indicaciones en Contenido conectado sobre almacenamiento en caché, tiempos de espera y cancelación de mensajes si la solicitud falla, y asegúrate de que los límites de velocidad de la API de tu plan de Contentful puedan absorber tu volumen de envío. Para consultar los límites de velocidad de Contentful, consulta Límites técnicos de Contentful.
  • Los Content Blocks son específicos del espacio de trabajo. Los Content Blocks sincronizados desde Contentful se crean en el espacio de trabajo de Braze vinculado a la clave de API REST que configuraste. Para usar el mismo contenido en otro espacio de trabajo, configura la aplicación para ese espacio de trabajo también.
  • Los locales crean salidas separadas. Seleccionar varios locales genera etiquetas de Liquid separadas (contenido conectado) o Content Blocks separados (sincronización), uno por cada locale.

Solución de problemas

Problema Resolución
“A valid Contentful API key is required” durante la instalación Confirma que la clave sea una clave de Content Delivery API (CDA) con acceso de lectura y que pertenezca al espacio en el que estás instalando.
Las etiquetas de Liquid se muestran en blanco en una vista previa de Braze Comprueba que la entrada esté publicada, que el campo tenga contenido y que el locale en la etiqueta coincida con un locale configurado en la entrada.
La llamada de contenido conectado devuelve un error en Braze Verifica el Space ID, el entorno y el token de acceso en la llamada generada, y prueba el endpoint directamente. Braze registra los errores de contenido conectado en el registro de actividad de mensajes.
El bloque de contenido no aparece en Braze Confirma que la clave de API REST de Braze tenga los permisos necesarios de Content Blocks y que el endpoint REST coincida con tu instancia de Braze.
Los campos en una lista de referencia devuelven valores vacíos Comprueba si la lista contiene múltiples tipos de contenido; recorre la lista en lugar de acceder por índice.

Recursos adicionales

Documentación de la plataforma de interacción con el cliente de Braze.

Recursos
Legal
Empresa
© 2026 Braze, Inc. Todos los derechos reservados.
Verificación del estado de Braze
New Stuff!