Claude cho Ecommerce: Haravan API + Claude tự động hóa nâng cao

Haravan là nền tảng e-commerce phổ biến nhất tại Việt Nam với hàng trăm nghìn shop đang sử dụng. Việc kết hợp Claude với Haravan API mở ra khả năng tự động hóa mạnh mẽ — từ xử lý đơn hàng thông minh, quản lý kho dự đoán, đến chăm sóc khách hàng tự động. Bài viết này hướng dẫn bạn cách tích hợp hai hệ thống này để nâng cao hiệu quả vận hành shop online.

Tổng quan về Haravan API

Haravan cung cấp REST API cho phép truy cập và quản lý hầu hết dữ liệu của shop. Các endpoint chính bao gồm:

• Products: Quản lý sản phẩm, biến thể, giá, kho
• Orders: Đơn hàng, thanh toán, vận chuyển
• Customers: Thông tin khách hàng, lịch sử mua hàng
• Inventory: Tồn kho theo location
• Collections: Bộ sưu tập sản phẩm
• Fulfillments: Xử lý giao hàng

API sử dụng chuẩn REST với authentication qua API key hoặc OAuth, trả về dữ liệu JSON và có rate limiting tùy theo gói dịch vụ.

Kiến trúc tích hợp Claude + Haravan

Có hai cách tiếp cận chính để tích hợp:

Cách 1: Claude API làm middleware

Xây dựng server trung gian nhận dữ liệu từ Haravan, xử lý bằng Claude, và thực hiện hành động ngược lại. Phù hợp cho automation workflows chạy tự động.

Cách 2: Claude Agent với Haravan tools

Xây dựng Claude agent có tools gọi trực tiếp Haravan API. Phù hợp cho tương tác trực tiếp — ví dụ nhân viên chat với agent để quản lý shop.

Thiết lập kết nối Haravan API

// haravan-client.ts — Wrapper cho Haravan API
const HARAVAN_API_URL = 'https://apis.haravan.com';

interface HaravanConfig {
  shopName: string;
  accessToken: string;
}

class HaravanClient {
  private baseUrl: string;
  private headers: Record<string, string>;

