Gọi tự động sử dụng callBot

API gọi tự động

Gọi tự động tới một số điện thoại khách hàng

POST [URL]/api/call_bot/execute_by_phone

Tạo một phiên callBot với tham số đầu vào là một kịch bản callbot và 1 danh sách các thông tin liên hệ

Query Parameters

Name	Type	Description
cid*	String	Số hotline hay số SIP sẽ thực hiện chạy phiên. Nếu gọi nội mạng, truyền giá trị rỗng.

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string	Access Token Bearer token
x-api-key*	String	API key được cung cấp

Request Body

Name	Type	Description
speed	number	Tốc độ đọc.Từ chậm : -3. Đến nhanh : 3. Mặc định là 0
voice	string	Giọng đọc, có thể một trong các giá trị sau + "northern_female_ngocanh" : Ngọc Anh + "southern_female_honganh" : Hồng Anh + "southern_male_tienhuy" : Tiến HuyQ
cid	string	Đầu số dùng để gọi tự động. Nếu không truyền, mặc định ưu tiên gọi nội mạng
name	string	Tên của phiên gọi tự động
num_retry	Integer	Số lần gọi lại khi không nghe máy. Mặc định là 0
num_per_call	Integer	Số cuộc gọi mỗi lần. Mặc định là 15
distance_per_call	Integer	Khoảng cách thời gian , giữa các lần gọi. Mặc định là 30s
distance_retry	Integer	Khoảng cách giữa các lần gọi lại . Mặc định là 0
bot_script_id	String	Id kịch bản, được lấy ở danh sách trong hệ thống
send_time	Number	Thời gian thực hiện phiên (milisecond) Nếu không truyền giá trị, sẽ thực hiện gọi ngay
contact_info*	Array	Danh sách contact cần gọi Giá trị: { "phone":"0395187***", "email":"", "ext_contact_code":"", "mapping_variables":{ "gender1":"Anh", "full_name":"Trần Văn Tiến", "address":"Phan Huy Ích", "mail":"tientv@***.com", "birthday":"11/10/19***" } } phone : Số điện thoại KH email: Email khách hàng nếu có ext_contact_code : Mã KH bên thứ 03 mapping_variables : Hỗ trợ cho phép truyền biến động từ đối tác. Danh sách và chi tiết biến động cần truyền trong (API lấy danh sách KB Callbot)
ext_session_id	String	Mã định danh phiên bên ngoài CRM (tránh trường hợp lên trùng phiên do double summit) Nếu có giá trị field này, mới kiểm tra trùng

200 Thông tin phiên gọi tự động

{
    "instance_id": "stg",
    "payload": {
        "bot_script_id": "653b155db0f794**********",
        "autocall_id": "6552de1891be25**********",
        "errors" : [
		    	{
		  	  	"phone" : "09xxxxxxxx",
		  	  	"error_code" : "number_dnc",
		    		"message" : "Number DNC"
		    	}
	    	]
    },
    "instance_version": "1.2.164",
    "key_enabled": false,
    "status_code": 9999
}

Lấy danh sách kịch bản bot

GET [URL]/api/call_bot/script/list

Lấy danh sách kịch bản callBot do khách hàng thiết lập

200: OK

{
	"instance_id": "stg",
	"payload": [
		{
			"id": "64915bc76a690c0edad14723",
			"name": "Thông báo điểm thi",
			"variables": [
				{
					"field_name": "tên thí sinh",
					"field_code": "tên thí sinh",
					"field_value": "",
					"field_type": "",
					"type": "",
					"is_dynamic_attribute": true
				},
				{
					"field_name": "Toán",
					"field_code": "uB131frQEU",
					"field_value": "",
					"field_type": "single_text",
					"type": "CONTACT",
					"is_dynamic_attribute": true
				}
			]
		},
		{
			"id": "64a922f61900954f5419d503",
			"name": "Cảnh báo từ khóa tiêu cực",
			"variables": [
				{
					"field_name": "",
					"field_code": "nhanvien",
					"field_value": "",
					"field_type": "",
					"type": "",
					"is_dynamic_attribute": true
				},
				{
					"field_name": "",
					"field_code": "tenkhachhang",
					"field_value": "",
					"field_type": "",
					"type": "",
					"is_dynamic_attribute": true
				},
				{
					"field_name": "",
					"field_code": "sodienthoai",
					"field_value": "",
					"field_type": "",
					"type": "",
					"is_dynamic_attribute": true
				},
				{
					"field_name": "",
					"field_code": "thoigiangoi",
					"field_value": "",
					"field_type": "",
					"type": "",
					"is_dynamic_attribute": true
				},
				{
					"field_name": "",
					"field_code": "diem",
					"field_value": "",
					"field_type": "",
					"type": "",
					"is_dynamic_attribute": true
				}
			]
		}
	],
	"instance_version": "1.2.164",
	"key_enabled": false,
	"status_code": 9999
}

Đếm số lượng cuộc gọi của phiên

POST [URL]/api/call_bot/call/count

Header

Name	Type	Required	Description
Authorization	String	Yes	Access token: Bearer 'token'
Content-Type	String	Yes	application/json

Request Body

Field	Type	Required	Description
autocall_id	String	Yes	Id của phiên autocall
phones	Arrays	No	Danh sách số điện thoại cần đếm. Nếu để trống sẽ đếm toàn bộ phiên

Example cURL

curl --location '[URL]/api/call_bot/call/count' \
--header 'x-api-key: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{
    "autocall_id": "6912a712f9c97b58c60b9f63",
    "phones": [
        "070599****"
    ]
}'

200: OK

{
    "instance_id": "stg",
    "payload": 0,
    "instance_version": "1.2.164",
    "key_enabled": false,
    "status_code": 9999
}

Lấy chi tiết kịch bản callbot

GET [URL]/api/call_bot/get_by_id/:id

Lấy chi tiết kịch bản callBot do khách hàng thiết lập

Query Parameters

Name	Type	Description
id*	String	Id kịch bản callbot

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string	Access Token Bearer token
x-api-key*	String	API key được cung cấp

200: OK

{
  "instance_id": "stg",
  "instance_version": "1.2.164",
  "key_enabled": false,
  "payload": {
    "id": "69e82c04d06bd25e152a5762",
    "uuid": "0739227b-677f-441f-b09a-9ee9ecc11937",
    "tenant_id": "634cb99eb255dc23e1abfe56",
    "name": "123123",
    "variables": [],
    "connections": [
      {
        "sourceHandle": "1",
        "animated": false,
        "style": {
          "strokeWidth": 3,
          "stroke": "#00B1FF"
        },
        "id": "reactflow__edge-wfyesGZDhO1-xkEm6QmM6M1",
        "source": "wfyesGZDhO",
        "type": "custom",
        "targetHandle": "1",
        "target": "xkEm6QmM6M"
      }
    ],
    "nodes": [
      {
        "id": "wfyesGZDhO",
        "node_type": "BEGIN",
        "next_nodes": [
          "xkEm6QmM6M"
        ],
        "is_collapse": false
      },
      {
        "id": "xkEm6QmM6M",
        "node_type": "STAFF",
        "template_content": "",
        "return_template_content": "",
        "wrong_response_content": "",
        "customer_response_delay": 10000,
        "is_collapse": false,
        "audio_file": {
          "name": "ghi âm.mp3",
          "src": "634cb99eb255dc23e1abfe56/callbot_recording_file/2026/04/9f921f48-8700-4209-808e-0496d45279db.mp3",
          "duration": "21.6",
          "pbx_source": "/mnt/data/freeswitch/recordings/testtruong1710/callbot/2026/04/af684879-3e4e-4f4b-995e-fdfebbc6a6ca.mp3"
        }
      }
    ],
    "is_draft": true,
    "created_date": 1776823300555,
    "last_updated_date": 1776823300894,
    "last_publish_time": 1776823300555,
    "created_by": {
      "id": "634cb99eb255dc23e1abfe59",
      "name": "TruongND",
      "contact_id": "634cb9ba5434a97a92dda131",
      "avatar_url": null,
      "ref_type": null,
      "gender": null,
      "email": null
    },
    "public_key": "cb79b64f-b6a4-4962-a5c7-e1aeea85b530",
    "last_updated_by": {
      "id": "634cb99eb255dc23e1abfe59",
      "name": "TruongND",
      "contact_id": "634cb9ba5434a97a92dda131",
      "avatar_url": null,
      "ref_type": null,
      "gender": null,
      "email": null
    },
    "is_deleted": false,
    "collect_authentication_data": "NONE",
    "system_intent_ids": [],
    "system_entity_type_ids": [],
    "version": 1,
    "is_newest_version": false,
    "is_publish": true,
    "custom_variables": [],
    "classifies": [],
    "variables_with_order": [],
    "speed": 1,
    "voice": "northern_female_ngocanh",
    "type": "NORMAL",
    "is_interrupt": false,
    "parse_datetime": false
  },
  "status_code": 9999
}

Báo cáo phân tích phiên

POST /api/call_bot/analyzed_log/list

Báo cáo dữ liệu đã phân tích, đánh giá giữa Chủ đề, ý định và tính tương thích

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Request Param

Name	Type	Description
page	integer	Trang , mặc định là 1
size	integer	Kích thước trang, mặc định là 50

Body

Name	Type	Description
keyword	string	Từ khoá tìm kiếm
ref_uuid	string	Id phiên của chiến dịch callbot

Response

200

{
    "instance_id": "stg",
    "payload": {
        "items": [
            {
                "_id": "67ee11592f5d1d60570ee70b",
                "tenant_id": "67eb4821758a5a4891925d99",
                "is_deleted": false,
                "created_date": 1743655257449,
                "last_updated_date": 1743655257449,
                "create_by": {
                },
                "last_update_by": {
                },
                "content": "vâng",
                "content_search": "vang",
                "content_logs": [],
                "status": "new",
                "intent": "omi_intent_confirm_right",
                "intent_id": "67ee01eaf05f0746d6d3583c",
                "entities": [],
                "entity_details": [],
                "session_id": "1400d541-0403-40dc-8ab4-12fec19c530b",
                "node_id": "peIbVXdZuH",
                "ref_uuid": "67ee1138e4c40956087cd265",
                "callbot_uuid": "e6465c1d-ab6f-472b-a0bb-e21588298882"
            }
        ],
        "page_number": 1,
        "page_size": 50,
        "total_items": 1,
        "total_pages": 1,
        "has_next": false,
        "next_page": 1,
        "has_previous": false,
        "previous_page": 1,
        "extension": null
    },
    "instance_version": "1.2.164",
    "key_enabled": false,
    "status_code": 9999
}

400