---
title: "Chiến dịch gọi ra"
description: "Tải lên danh sách liên hệ và để tác nhân AI xử lý — với khung giờ gọi, thử lại và theo dõi tiến độ trực tiếp."
---
Chiến dịch gọi đến danh sách liên hệ thay bạn: chọn một tác nhân AI, tải lên
CSV, đặt thời điểm được phép gọi và ThunderPhone sẽ xử lý danh sách
— gọi lại các cuộc không trả lời và thư thoại theo lịch bạn chọn. Tìm
chúng tại **Tương tác → Chiến dịch** (`/dashboard/campaigns`).
Đối với các cuộc gọi lập trình một lần, hãy sử dụng
[API cuộc gọi đi](/vi/guides/place-outbound-calls).
## Điều kiện tiên quyết
- Một tác nhân AI đã triển khai.
- Một số điện thoại được bật gọi ra. Số VoIP của khách hàng vẫn hỗ trợ
chiến dịch. Số ThunderPhone ban đầu chỉ hỗ trợ gọi vào; quản trị viên tổ chức có thể
yêu cầu gọi ra từ trang Số điện thoại. ThunderPhone xem xét thủ công từng
yêu cầu và các số được phê duyệt có thể chạy chiến dịch. Xem
[Kết nối nhà cung cấp VoIP](/vi/guides/voip-providers).
- Danh bạ dưới dạng tệp CSV (hoặc JSON được dán) có cột `phone` hoặc
`phone_number`. **Tối đa 5.000 hàng mỗi lần tải lên**, mã hóa UTF-8.
Các lượt tải JSON mới phải phẳng: giá trị bổ sung có thể là chuỗi, số,
boolean hoặc `null`. Các hàng chứa mảng hoặc đối tượng lồng nhau sẽ bị từ chối
riêng lẻ kèm thông báo xác thực; các hàng hợp lệ vẫn được nhập. Ô CSV
là chuỗi. Các cột bổ sung được chấp nhận được lưu dưới dạng biến theo từng liên hệ trong
bản ghi liên hệ của chiến dịch và tự động cung cấp cho mỗi lượt gọi. ThunderPhone cũng
phân loại prompt tác nhân AI đã lưu trước mỗi cuộc gọi ra để quyết định liệu
tác nhân AI có nên điều hướng qua menu điện thoại hay không. Các tiêu đề như `name` và `account_id`
khớp với `{{name}}` và `{{account_id}}` trong prompt của tác nhân AI đã lưu. Ánh xạ tên cũng có thể kết hợp các cột thành `name`. Xem
[biến theo từng cuộc gọi](/vi/guides/call-variables) để biết giá trị mặc định, quy tắc đặt tên,
giới hạn đối tượng 32 KB và các giá trị được trả về trong webhook hoàn tất.
Các bản ghi liên hệ cũ có thể chứa siêu dữ liệu lồng nhau từ các lượt tải JSON trước đó.
Siêu dữ liệu đó vẫn nằm trên liên hệ đã lưu. Mỗi lần gọi sẽ bỏ qua các giá trị không phải vô hướng khỏi
payload biến và ghi lại tên khóa bị bỏ qua cho lần thử đó mà không
ghi lại giá trị. Các lần gọi lại sử dụng cùng cơ chế lọc.
## Tạo chiến dịch
Đặt tên, chọn **tác nhân AI**, rồi chọn **số gọi đi**
(một trong các số đã bật gọi đi của bạn).
Các hàng có số điện thoại hoặc biến không hợp lệ sẽ bị từ chối riêng lẻ và
được báo lại kèm số hàng — các hàng còn lại vẫn được nhập bình thường.
Chọn **múi giờ** và khung **giờ bắt đầu/kết thúc hằng ngày**; chiến dịch
chỉ gọi trong khung giờ đó. Múi giờ mặc định theo vùng của số gọi đi
(mã vùng tại Hoa Kỳ và Canada, quốc gia ở các nơi khác) hoặc, đối với
các số trải trên nhiều vùng như số miễn phí, theo múi giờ của
trình duyệt. Gợi ý bên dưới trường sẽ cho biết múi giờ được dùng. Khung giờ mặc định
là 9am–5pm. Khung giờ bắt đầu trước 8am hoặc kết thúc sau 9pm sẽ hiển thị
cảnh báo: các cuộc gọi ngoài giờ đó có thể vi phạm quy định về giờ gọi, chẳng hạn
như TCPA. Thời điểm kết thúc sớm hơn thời điểm bắt đầu sẽ kéo sang ngày hôm sau: 22:00 →
02:00 gọi từ 10pm đến 2am ngày hôm sau, kèm cảnh báo. Khung giờ
chạy theo múi giờ của chiến dịch, không phải của từng liên hệ, vì vậy hãy chia
liên hệ theo múi giờ khi chúng phân bố ở nhiều nơi.
Bạn có thể đặt **thời điểm bắt đầu** để lên lịch khởi chạy và
**thời điểm kết thúc** để chiến dịch tự động hoàn tất sau đó.
- **Cuộc gọi đồng thời** — số cuộc gọi mà chiến dịch này thực hiện cùng lúc
(1–10, mặc định là 3). Chiến dịch sẽ không bắt đầu cuộc gọi mới khi
tổ chức của bạn đang có 10 cuộc gọi đi diễn ra, vì vậy các
chiến dịch chạy song song sẽ dùng chung giới hạn này. Mỗi cuộc gọi cũng được tính vào
[giới hạn cuộc gọi đồng thời](/api-reference/introduction#call-limits) của tổ chức bạn
(mặc định là 20, bao gồm cuộc gọi đến, gọi đi, web và kiểm thử).
Khi đạt giới hạn đó hoặc cùng một số đã được gọi trong
10 giây gần nhất, liên hệ chỉ chờ đến lượt chạy sau; số lần thử của liên hệ
không bị dùng hết.
- **Số lần thử tối đa** — số lần mỗi liên hệ có thể được gọi
(1–10, mặc định là 2).
- **Thời gian chờ thử lại (phút)** — thời gian chờ trước khi thử lại (ít nhất 30,
mặc định là 60).
- **Thử lại khi** — các kết quả kích hoạt thử lại: **không trả lời**,
**thư thoại**, **thất bại** (tất cả đều được bật mặc định).
Cần nhiều lần thử hơn hoặc khoảng cách ngắn hơn? Liên hệ bộ phận hỗ trợ: nhân viên có thể
tăng cả hai giới hạn cho tổ chức của bạn.
Chiến dịch được tạo dưới dạng bản nháp — chỉ có thể thêm liên hệ khi
chiến dịch là bản nháp. Bắt đầu chiến dịch yêu cầu bạn xác nhận rõ ràng
về phí cuộc gọi. Với **thời điểm bắt đầu** trong tương lai, chiến dịch sẽ thành
*đã lên lịch*; nếu không, chiến dịch sẽ *đang chạy* ngay lập tức.
Các chiến dịch được lưu trước những giới hạn này vẫn tiếp tục chạy đúng theo cấu hình.
Số lần thử và khoảng cách giữa các lần thử giữ nguyên như đã lưu khi thực hiện các chỉnh sửa khác.
## Cách hoạt động của kết quả và lần thử lại
Sau mỗi cuộc gọi, liên hệ sẽ nhận một kết quả — cuộc gọi thành công được
đánh dấu là đã hoàn tất; cuộc gọi được phân loại là không trả lời, được
phát hiện là thư thoại hoặc thất bại sẽ được thử lại nếu kết quả đó nằm
trong danh sách **thử lại khi** của bạn và liên hệ vẫn còn lượt thử. Liên hệ
hết lượt thử được đánh dấu là *đã hết lượt*; lỗi không thể thử lại được
đánh dấu là *thất bại*.
Quay số sẽ tự động tạm dừng khi số dư tài khoản của bạn không ở trạng thái
tốt và tiếp tục khi số dư trở lại bình thường. Bật
[nạp tiền tự động](/vi/guides/billing-and-topups) cho chiến dịch dài.
## Theo dõi và kiểm soát
Mỗi thẻ chiến dịch hiển thị trạng thái và tiến độ (ví dụ: "173 trên 248
đã hoàn tất"). Mở một chiến dịch để xem chi tiết trạng thái, kết quả theo
từng liên hệ và các cuộc gọi gần đây — mỗi mục đều liên kết đến bản chép
lời và bản ghi đầy đủ trong lịch sử cuộc gọi.
- **Tạm dừng / tiếp tục** — việc tạm dừng ngăn các lượt quay số mới; các cuộc gọi
đang diễn ra sẽ kết thúc tự nhiên. Có thể chỉnh sửa và tiếp tục các chiến dịch đã tạm dừng.
- **Hủy** — dừng chiến dịch vĩnh viễn.
- Một chiến dịch tự hoàn tất khi mọi liên hệ đạt trạng thái cuối cùng
hoặc thời gian **kết thúc lúc** đã qua.
Trạng thái chiến dịch: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Trạng thái liên hệ: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.
## Bước tiếp theo
Nghe các cuộc gọi trong chiến dịch khi chúng diễn ra.
Thực hiện từng cuộc gọi theo chương trình.