Thêm liên hệ (AddContact)

Thêm mới một khách hàng hoặc số điện thoại vào danh bạ Autocall.

POSThttps://apiai.cloudfone.vn/api/Contact/AddContact

Thêm mới thông tin một khách hàng vào cơ sở dữ liệu danh bạ Autocall để phục vụ các chiến dịch gọi tự động.

Tham số request

Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả chi tiết
`ServiceCode`	string	Có	Mã dịch vụ Autocall (ví dụ: `CF-XXXXX`).
`AuthUser`	string	Có	Mã tài khoản khách hàng.
`AuthKey`	string	Có	Khóa bí mật API do ODS cấp.
`Phone`	string	Có	Số điện thoại của khách hàng (ví dụ: `0900000000`).
`Contact_Name`	string	Không	Tên gợi nhớ định danh liên hệ.
`First_Name`	string	Không	Tên của khách hàng.
`Last_Name`	string	Không	Họ và tên đệm.
`Email_Address`	string	Không	Địa chỉ Email.
`Company`	string	Không	Tên công ty/doanh nghiệp.
`Department`	string	Không	Phòng ban/chức vụ.
`Address`	string	Không	Địa chỉ liên hệ.
`Web_Site`	string	Không	Website của khách hàng.

Ví dụ request

curl -X POST "https://apiai.cloudfone.vn/api/Contact/AddContact" \
  -H "Content-Type: application/json" \
  -d '{
    "ServiceCode": "YOUR_SERVICE_CODE",
    "AuthUser": "YOUR_AUTH_USER",
    "AuthKey": "YOUR_AUTH_KEY",
    "Phone": "0900000000",
    "Contact_Name": "Nguyen Van A",
    "First_Name": "A",
    "Last_Name": "Nguyen Van",
    "Email_Address": "[email protected]",
    "Company": "ODS JSC",
    "Address": "TP. Ho Chi Minh"
  }'

Response mẫu

{
  "result": "success",
  "message": "",
  "data": 1052
}

Cấu trúc phản hồi

Bảng mô tả trường

Trường	Kiểu dữ liệu	Mô tả
`result`	string	Trạng thái xử lý (`success` hoặc `failed`).
`data`	number	Mã `ContactId` của khách hàng vừa tạo (dùng để thêm vào nhóm).

Lưu ý quan trọng

Định dạng số điện thoại: Trường Phone phải là chuỗi số hợp lệ (ví dụ: 0900000000 hoặc 84900000000), không chứa dấu chấm, khoảng trắng hay ký tự gạch nối.
Quy trình gán nhóm: Tạo liên hệ xong hệ thống trả về mã data (chính là ContactId). Bạn cần tiếp tục gọi API AddContactToGroup để gán liên hệ này vào nhóm chiến dịch.

Thêm liên hệ (AddContact)

Tham số request

Cấu trúc phản hồi

Bảng mô tả trường

Lưu ý quan trọng

Lỗi thường gặp

Bài viết liên quan

Thêm liên hệ vào nhóm

Tạo nhóm liên hệ

Thêm liên hệ (AddContact)

400 Bad Request / result: failed

Thêm liên hệ vào nhóm

Tạo nhóm liên hệ