Loomya Bridge

O Loomya Bridge é uma plataforma iPaaS (Integration Platform as a Service) que conecta sistemas como ERPs, CRMs e plataformas de e-commerce. Com ele você pode configurar webhooks, automatizar sincronização de dados e monitorar todas as integrações em tempo real.

URL Base

https://bridge.loomya.co

Autenticação

Todas as requisições autenticadas devem incluir sua API Key no header Authorization.

Authorization: Bearer lmy_live_sua_api_key_aqui

Verificar autenticação

{
  "client": {
    "id": "281bd3b8-32e8-4688-96ae-6cb579197abd",
    "name": "Minha Empresa",
    "email": "contato@empresa.com"
  },
  "usage": {
    "month": "2026-03",
    "executions": 1247,
    "webhookCalls": 89
  },
  "stats": {
    "totalIntegrations": 3
  }
}

Início Rápido

Em menos de 5 minutos você pode configurar sua primeira integração e enviar um evento.

curl -X POST https://bridge.loomya.co/config \
  -H "Authorization: Bearer lmy_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pedidos Shopify → Bling",
    "source": "shopify",
    "destination": "bling"
  }'

# Shopify
https://bridge.loomya.co/oauth/shopify/start?clientId={seu_client_id}&shop=sua-loja.myshopify.com

# Bling
https://bridge.loomya.co/oauth/bling/start?clientId={seu_client_id}

curl -X POST https://bridge.loomya.co/webhook/push/{integrationId} \
  -H "Authorization: Bearer lmy_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "event": "order.created",
    "payload": { "order_id": "1001", "total": 299.90 }
  }'

curl https://bridge.loomya.co/logs?limit=5 \
  -H "Authorization: Bearer lmy_live_..."

Clientes

Gerenciamento de contas, API Keys e credenciais de conectores. Há dois níveis de acesso:

Criar cliente

{
  "client": {
    "id": "281bd3b8-32e8-4688-96ae-6cb579197abd",
    "name": "Minha Empresa",
    "email": "contato@empresa.com",
    "plan": "starter",
    "createdAt": "2026-03-16T10:00:00.000Z"
  },
  "apiKey": {
    "id": "c3f1a2b4-...",
    "key": "lmy_live_a1b2c3d4e5f6g7h8",  // exibida apenas aqui
    "label": "default"
  }
}

Dados do cliente autenticado

{
  "client": { "id": "...", "name": "...", "email": "...", "plan": "starter" },
  "apiKeys": [
    { "id": "...", "keyPrefix": "lmy_live_a1b2", "label": "default", "lastUsedAt": "..." }
  ],
  "usage": { "month": "2026-03", "executions": 1247, "webhookCalls": 89 },
  "stats": { "totalIntegrations": 3 }
}

API Keys

Uso e estatísticas

{
  "usage": {
    "month": "2026-03",
    "executions": 1247,
    "webhookCalls": 312
  }
}

Credenciais de conectores

Armazene tokens de acesso manualmente (alternativa ao fluxo OAuth).

{
  "connector": "shopify",
  "shopDomain": "minha-loja.myshopify.com",
  "accessToken": "shpat_..."
}

{
  "connector": "bling",
  "accessToken": "...",
  "refreshToken": "..."
}

Integrações

Uma integração define o canal entre dois sistemas. Cada integração pertence a um cliente e possui um código único que identifica sua combinação de origem, destino e feature.

Código da integração

Ao criar uma integração, o sistema gera automaticamente um code no formato origem_destino_feature. Esse código é único por cliente — você não pode ter duas integrações com o mesmo código na mesma conta.

Features disponíveis

A feature é detectada automaticamente pelo nome que você escolhe para a integração. As keywords abaixo determinam qual feature será usada:

Regras de unicidade

Criar integração

curl -X POST https://bridge.loomya.co/config \
  -H "Authorization: Bearer lmy_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Shopify → Bling (Pedido)",
    "source": "shopify",
    "destination": "bling"
  }'

