Chiến dịch

client.campaign quản lý các chiến dịch marketing và các touchpoints liên quan — các điểm tương tác riêng lẻ (tin nhắn, hành động) tạo nên một chuỗi chiến dịch.

---

Schema

Campaign

Trường	Kiểu	Mô tả
_id	string	ID duy nhất của chiến dịch
name	string	Tên hiển thị của chiến dịch
status	string?	Trạng thái chiến dịch (vd: draft, active, completed)
channel_type	string?	Loại kênh chiến dịch chạy trên
created_at	string?	ISO 8601 thời gian tạo
updated_at	string?	ISO 8601 thời gian cập nhật

Touchpoint

Trường	Kiểu	Mô tả
_id	string	ID duy nhất của touchpoint
name	string?	Tên hiển thị của touchpoint
type	string?	Loại touchpoint
campaign_id	string?	ID chiến dịch cha
created_at	string?	ISO 8601 thời gian tạo

CreateCampaignInput

Trường	Kiểu	Bắt buộc	Mô tả
name	string	✓	Tên chiến dịch
channel_type	string		Loại kênh (vd: whatsapp, email)

CreateTouchpointInput

Trường	Kiểu	Bắt buộc	Mô tả
name	string		Tên touchpoint
type	string		Loại touchpoint
campaign_id	string		ID chiến dịch cha
message	string | object		Payload tin nhắn

---

Phương thức

Campaign

Phương thức	TypeScript	Python	Mô tả
Danh sách chiến dịch	list	list	Danh sách tất cả chiến dịch
Lấy chiến dịch	get	get	Lấy chiến dịch theo ID
Tạo chiến dịch	create	create	Tạo chiến dịch mới
Xóa chiến dịch	delete	delete	Xóa chiến dịch

Touchpoint

Phương thức	TypeScript	Python	Mô tả
Danh sách touchpoint	listTouchpoints	list_touchpoints	Danh sách tất cả touchpoints
Lấy touchpoint	getTouchpoint	get_touchpoint	Lấy touchpoint theo ID
Tạo touchpoint	createTouchpoint	create_touchpoint	Thêm touchpoint vào chiến dịch
Cập nhật touchpoint	updateTouchpoint	update_touchpoint	Cập nhật touchpoint
Xóa touchpoint	deleteTouchpoint	delete_touchpoint	Xóa touchpoint
Kiểm tra touchpoint	validateTouchpoint	validate_touchpoint	Kiểm tra tính hợp lệ của cấu hình touchpoint

---

list / list

TypeScript

const { data: campaigns } = await client.campaign.list();
for (const c of campaigns) {
  console.log(c._id, c.name, c.status);
}

Python

result = client.campaign.list()
for c in result.get("data", []):
    print(c["_id"], c["name"], c.get("status"))

---

create / create

TypeScript

const campaign = await client.campaign.create({
  name: "Q3 Re-engagement",
  channel_type: "whatsapp",
});
console.log(campaign._id);

Python

campaign = client.campaign.create({
    "name": "Q3 Re-engagement",
    "channel_type": "whatsapp",
})
print(campaign["_id"])

---

get / get

TypeScript

const campaign = await client.campaign.get("campaign_id");
console.log(campaign._id, campaign.name, campaign.status);

Python

campaign = client.campaign.get("campaign_id")
print(campaign["_id"], campaign.get("name"), campaign.get("status"))

---

delete / delete

TypeScript

await client.campaign.delete("campaign_id");

Python

client.campaign.delete("campaign_id")

---

createTouchpoint / create_touchpoint

TypeScript

const touchpoint = await client.campaign.createTouchpoint({
  name: "Welcome Message",
  type: "message",
  campaign_id: "campaign_id",
  message: { text: "Hi! Welcome to our service." },
});

Python

touchpoint = client.campaign.create_touchpoint({
    "name": "Welcome Message",
    "type": "message",
    "campaign_id": "campaign_id",
    "message": {"text": "Hi! Welcome to our service."},
})

---

updateTouchpoint / update_touchpoint

TypeScript

const updated = await client.campaign.updateTouchpoint("touchpoint_id", {
  name: "Updated Welcome Message",
  message: { text: "Hi! Great to have you here." },
});

Python

updated = client.campaign.update_touchpoint("touchpoint_id", {
    "name": "Updated Welcome Message",
    "message": {"text": "Hi! Great to have you here."},
})

---

getTouchpoint / get_touchpoint

TypeScript

const touchpoint = await client.campaign.getTouchpoint("touchpoint_id");
console.log(touchpoint._id, touchpoint.name);

Python

touchpoint = client.campaign.get_touchpoint("touchpoint_id")
print(touchpoint["_id"], touchpoint.get("name"))

---

deleteTouchpoint / delete_touchpoint

TypeScript

await client.campaign.deleteTouchpoint("touchpoint_id");

Python

client.campaign.delete_touchpoint("touchpoint_id")

---

validateTouchpoint / validate_touchpoint

Kiểm tra xem touchpoint đã được cấu hình đúng chưa trước khi kích hoạt chiến dịch.

TypeScript

const result = await client.campaign.validateTouchpoint({
  touchpoint_id: "touchpoint_id",
});
if (!result.valid) {
  console.error("Validation errors:", result.errors);
}

Python

result = client.campaign.validate_touchpoint({"touchpoint_id": "touchpoint_id"})
if not result.get("valid"):
    print("Validation errors:", result.get("errors"))