  constructor(config: HaravanConfig) {
    this.baseUrl = `${HARAVAN_API_URL}/com`;
    this.headers = {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${config.accessToken}`
    };
  }

  async getOrders(params?: {
    status?: string;
    created_at_min?: string;
    limit?: number;
  }) {
    const queryString = new URLSearchParams(params as any).toString();
    const response = await fetch(
      `${this.baseUrl}/orders.json?${queryString}`,
      { headers: this.headers }
    );
    return response.json();
  }

  async getProduct(productId: string) {
    const response = await fetch(
      `${this.baseUrl}/products/${productId}.json`,
      { headers: this.headers }
    );
    return response.json();
  }

  async updateInventory(inventoryItemId: string, quantity: number) {
    const response = await fetch(
      `${this.baseUrl}/inventory_levels/set.json`,
      {
        method: 'POST',
        headers: this.headers,
        body: JSON.stringify({
          inventory_item_id: inventoryItemId,
          available: quantity
        })
      }
    );
    return response.json();
  }
}

Use Case 1: Phân tích đơn hàng thông minh

Claude có thể phân tích dữ liệu đơn hàng từ Haravan để đưa ra insights kinh doanh:

Tôi có dữ liệu 500 đơn hàng gần nhất từ Haravan API.
Hãy phân tích và cho tôi biết:

1. Sản phẩm bán chạy nhất theo doanh thu và số lượng
2. Thời điểm đặt hàng cao điểm (giờ và ngày trong tuần)
3. Giá trị đơn hàng trung bình và phân bổ theo khoảng giá
4. Tỷ lệ hủy đơn và nguyên nhân phổ biến
5. Khách hàng quay lại (repeat customers) chiếm bao nhiêu phần trăm
6. Đề xuất 3 hành động cụ thể để tăng doanh thu tháng tới

Dữ liệu đơn hàng:
[Paste JSON data từ Haravan API]

Use Case 2: Tự động phân loại và xử lý đơn hàng

Xây dựng workflow tự động phân loại đơn hàng mới và đề xuất hành động:

// order-processor.ts
import Anthropic from '@anthropic-ai/sdk';

async function processNewOrder(order: HaravanOrder) {
  const anthropic = new Anthropic();

  const analysis = await anthropic.messages.create({
    model: 'sonnet',
    max_tokens: 1024,
    system: `Bạn là hệ thống phân loại đơn hàng. Với mỗi đơn hàng,
    hãy xác định:
    1. Mức độ ưu tiên: cao/trung bình/thấp
    2. Rủi ro gian lận: có/không (kèm lý do)
    3. Cần xử lý đặc biệt: có/không (kèm chi tiết)

    Trả về JSON format.

    Tiêu chí rủi ro gian lận:
    - Đơn hàng giá trị cao (trên 5 triệu) + khách mới + COD
    - Địa chỉ giao hàng khác tỉnh với số điện thoại
    - Nhiều sản phẩm cùng loại số lượng lớn
    - Ghi chú có dấu hiệu bất thường`,
    messages: [{
      role: 'user',
      content: `Phân tích đơn hàng sau:
      ${JSON.stringify(order, null, 2)}`
    }]
  });

  return JSON.parse(analysis.content[0].text);
}

Use Case 3: Quản lý kho thông minh

Claude có thể phân tích dữ liệu tồn kho và đưa ra đề xuất nhập hàng:

Dưới đây là dữ liệu tồn kho và lịch sử bán hàng 3 tháng gần nhất
từ Haravan:

[Paste dữ liệu inventory + sales data]

Hãy phân tích và đưa ra:

1. Danh sách sản phẩm sắp hết hàng (dưới 2 tuần tồn kho dựa trên
   tốc độ bán trung bình)
2. Sản phẩm tồn kho quá lâu (trên 60 ngày không bán được)
3. Dự báo nhu cầu 30 ngày tới cho top 20 sản phẩm
4. Đề xuất số lượng nhập hàng cụ thể cho mỗi sản phẩm
5. Sản phẩm nên giảm giá để xả kho

Lưu ý: Tháng tới có ngày 8/3, có thể ảnh hưởng đến các sản phẩm
quà tặng, mỹ phẩm, hoa.

Use Case 4: Chăm sóc khách hàng tự động

Xây dựng chatbot hỗ trợ khách hàng tích hợp với dữ liệu Haravan:

// customer-support-agent.ts
const supportAgent = new Agent({
  name: 'Haravan Support Agent',
  model: 'sonnet',
  instructions: `Bạn là nhân viên hỗ trợ khách hàng cho shop [Tên shop].
  Giọng điệu: thân thiện, kiên nhẫn, hướng đến giải quyết nhanh.

  Quy trình:
  1. Xác định vấn đề của khách
  2. Tra cứu đơn hàng nếu cần (hỏi mã đơn hoặc SĐT)
  3. Đưa ra giải pháp theo chính sách shop
  4. Nếu không giải quyết được, chuyển cho nhân viên

  Chính sách shop:
  - Đổi trả trong 7 ngày nếu sản phẩm lỗi
  - Hoàn tiền trong 3-5 ngày làm việc
  - Giao hàng nội thành 1-2 ngày, ngoại thành 3-5 ngày
  - COD phí 20.000đ, chuyển khoản miễn phí ship cho đơn trên 500.000đ`,
  tools: [
    lookupOrderTool,
    lookupCustomerTool,
    checkInventoryTool,
    createReturnRequestTool
  ]
});

Use Case 5: Tối ưu nội dung sản phẩm

Claude có thể phân tích và cải thiện mô tả sản phẩm trên Haravan:

Tôi có 50 sản phẩm trên Haravan cần tối ưu mô tả để tăng SEO
và tỷ lệ chuyển đổi. Đây là dữ liệu sản phẩm:

[Paste product data từ Haravan API]

Với mỗi sản phẩm, hãy:
1. Viết lại tiêu đề sản phẩm (tối đa 70 ký tự, có từ khóa chính)
2. Viết mô tả ngắn (meta description, 155 ký tự)
3. Viết mô tả chi tiết (300-500 từ) với:
   - Đặc điểm nổi bật (bullet points)
   - Thông số kỹ thuật
   - Ứng dụng/cách sử dụng
   - Lý do nên mua
4. Đề xuất tags phù hợp

Giọng điệu: phù hợp với đối tượng khách hàng [mô tả].
Lưu ý SEO: tự nhiên, không nhồi từ khóa.

Use Case 6: Báo cáo kinh doanh tự động

Tạo workflow tự động tạo báo cáo kinh doanh hàng tuần từ dữ liệu Haravan:

// weekly-report.ts
async function generateWeeklyReport() {
  // 1. Lấy dữ liệu từ Haravan
  const orders = await haravan.getOrders({
    created_at_min: getLastWeekStart(),
    status: 'any'
  });
  const products = await haravan.getProducts();
  const customers = await haravan.getCustomers({
    created_at_min: getLastWeekStart()
  });

  // 2. Gửi cho Claude phân tích
  const report = await anthropic.messages.create({
    model: 'sonnet',
    max_tokens: 4096,
    system: 'Bạn là chuyên gia phân tích e-commerce. Tạo báo cáo kinh doanh tuần bằng tiếng Việt.',
    messages: [{
      role: 'user',
      content: `Tạo báo cáo kinh doanh tuần với dữ liệu sau:

      Đơn hàng: ${JSON.stringify(orders)}
      Sản phẩm: ${JSON.stringify(products)}
      Khách hàng mới: ${JSON.stringify(customers)}

      Báo cáo cần bao gồm:
      1. Tổng quan: doanh thu, số đơn, giá trị trung bình
      2. So sánh với tuần trước (nếu có dữ liệu)
      3. Top 5 sản phẩm bán chạy
      4. Phân tích khách hàng mới vs quay lại
      5. Vấn đề cần chú ý (đơn hủy, tồn kho thấp)
      6. Đề xuất hành động cho tuần tới`
    }]
  });

  // 3. Gửi báo cáo qua email hoặc Zalo
  await sendReport(report.content[0].text);
}

Xử lý Webhooks từ Haravan

Haravan hỗ trợ webhooks để thông báo khi có sự kiện xảy ra. Kết hợp với Claude để xử lý thông minh:

// webhook-handler.ts
app.post('/webhooks/orders/create', async (req, res) => {
  const order = req.body;

  // Claude phân tích đơn hàng mới
  const analysis = await processNewOrder(order);

  if (analysis.fraud_risk === 'cao') {
    // Tạm giữ đơn hàng, thông báo cho admin
    await haravan.updateOrder(order.id, { tags: 'review-needed' });
    await notifyAdmin(`Don hang ${order.id} can kiem tra gian lan`);
  }

  if (analysis.priority === 'cao') {
    // Ưu tiên xử lý
    await haravan.updateOrder(order.id, { tags: 'priority' });
  }

  res.status(200).send('OK');
});

Bảo mật khi tích hợp

Khi tích hợp Claude với Haravan API, bảo mật là yếu tố then chốt:

• API keys: Lưu trong environment variables, không hardcode trong source code
• Quyền truy cập: Chỉ cấp quyền tối thiểu cần thiết cho API key (ví dụ: chỉ đọc đơn hàng nếu không cần ghi)
• Data minimization: Chỉ gửi dữ liệu cần thiết cho Claude, không gửi toàn bộ customer database
• Webhook verification: Luôn verify webhook signature từ Haravan trước khi xử lý
• Rate limiting: Tuân thủ rate limit của Haravan API (thường 2 requests/giây)
• Logging: Ghi log tất cả API calls nhưng ẩn sensitive data (token, thông tin khách hàng)

Chi phí và tối ưu

Khi sử dụng Claude API cho e-commerce automation, chi phí là yếu tố cần cân nhắc:

• Sử dụng Haiku cho tác vụ đơn giản (phân loại, trích xuất thông tin)
• Sử dụng Sonnet cho tác vụ phức tạp (phân tích, viết nội dung)
• Cache kết quả phân tích cho các sản phẩm không thay đổi thường xuyên
• Batch processing: gom nhiều đơn hàng phân tích cùng lúc thay vì từng đơn
• Chỉ gọi Claude khi thực sự cần — nhiều tác vụ có thể xử lý bằng rule-based logic

Bước tiếp theo

Bạn đã nắm được cách tích hợp Claude với Haravan API để tự động hóa e-commerce. Bắt đầu với use case đơn giản nhất (phân tích đơn hàng hoặc tối ưu nội dung), đo lường hiệu quả, rồi mở rộng dần. Khám phá thêm tại Thư viện Ứng dụng.