Automação

Webhooks e API do ImportBR: automação avançada para desenvolvedores

Como usar a API e webhooks do ImportBR para automatizar importação de produtos, sincronização de estoque e integrações com ERPs, planilhas e ferramentas no-code.

Verificado Conteúdo
8 min Leitura
Automação Categoria

Visão geral da API ImportBR

O ImportBR oferece uma API REST completa para desenvolvedores e usuários técnicos que precisam ir além do que a interface visual oferece. Com a API, você pode:

  • Disparar importações programaticamente a partir de uma lista de URLs
  • Sincronizar preços e estoque em tempo real com seu ERP
  • Criar fluxos de automação com ferramentas no-code (Zapier, Make/Integromat)
  • Receber notificações via webhook quando produtos são publicados ou atualizados
  • Integrar o ImportBR com planilhas Google Sheets para gestão centralizada

Base URL da API: https://api.importbr.com.br/v1/
Formato: JSON REST
Autenticação: Bearer Token (API Key)
Rate limit: 100 requests/minuto (plano Pro)

Autenticação e credenciais

Para usar a API, você precisa de uma API Key. Para gerar:

  1. Acesse o painel ImportBR → Configurações → API.
  2. Clique em "Gerar nova API Key".
  3. Copie e armazene com segurança — a key é exibida apenas uma vez.
  4. Use a key no header de cada request: Authorization: Bearer SUA_API_KEY.

Principais endpoints

Importar produto por URL

POST /products/import

Body JSON:
{"url": "https://shopee.com.br/produto/...", "store_id": "sua-loja-id", "markup": 3.5, "auto_publish": true}

Resposta: {"job_id": "abc123", "status": "processing"}

Listar produtos importados

GET /products?status=published&page=1&limit=50

Retorna lista paginada de produtos com dados completos: id, título, preço, variações, status de sincronização.

Atualizar preço em lote

PATCH /products/bulk-price

Body: {"product_ids": ["id1", "id2"], "markup": 4.0}

Atualiza o markup de múltiplos produtos e sincroniza com a loja automaticamente.

Configurando webhooks

Webhooks permitem que o ImportBR notifique seu sistema quando eventos acontecem. Para configurar:

  1. Acesse Configurações → Webhooks → Adicionar endpoint.
  2. Informe a URL do seu servidor que receberá as notificações.
  3. Selecione os eventos: product.published, product.price_changed, product.out_of_stock.
  4. Salve e teste o webhook usando o botão "Enviar evento de teste".

Cada webhook envia um payload JSON com os dados do evento. Seu servidor deve responder com status 200 em menos de 5 segundos para confirmar o recebimento.

Integrações no-code

Sem precisar escrever código, você pode integrar o ImportBR com centenas de ferramentas via Zapier ou Make (Integromat):

  • Google Sheets + ImportBR: quando um produto é publicado (webhook), adiciona automaticamente uma linha na planilha com dados do produto, preço e margem.
  • Slack + ImportBR: receba notificação no Slack sempre que um produto ficar sem estoque ou o preço do fornecedor mudar mais de 10%.
  • Airtable + ImportBR: banco de dados centralizado de todos os produtos importados para gestão e análise.
  • WhatsApp + ImportBR: receba alertas via WhatsApp Business API quando pedidos chegam em produtos específicos.

A documentação completa da API está disponível em docs.importbr.com.br — com exemplos em Python, JavaScript e curl para cada endpoint.

Pronto para colocar em prática?

Comece a importar produtos agora mesmo — grátis, sem cartão de crédito.

Criar conta gratuita
Tire suas dúvidas