Reach

Grow

Manage

Automate

Reach

Grow

Manage

Automate

G

G

M

M

Catálogo de Productos Custom Source

Trae tu propio catálogo de productos

Descripción general

Descripción general

Descripción general

En Bird, puedes crear una fuente de catálogo de productos personalizada utilizando un endpoint de API. La respuesta de la API debe adherirse a un formato específico que incluya detalles del producto, variantes, imágenes y más. A continuación, se presenta una guía sobre cómo estructurar los datos de tu catálogo de productos y cómo crearlo utilizando la API.

Creando un Catálogo de Productos Custom

Puede navegar a la sección de Marketing de la plataforma Bird y seguir estos pasos:

  • Navegue a Productos > Haga clic en Crear Fuente del Catálogo como se muestra a continuación



  • Proporcione un nombre y su URL de API que tiene el json para sus productos. Puede referirse al formato json en las siguientes secciones de este artículo. También puede definir un método de autenticación si lo desea.

  • Habilite la Actualización Automática que actualiza el catálogo si su API se actualiza.


Una vez configurado, comenzará a ver los Productos apareciendo y podrá utilizar estos productos en sus plantillas de correo electrónico.

Puede navegar a la sección de Marketing de la plataforma Bird y seguir estos pasos:

  • Navegue a Productos > Haga clic en Crear Fuente del Catálogo como se muestra a continuación



  • Proporcione un nombre y su URL de API que tiene el json para sus productos. Puede referirse al formato json en las siguientes secciones de este artículo. También puede definir un método de autenticación si lo desea.

  • Habilite la Actualización Automática que actualiza el catálogo si su API se actualiza.


Una vez configurado, comenzará a ver los Productos apareciendo y podrá utilizar estos productos en sus plantillas de correo electrónico.

Puede navegar a la sección de Marketing de la plataforma Bird y seguir estos pasos:

  • Navegue a Productos > Haga clic en Crear Fuente del Catálogo como se muestra a continuación



  • Proporcione un nombre y su URL de API que tiene el json para sus productos. Puede referirse al formato json en las siguientes secciones de este artículo. También puede definir un método de autenticación si lo desea.

  • Habilite la Actualización Automática que actualiza el catálogo si su API se actualiza.


Una vez configurado, comenzará a ver los Productos apareciendo y podrá utilizar estos productos en sus plantillas de correo electrónico.

Catálogo de Producto Source API Format

La respuesta del punto final de la API debe ser un arreglo de objetos de producto, cada uno conteniendo varios campos. Aquí está la estructura y valores de ejemplo para cada campo:

Campos requeridos:

  • id (string): Un identificador único para el producto. Ejemplo: "8890650190078"

  • name (string): El nombre del producto. Ejemplo: "My Test Product"

  • description (string): Una descripción del producto. Ejemplo: "Un producto genial con luces disponibles en diferentes colores"

  • status (string): El estado actual del producto. Los valores válidos son:active: El producto está en vivo y disponible.archived: El producto está archivado.draft: El producto es un borrador. Ejemplo: "active"

  • created_at (string): La fecha y hora en que el producto fue creado, en formato ISO-8601. Ejemplo: "2022-05-25T10:55:16+02:00"

  • updated_at (string): La fecha y hora en que el producto fue actualizado por última vez, en formato ISO-8601. Ejemplo: "2022-05-25T10:55:16+02:00"

  • published_at (string): La fecha y hora en que el producto fue publicado, en formato ISO-8601. Ejemplo: "2022-05-25T10:55:16+02:00"

  • vendor (string): El nombre del distribuidor del producto. Ejemplo: "My Vendor"

  • deleted_at (string): La fecha y hora en que el producto fue eliminado (si aplica), en formato ISO-8601. Ejemplo: "2022-05-25T10:55:16+02:00" o una cadena vacía "" si el producto no ha sido eliminado.

Campos opcionales:

  • url (string): La URL del producto. Ejemplo: "https://www.myproduct.com"

  • type (string): El tipo de producto, que puede ser usado para filtrar y buscar productos. Ejemplo: "color"

  • variants (array): Un arreglo de variantes del producto. Si se especifica, cada variante debe incluir id, name, sku, y precio.

Ejemplo:

