Guides & Resources

# Claude Code (terminal)
claude mcp add --transport http hasos https://api.hasos.com.br/mcp \
  --header "x-api-key: hs_live_your_key"

# Cursor (~/.cursor/mcp.json) — and other clients with remote (HTTP) MCP
{
  "mcpServers": {
    "hasos": {
      "url": "https://api.hasos.com.br/mcp",
      "headers": { "x-api-key": "hs_live_your_key" }
    }
  }
}

# Claude Desktop (claude_desktop_config.json) — via the mcp-remote bridge
{
  "mcpServers": {
    "hasos": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.hasos.com.br/mcp",
               "--header", "Authorization: Bearer hs_live_your_key"]
    }
  }
}

# 1) Turn SIP on for the number (requires the Pro plan).
#    Without a paid plan it returns 403 { "code": "plan_required" }.
curl -X POST https://api.hasos.com.br/v1/instances/INSTANCE_ID/sip/enable \
  -H "x-api-key: hs_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"enabled":true}'

# Response (200):
# {
#   "host": "sip.hasos.com.br",
#   "username": "hsINSTANCE_ID",
#   "password": "…",
#   "enabled": true,
#   "planAllowed": true
# }

# 2) Fetch the credentials later (host/username/password):
curl https://api.hasos.com.br/v1/instances/INSTANCE_ID/sip \
  -H "x-api-key: hs_live_your_key"

# 3) Generate a new password (disconnects softphones using the old one):
curl -X POST https://api.hasos.com.br/v1/instances/INSTANCE_ID/sip/regenerate \
  -H "x-api-key: hs_live_your_key"

# 4) Turn SIP off (the number goes back to using the platform dialer):
curl -X POST https://api.hasos.com.br/v1/instances/INSTANCE_ID/sip/enable \
  -H "x-api-key: hs_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"enabled":false}'

// 1) Create the number (once).
const { id } = await fetch("https://api.hasos.com.br/v1/instances", {
  method: "POST", headers: { "x-api-key": KEY, "Content-Type": "application/json" }, body: "{}",
}).then((r) => r.json());

// 2) Pair: poll /qr every 2–3s and RE-RENDER the QR on every response.
//    WhatsApp rotates the code every ~20s — a static QR expires before it's scanned.
const poll = setInterval(async () => {
  const { qr, status, error } = await fetch(`https://api.hasos.com.br/v1/instances/${id}/qr`, {
    headers: { "x-api-key": KEY },
  }).then((r) => r.json());

  if (status === "CONNECTED") { clearInterval(poll); showConnected(); return; }
  if (error) { showWarning(error); /* do NOT delete/recreate — just keep polling */ }
  if (qr) renderQR(qr); // render the STRING as a QR image, always the latest one
}, 2500);

// Simpler alternative (no camera / no rotating QR): an 8-character code.
// The user enters it under Linked devices › Link a device › "Link with phone number instead".
//   GET https://api.hasos.com.br/v1/instances/{id}/pairing-code  →  { "code": "ABCD-1234" }

<!-- Headless dialer: your UI, invisible iframe. Our dialer is never shown. -->
<script src="https://phone.hasos.com.br/embed.js"></script>
<script>
  const phone = HasosPhone.create({
    token: "YOUR_DEVICE_TOKEN",              // POST /v1/instances/:id/tokens
    allowedOrigin: "https://your-app.com",   // pins the channel (recommended)
  });
  await phone.ready();

  // Place calls from YOUR buttons:
  document.querySelector("#call").onclick = () => phone.call.start("5511999998888");
  document.querySelector("#hangup").onclick = () => phone.call.hangup();

  // Inbound: answer/decline from YOUR interface:
  phone.on("offer:received", (offer) => showIncomingCallPopup(offer));
  document.querySelector("#answer").onclick = () => phone.call.accept();
  document.querySelector("#decline").onclick = () => phone.call.reject();

  // Lifecycle events to update your UI:
  phone.on("call:started",  (c) => {/* dialing */});
  phone.on("call:accepted", (c) => {/* in call */});
  phone.on("call:ended",    (c) => {/* ended */});
</script>