Integração de Catálogo de Produtos

A Widde Pro conecta seus vídeos interativos com o catálogo de produtos do e-commerce, garantindo que cada vídeo esteja vinculado a um produto real (com título, preço, imagem e link de compra).

Existem duas formas de integração:

1. Integração Nativa – disponível para as principais plataformas de e-commerce.
2. Integração via API – para quem utiliza plataformas customizadas ou não listadas.

---

1. Integrações Nativas

A Widde já possui conectores prontos para as seguintes plataformas:

Plataforma	Integração Nativa
Vtex	✅
Shopify	✅
Nuvemshop	✅
Tray	✅
Wake	✅
Bagy	✅
Vnda	✅
Loja Integrada	✅

Se sua loja utiliza uma dessas plataformas, basta conectar diretamente pelo painel da Widde, sem necessidade de desenvolvimento adicional.

---

2. Integração via API

Caso seu e-commerce seja customizado ou esteja em uma plataforma ainda não suportada, você pode integrar o catálogo de produtos fornecendo uma API compatível com o padrão Widde.

A Widde consome dados no seguinte formato:

Estrutura de Produto

type ProductGateway = {
  title: string; // Nome do produto
  mainImage: string; // URL da imagem principal
  price: number; // Preço atual
  comparePrice: number; // Preço comparativo
  handler: string; // Identificador amigável (slug/handle)
  url: string; // URL do produto na loja
  externalId: string; // ID único do produto (do seu sistema)
};

Métodos Esperados

A Widde espera que o serviço de catálogo forneça os seguintes endpoints (ou equivalentes):

interface ProductService {
  // Busca produtos pelo termo (nome, SKU, etc.)
  search(term: string): Promise<ProductGateway[]>;

  // Busca um produto pelo ID único
  getById(externalId: string): Promise<ProductGateway>;

  // Notificação de atualização de produto
  // (chamado via Webhook quando houver alterações no catálogo)
  onProductUpdate(
    externalId: string,
    productData: ProductGateway
  ): Promise<ProductGateway>;
}

---

3. Fluxo de Integração

1. Exposição da API
   Sua plataforma deve expor endpoints REST/GraphQL que retornem os dados no formato ProductGateway.

2. Autenticação
   Se necessário, fornecer credenciais (token/bearer key) para que a Widde consiga acessar os endpoints.

3. Atualizações em Tempo Real (Webhook)

   • Sempre que um produto for atualizado (preço, título, imagem ou estoque), envie uma chamada para o endpoint da Widde.
   • Payload esperado: objeto ProductGateway.

4. Validação
   Após a configuração, a equipe da Widde testará chamadas de search e getById para validar a integração.

---

4. Suporte

Se precisar de suporte técnico para implementar a integração de catálogo, entre em contato:
📧 [email protected]

Nossa equipe dará todo o auxílio necessário para homologar sua API.