{
  "success": true,
  "integration": {
    "id":          "uuid-da-integracao",
    "name":        "Shopify → Bling (Pedido)",
    "code":        "shopify_bling_pedido",
    "source":      "shopify",
    "destination": "bling",
    "status":      "active",
    "createdAt":   "2026-03-17T12:00:00.000Z"
  }
}

{
  "error":   "Conflict",
  "message": "Já existe uma integração com o código \"shopify_bling_pedido\" para esta conta.",
  "code":    "shopify_bling_pedido"
}

Excluir integração

curl -X DELETE https://bridge.loomya.co/config/uuid-da-integracao \
  -H "Authorization: Bearer lmy_live_..."

Conector Shopify

Conecte sua loja Shopify via OAuth 2.0 e registre webhooks automáticos.

Conectar via OAuth

GET /oauth/shopify/start?clientId={clientId}&shop=sua-loja.myshopify.com

O usuário é redirecionado para autorização na Shopify e retorna ao dashboard após autenticação.

Registrar webhooks

Conector Bling

Conecte sua conta Bling ERP via OAuth 2.0 para sincronização de produtos, pedidos e contatos.

Conectar via OAuth

GET /oauth/bling/start?clientId={clientId}

Verificar status dos conectores

{
  "connections": {
    "shopify": { "connected": true, "shopDomain": "minha-loja.myshopify.com" },
    "bling":   { "connected": true, "expired": false }
  }
}

Sincronização

Sincronize dados em lote do Bling para o sistema de destino ou configure polling automático.

Sincronização completa

{
  "entities": ["products", "orders", "customers"]
  // Deixe vazio para sincronizar tudo
}

Polling automático

{
  "enabled": true,
  "intervalMinutes": 15  // 1 a 1440 minutos
}

Cada integração possui um conjunto de configurações avançadas acessíveis pelo ícone de engrenagem na tabela de integrações do Dashboard. Essas configurações são independentes por integração — você pode, por exemplo, ter um polling a cada 15 minutos para pedidos e um polling diário para estoque.

Agendamento (Polling)

O polling é um mecanismo de busca proativa de dados no sistema de origem. Ao contrário dos webhooks (que são disparados pelo sistema externo), o polling é iniciado pela Loomya Bridge no intervalo configurado.

// PATCH /config/:id/settings
{
  "pollEnabled": true,
  "scheduleType": "times",
  "scheduleTimes": ["06:00"],
  "scheduleDays": [1, 2, 3, 4, 5],  // 0=Dom, 1=Seg … 6=Sáb
  "scheduleTimezone": "America/Sao_Paulo"
}

Janela de Execução

A janela de execução restringe o horário em que eventos podem ser processados. Se um evento chegar fora da janela configurada, ele não é descartado — é automaticamente reagendado para quando a janela abrir novamente.

{
  "windowStart": "08:00",
  "windowEnd": "22:00"
  // Evento que chegar às 23:30 será reagendado para 08:00 do dia seguinte
}

Filtros de Execução

Filtros permitem que você restrinja quais eventos são efetivamente processados, evitando execuções desnecessárias e economizando quota. Eventos filtrados são descartados antes de consumir uma execução do seu plano.

{
  "filterMinValue": 50,
  "filterStatuses": ["paid", "authorized"]
}

Status disponíveis (Shopify financial_status):

Notificações de Falha

A plataforma monitora automaticamente falhas consecutivas e envia um alerta por e-mail quando o limite configurado é atingido. O alerta inclui o nome da integração, o número de falhas e a mensagem do último erro.

Resiliência — Retry e Prioridade

Configure como a integração se comporta em caso de falha e com que prioridade seus jobs são processados na fila compartilhada do Redis.

Prioridade da fila

Retry automático

Quando um job falha (ex: API do destino fora do ar), a plataforma tenta novamente automaticamente.

{
  "priority": "high",
  "maxRetries": 5,
  "retryBackoff": "exponential",
  "retryInitialDelay": 30   // 30s → 60s → 120s → 240s → 480s
}