Bắt Đầu Nhanh

1. Khởi tạo client

TypeScript
Python

import { ImbraceClient } from "@imbrace/sdk"

const client = new ImbraceClient({
  accessToken: process.env.IMBRACE_ACCESS_TOKEN,
  env: "stable",
})

import os
from dotenv import load_dotenv
from imbrace import ImbraceClient

load_dotenv()

client = ImbraceClient(
    access_token=os.environ["IMBRACE_ACCESS_TOKEN"],
    env="stable",
)

TypeScript
Python

import { ImbraceClient } from "@imbrace/sdk"

const client = new ImbraceClient({
  apiKey:         process.env.IMBRACE_API_KEY,
  organizationId: process.env.IMBRACE_ORGANIZATION_ID,
  env:            "stable",
})

import os
from dotenv import load_dotenv
from imbrace import ImbraceClient

load_dotenv()

client = ImbraceClient(
    api_key=os.environ["IMBRACE_API_KEY"],
    organization_id=os.environ.get("IMBRACE_ORGANIZATION_ID"),
    env="stable",
)

2. Lấy danh sách boards của bạn

Boards là các pipeline CRM — khách hàng tiềm năng, giao dịch, nhiệm vụ, hoặc bất kỳ dữ liệu có cấu trúc nào. Lời gọi này chỉ yêu cầu thông tin xác thực của bạn.

TypeScript
Python

const { data: boards } = await client.boards.list()

for (const board of boards) {
  console.log(board.id, board.name)
}

boards = client.boards.list()

for board in boards.get("data", []):
    board_id = board.get("_id") or board.get("id")
    print(board_id, board.get("name"))

Nếu bạn thấy danh sách boards của mình, SDK đã được kết nối và xác thực. Danh sách rỗng (data: []) chỉ có nghĩa là chưa có board nào — điều đó bình thường, không phải lỗi.

3. Các bước tiếp theo

Hướng dẫn toàn diện hướng dẫn bốn quy trình làm việc chính từ đầu đến cuối. Đi thẳng đến một phần:

AI Agent + streamChat → Hướng dẫn toàn diện §1
Workflows → Hướng dẫn toàn diện §2
Knowledge Hub (thư mục, RAG) → Hướng dẫn toàn diện §3
Boards & Items (CRM) → Hướng dẫn toàn diện §4

Để xem tài liệu tham khảo API theo từng namespace, hãy xem Resources.