Documentação da mobds.

Introdução #

A mobds é uma plataforma de vendas de software com API-first. Em vez de montar billing, licenciamento e CRM separados, você chama mobds.deals.create() e o resto acontece sozinho.

• Licenças — emitidas em ~410ms após o pagamento
• Agentes — IA que prospecta, fecha e renova
• Billing — Pix, cartão e boleto com conciliação automática

Quickstart #

Do zero ao primeiro deal em menos de 5 minutos.

# 1. instale o SDK
npm install @mobds/sdk

# 2. configure sua chave (painel → settings → api)
export MOBDS_KEY="mk_live_…"

import { mobds } from "@mobds/sdk"

const deal = await mobds.deals.create({
  account: "tinnova",
  plan: "suite-annual",
  seats: 40,
})

console.log(deal.licenses)
// → ["MOBDS-SUITE-TN96"]  ✓ emitida em 410ms

Autenticação #

Toda chamada usa sua chave no header Authorization. Chaves de live começam com mk_live_ e as de teste com mk_test_.

curl https://api.mobds.com/v2/deals \
  -H "Authorization: Bearer mk_live_…" \
  -H "Content-Type: application/json"

Licenciamento #

Licenças são o coração da mobds. Cada uma tem um ciclo de vida próprio e transições automáticas:

• trial → ativada sob avaliação, expira em N dias
• ativa → paga e válida até a renovação
• revogada → inadimplência ou cancelamento manual

// emitir licença avulsa
await mobds.licenses.issue({ account: "nordal", plan: "bi-cloud", seats: 120 })

// renovar com proration automática
await mobds.licenses.renew("MOBDS-BICL-ND12", { months: 12, discount: 0.08 })

Agentes de IA #

Os três agentes são configuráveis por código — defina margens, limites e tom de voz, e eles trabalham dentro das suas regras:

export default {
  scout:   { sources: ["cnpj", "linkedin"], minScore: 70 },
  closer:  { maxDiscount: 0.12, tone: "consultivo" },
  guardian:{ saveAttempts: 3, dunning: true },
}

API Reference #

REST previsível, respostas em JSON, versionamento na URL. Base: https://api.mobds.com/v2

Webhooks #

Receba eventos em tempo real no seu endpoint. Assinamos todo payload com HMAC-SHA256 no header X-Mobds-Signature.

const event = mobds.webhooks.verify(req.body, sig, process.env.WH_SECRET)

switch (event.type) {
  case "deal.won":    celebrate(event.data); break
  case "renewal.saved": notifyCS(event.data); break
}

Códigos de erro #

Erros seguem o formato { "error": { "code": "…", "message": "…" } }: