Quản lý ngôn ngữ và dịch tự động bằng API Notiondesk

API Notiondesk cho phép bạn thay đổi ngôn ngữ mà trung tâm trợ giúp của bạn hỗ trợ, chọn ngôn ngữ mặc định và bật hoặc tắt tính năng dịch tự động bằng AI. Sử dụng nó để triển khai một ngôn ngữ mới trên nhiều trung tâm trợ giúp hoặc để giữ cho cài đặt ngôn ngữ đồng bộ với cấu hình của riêng bạn.

Cả hai tuyến đường đều trả về 204 No Content. Hãy đọc trạng thái mới với GET /sites/{site_id}, như được mô tả trong phần "Đọc trung tâm trợ giúp của bạn bằng API Notiondesk" .

Cả hai cách đều có thể bắt đầu tính phí dịch thuật. Thêm ngôn ngữ khi tính năng dịch tự động đang bật sẽ dịch nội dung của bạn sang ngôn ngữ đó, và bật tính năng dịch tự động sẽ bắt đầu dịch trung tâm trợ giúp của bạn. Cả hai đều được tính phí theo ký tự dịch. Vui lòng đọc kỹ bảng giá và cách tính phí dịch tự động bằng AI trước khi mua.

Hãy thiết lập các ngôn ngữ mà trung tâm trợ giúp của bạn hỗ trợ.

curl -i -X PATCH "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/settings/supported-languages" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Content-Type: application/json" \
  -d '{"locales": ["en", "fr", "de"], "default_locale": "en"}'

Trường dữ liệu bạn bỏ trống sẽ giữ nguyên giá trị hiện tại.

locales Thao tác này sẽ thay thế toàn bộ danh sách. Ngôn ngữ bạn bỏ sót sẽ bị xóa khỏi trung tâm trợ giúp, cùng với các thiết lập cho ngôn ngữ đó, chẳng hạn như tiêu đề trang và mô tả. Để thêm ngôn ngữ, trước tiên hãy đọc danh sách, sau đó gửi lại toàn bộ danh sách với ngôn ngữ mới được thêm vào.supported_locales

Việc bổ sung tương tự trong JavaScript, vẫn giữ nguyên các ngôn ngữ hiện có:

Giới hạn kế hoạch

Gói dịch vụ của bạn quy định số lượng ngôn ngữ mà trung tâm trợ giúp có thể phục vụ. Một danh sách locales dài hơn số đó sẽ trả lời 403 permission_denied.

Khi trung tâm trợ giúp của bạn lưu trữ một ngôn ngữ mà supported_locales của nó không hiển thị, mọi yêu cầu đến tuyến đường này sẽ trả về 403 permission_denied, bất kể bạn gửi gì. Điều đó xảy ra khi:

const siteId = "c74781f6-1aea-4e17-ab23-bbb8b4d174b6";
const headers = {
  Authorization: `Bearer ${process.env.NOTIONDESK_API_KEY}`,
  "nd-version": "2026-10-16",
  "Content-Type": "application/json",
};

const site = await (await fetch(`https://api.notiondesk.so/sites/${siteId}`, { headers })).json();
const locales = [...new Set([...site.supported_locales, "de"])];

await fetch(`https://api.notiondesk.so/sites/${siteId}/settings/supported-languages`, {
  method: "PATCH",
  headers,
  body: JSON.stringify({ locales }),
});

• Trung tâm trợ giúp hỗ trợ nhiều ngôn ngữ hơn so với gói dịch vụ cho phép, ví dụ như sau khi hạ cấp;

• Ngôn ngữ đã lưu bị vô hiệu hóa;

• Ngôn ngữ mặc định không có cài đặt nào được lưu trữ và sẽ chiếm một trong các vị trí của gói dịch vụ.

Thay đổi ngôn ngữ của trung tâm trợ giúp trong bảng điều khiển. API từ chối thay đổi để bảo vệ các ngôn ngữ mà nó không thể hiển thị cho bạn: một yêu cầu chỉ thay đổi ngôn ngữ mặc định sẽ xóa chúng, cùng với các thiết lập của chúng. Xem Hỗ trợ nhiều ngôn ngữ trong Trung tâm trợ giúp của bạn .

Bật hoặc tắt tính năng dịch tự động

curl -i -X PATCH "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/settings/auto-translate" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Content-Type: application/json" \
  -d '{"auto_translate_enabled": true, "auto_translate_source_locale": "en"}'

Gửi các giá trị boolean JSON true hoặc false. Các giá trị 0 và "false" được đọc là true, điều này sẽ bật tính năng dịch thuật có tính phí.

Việc bật tính năng dịch tự động sẽ bắt đầu dịch trung tâm trợ giúp của bạn. Lần đầu tiên sử dụng, tính năng này cũng sẽ kích hoạt tính phí dịch thuật cho không gian làm việc của bạn. Gói dịch vụ của bạn phải bao gồm tính năng dịch tự động. Tìm hiểu cách thức hoạt động trong phần Bắt đầu với dịch tự động bằng AI .

Việc dịch các hóa đơn trong khi nó đang diễn ra như thế nào

Xem phần "Kích hoạt Notion đồng bộ với API Notiondesk" để biết cách thức đồng bộ được chuyển đổi.

Lỗi

Xem các lỗi API, giới hạn tốc độ và số lần thử lại của Handle Notiondesk để biết phạm vi lỗi và các mã khác.

Câu hỏi thường gặp

Tiếp theo là gì?

• Trigger Notion đồng bộ với API Notiondesk

• Cập nhật cài đặt trung tâm trợ giúp bằng API Notiondesk

• Đọc các bài viết, bộ sưu tập và mục nhật ký thay đổi bằng API Notiondesk