G

M

Fonte de Catálogo de Produtos Personalizados

Traga seu próprio catálogo de produtos

Visão geral

No Bird, você pode criar uma fonte de catálogo de produtos personalizada usando um endpoint de API. A resposta da API deve aderir a um formato específico que inclui detalhes do produto, variantes, imagens e mais. Abaixo está um guia sobre como estruturar seus dados de catálogo de produtos e como criá-los usando a API.

Criando Catálogo de Produtos Personalizados

Você pode navegar até a seção de Marketing da Plataforma Bird e seguir estas etapas:

  • Navegue até Produtos > Clique em Criar Fonte de Catálogo conforme mostrado abaixo



  • Forneça um nome e sua URL da API que contém o json para seus produtos. Você pode consultar o formato json nas seções a seguir deste artigo. Você também pode definir um método de autenticação, se desejar.

  • Ative a Atualização Automática, que atualiza o catálogo se sua API for atualizada.


Uma vez que isso esteja configurado, você começará a ver os Produtos aparecendo e poderá usar esses produtos em seus modelos de e-mail.

Formato da API de Fonte do Catálogo de Produtos

A resposta do endpoint da API deve ser um array de objetos de produto, cada um contendo vários campos. Aqui está a estrutura e exemplos de valores para cada campo:

Campos Obrigatórios:

  • id (string): Um identificador único para o produto.Exemplo: "8890650190078"

  • name (string): O nome do produto.Exemplo: "Meu Produto de Teste"

  • description (string): Uma descrição do produto.Exemplo: "Um produto legal com luzes disponíveis em diferentes cores"

  • status (string): O status atual do produto. Os valores válidos são:active: O produto está ativo e disponível.archived: O produto está arquivado.draft: O produto é um rascunho.Exemplo: "active"

  • created_at (string): A data e hora em que o produto foi criado, no formato ISO-8601.Exemplo: "2022-05-25T10:55:16+02:00"

  • updated_at (string): A data e hora em que o produto foi atualizado pela última vez, no formato ISO-8601.Exemplo: "2022-05-25T10:55:16+02:00"

  • published_at (string): A data e hora em que o produto foi publicado, no formato ISO-8601.Exemplo: "2022-05-25T10:55:16+02:00"

  • vendor (string): O nome do vendedor do produto.Exemplo: "Meu Vendedor"

  • deleted_at (string): A data e hora em que o produto foi deletado (se aplicável), no formato ISO-8601.Exemplo: "2022-05-25T10:55:16+02:00" ou uma string vazia "" se o produto não foi deletado.

Campos Opcionais:

  • url (string): A URL do produto.Exemplo: "https://www.myproduct.com"

  • type (string): O tipo do produto, que pode ser usado para filtrar e pesquisar produtos.Exemplo: "cor"

  • variants (array): Um array de variantes do produto. Se especificado, cada variante deve incluir id, name, sku, e preço.

Exemplo:

[
  {
    "id": "44775891271934",
    "name": "Colorful",
    "price": 13.37,
    "sku": "BIRD",
    "price_currency": "EUR"
  }
]
[
  {
    "id": "44775891271934",
    "name": "Colorful",
    "price": 13.37,
    "sku": "BIRD",
    "price_currency": "EUR"
  }
]
[
  {
    "id": "44775891271934",
    "name": "Colorful",
    "price": 13.37,
    "sku": "BIRD",
    "price_currency": "EUR"
  }
]

  • images (array): Um array de imagens do produto. Se especificado, cada imagem deve incluir id, position, url, alt, width, e height. O array variant_ids também pode vincular imagens a variantes específicas do produto.

[
  {
    "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
    ]
  }
]
[
  {
    "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
    ]
  }
]
[
  {
    "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): Um array de ids de variantes associadas à imagem do produto.

Instruções Passo a Passo para Criar uma Fonte de Catálogo de Produtos Personalizada

  • Prepare Seus Dados: Formate a resposta do seu catálogo de produtos de acordo com a estrutura descrita acima. Certifique-se de que todos os campos obrigatórios sejam incluídos e que campos opcionais como variants, images e url sejam adicionados conforme necessário.

  • Crie o Endpoint da API: Use a API do BirdCRM para enviar os dados do produto. O endpoint espera uma resposta que adere à estrutura mencionada acima. Certifique-se de que os dados estejam em um formato JSON válido.

  • Teste o Endpoint: Antes de integrar a fonte do catálogo de produtos ao seu fluxo de trabalho, é importante testar o endpoint da API para verificar se os dados estão sendo processados corretamente. Isso garante que todos os produtos e suas informações relacionadas (como variantes e imagens) estejam sendo puxados corretamente.

  • Monitore e Mantenha: Uma vez que a fonte do catálogo de produtos é criada, você pode monitorar seu desempenho por meio dos recursos de relatórios do BirdCRM. Se você precisar atualizar detalhes de produtos ou adicionar novos produtos, basta atualizar os dados usando a API.

Exemplo de Resposta da 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]
      }
    ]
  }
]
[[
  {
    "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]
      }
    ]
  }
]
[[
  {
    "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]
      }
    ]
  }
]


Seguindo estas etapas, você pode criar e gerenciar uma fonte de catálogo de produtos personalizada dentro do Bird. Certifique-se de que a resposta da API adere ao formato exigido e você poderá integrar seus produtos na plataforma de forma perfeita.


A person is standing at a desk while typing on a laptop.

A plataforma completa nativa de IA que escalará com o seu negócio.

Contato de vendas

Comece gratuitamente

© 2026 Pássaro

Contacte o Suporte

A person is standing at a desk while typing on a laptop.

A plataforma completa nativa de IA que escalará com o seu negócio.

Contato de vendas

Comece gratuitamente

© 2026 Pássaro

Contacte o Suporte

A person is standing at a desk while typing on a laptop.

A plataforma completa nativa de IA que escalará com o seu negócio.

Contato de vendas

Comece gratuitamente

© 2026 Pássaro

Contacte o Suporte