[
  {
    "id": "44775891271934",
    "name": "Colorful",
    "price": 13.37,
    "sku": "BIRD",
    "price_currency": "EUR"
  }
]
  • images (array): Un arreglo de imágenes del producto. Si se especifica, cada imagen debe incluir id, position, url, alt, width, y height. El arreglo variant_ids también puede vincular imágenes con variantes específicas del producto.

[
  {
    "id": "41083401765118",
    "position": 1,
    "url": "https://images.com/s/files/1/0640/9021/0558/files/61dJSqBcgeL._AC_SX679.jpg?v=1709712277",
    "alt": "Product Image",
    "width": 679,
    "height": 1071,
    "variant_ids": [
      44775891271934
    ]
  }
]

variant_ids (array): Un arreglo de ids de variantes asociadas con la imagen del producto.

Instrucciones paso a paso para crear un catálogo de productos personalizado Source

  • Prepare Your Data: Da formato a tu respuesta de catálogo de productos de acuerdo con la estructura descrita anteriormente. Asegúrate de incluir todos los campos requeridos, y añade campos opcionales como variants, images, y url según sea necesario.

  • Create the API Endpoint: Utiliza la API de BirdCRM para enviar los datos de los productos. El endpoint espera una respuesta que cumpla con la estructura mencionada anteriormente. Asegúrate de que los datos estén en un formato JSON válido.

  • Test the Endpoint: Antes de integrar la fuente del catálogo de productos en tu flujo de trabajo, es importante probar el endpoint de la API para verificar que los datos se estén procesando correctamente. Esto asegura que todos los productos y su información relacionada (como variantes e imágenes) se estén recopilando correctamente.

  • Monitor and Maintain: Una vez que se crea la fuente del catálogo de productos, puedes monitorear su rendimiento a través de las funciones de informes de BirdCRM. Si necesitas actualizar algún detalle del producto o agregar nuevos productos, simplemente actualiza los datos usando la API.

Ejemplo de Respuesta de API:

[[
  {
    "id": "66f120f8001c1da060fa157d",
    "name": "Test Product",
    "description": "Test Description",
    "status": "active",
    "created_at": "2024-09-23T08:06:15.017Z",
    "updated_at": "2024-09-23T08:06:10.779Z",
    "published_at": "2024-09-23T08:06:15.017Z",
    "vendor": "Bird",
    "deleted_at": "",
    "url": "https://www.myproduct.com",
    "variants": [
      {
        "id": "0",
        "name": "Test Product Variant 1",
        "price": 459,
        "sku": "test-sku-1",
        "price_currency": "EUR"
      }
    ],
    "images": [
      {
        "id": "000",
        "position": 1,
        "url": "https://framerusercontent.com/images/zASPV0YuKuzbu1t0zakhflD2Y.png",
        "alt": "bird",
        "width": 768,
        "height": 432,
        "variant_ids": [0]
      }
    ]
  }
]


Siguiendo estos pasos, puedes crear y gestionar una fuente de catálogo de productos personalizada dentro de Bird. Asegúrate de que la respuesta de la API cumpla con el formato requerido, y podrás integrar tus productos en la plataforma sin problemas.


Conectémosle con un experto de Bird.
Vea el poder completo del Bird en 30 minutos.

Al enviar, aceptas que Bird pueda contactarte sobre nuestros productos y servicios.

Puedes darte de baja en cualquier momento. Consulta el Aviso de Privacidad de Bird para obtener detalles sobre el procesamiento de datos.

Company

Newsletter

Mantente al día con Bird a través de actualizaciones semanales en tu buzón.

Conectémosle con un experto de Bird.
Vea el poder completo del Bird en 30 minutos.

Al enviar, aceptas que Bird pueda contactarte sobre nuestros productos y servicios.

Puedes darte de baja en cualquier momento. Consulta el Aviso de Privacidad de Bird para obtener detalles sobre el procesamiento de datos.

Company

Newsletter

Mantente al día con Bird a través de actualizaciones semanales en tu buzón.

Conectémosle con un experto de Bird.
Vea el poder completo del Bird en 30 minutos.

Al enviar, aceptas que Bird pueda contactarte sobre nuestros productos y servicios.

Puedes darte de baja en cualquier momento. Consulta el Aviso de Privacidad de Bird para obtener detalles sobre el procesamiento de datos.

R

Reach

G

Grow

M

Manage

A

Automate

Company

Newsletter

Mantente al día con Bird a través de actualizaciones semanales en tu buzón.