Nhóm email

Nhóm email là một địa chỉ trên tên miền đang nhận thư của bạn, ví dụ [email protected], mà thư gửi tới được chuyển cho một danh sách thành viên. Cách hoạt động giống nhóm của Google Workspace: ai cũng gửi được tới địa chỉ nhóm, và mọi thành viên đều nhận được thư.

Thư chuyển tiếp trông thế nào

Mỗi thành viên nhận một bản riêng, nên không thấy địa chỉ của nhau:

• Người gửi: "Lan via Đội bán hàng" <[email protected]>. Thư chỉ được gửi từ tên miền đã xác minh của bạn, nên bản chuyển đi từ địa chỉ nhóm, kèm tên người gửi gốc phía trước.
• Trả lời tới: người gửi gốc. Bấm Trả lời là trả lời thẳng cho họ.
• Tiêu đề, nội dung và tệp đính kèm giữ nguyên. Bản chuyển có header X-Hatang-Forwarded-By và List-Id.

Thư gốc vẫn nằm ở Email → Nhận về và vẫn gửi webhook email.received. Mỗi bản chuyển là một lần gửi bình thường với nguồn forward: hiện trong Email, có sự kiện giao thư và tính vào hạn mức gửi trong ngày.

Không chuyển tiếp: thư bị đánh dấu rác, thư tự động (trả lời tự động, vắng mặt, thư báo lỗi, thư từ mailing list), thư đã đi qua một nhóm, và quá 30 thư mỗi giờ từ cùng một người gửi tới một nhóm.

Trước khi bắt đầu

• Một tên miền đã xác minh và đang bật Nhận thư. Xem Nhận email.
• API key có quyền email:write để quản lý nhóm (email:read để xem danh sách).

Tạo nhóm

Trên dashboard, mở Email → Nhóm email, chọn địa chỉ và tên miền, rồi nhập thành viên, mỗi dòng một địa chỉ. Hoặc dùng API:

cURL

curl -X POST https://api.hatang.dev/email-groups \
  -H "Authorization: Bearer $HATANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_id": "dom_...",
    "local_part": "team",
    "name": "Đội bán hàng",
    "members": ["[email protected]", "[email protected]"]
  }'

Node.js

const group = await hatang.emailGroups.create({
  domain_id: "dom_...",
  local_part: "team",
  name: "Đội bán hàng",
  members: ["[email protected]", "[email protected]"],
});

Python

requests.post(
    "https://api.hatang.dev/email-groups",
    headers={"Authorization": f"Bearer {os.environ['HATANG_API_KEY']}"},
    json={"domain_id": "dom_...", "local_part": "team", "name": "Đội bán hàng", "members": ["[email protected]", "[email protected]"]},
)

Mỗi nhóm có tối đa 100 thành viên. Thành viên không được là chính nhóm đó hay một nhóm khác, nên các nhóm không bao giờ chuyển thư vòng qua lại cho nhau.

Sửa hoặc xoá nhóm

PATCH /email-groups/{id} đổi tên, mô tả hoặc thành viên (gửi cả danh sách thành viên). Địa chỉ nhóm không đổi được; muốn đổi thì xoá rồi tạo nhóm mới. DELETE /email-groups/{id} xoá nhóm: thư tới địa chỉ này vẫn được nhận và lưu ở Nhận về, chỉ không chuyển cho ai nữa.

Xem đầy đủ các trường ở API reference.