POST: https://twin24.ai/cis/api/v1/telephony/autoCall
Этот метод позволяет создать новое задание на автоматический обзвон. После успешного выполнения запроса будет возвращен идентификатор созданного задания.
Время запуска задания зависит от параметра
startType.
curl --request POST \
--url https://twin24.ai/cis/api/v1/telephony/autoCall \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"name": "string",
"defaultExec": "string",
"defaultExecData": "string",
"secondExec": "string",
"secondExecData": "string",
"cidType": "string",
"cidData": "string",
"startType": "string",
"cps": "string",
"startMoment": "Y-m-d H:i",
"additionalOptions": {
"fullListMethod": "string",
"fullListTime": 0,
"useTr": true,
"allowCallTimeFrom": 0,
"allowCallTimeTo": 0,
"recordCall": true,
"recTrimLeft": true,
"detectRobot": true,
"detectRobotMode": "string",
"detectRobotGreeting": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
"fz230": true,
"providerId": "bce7d22e-dde6-4427-b391-ebbdfda44de6"
},
"redialStrategyOptions": {
"redialStrategyEn": true,
"busy": {
"redial": true,
"time": 0,
"count": 0
},
"noAnswer": {
"redial": true,
"time": 0,
"count": 0
},
"answerMash": {
"redial": true,
"time": 0,
"count": 0
},
"congestion": {
"redial": true,
"time": 0,
"count": 0
},
"answerNoList": {
"redial": true,
"time": 0,
"count": 0
},
"candidateLimit": {
"redial": true,
"time": 0,
"count": 0
},
"numberLimit": {
"redial": true,
"time": 0,
"count": 0
}
},
"taskComment": "string",
"webhookUrls": [],
"phoneNormalization": "RU",
"normalizationErrorAction": "IGNORE_NORMALIZATION_ERROR",
"callStrategy": "STEP_2_STEP",
"checkPhone": true,
"sendReportAfterFinish": true,
"scheduleId": "bce7d22e-dde6-4427-b391-ebbdfda44de6"
}
{
"name": "test_autocall",
"defaultExec": "robot",
"defaultExecData": "228cc4fa-92f2-4709-94e3-7344a96a5903",
"secondExec": "ch",
"secondExecData": "48a77bd7-8762-4e0f-a277-4ef77e36c41b",
"cidType": "gornum",
"cidData": "9a67dee5-398e-4570-9426-fbb3f067b270",
"startType": "time",
"startMoment": "2023-06-02 10:00",
"cps": 1.03,
"taskComment": "Тестовое задание для демонстрации работы API",
"webhookUrls": [
"https://webhook.site/6f44...2aa287f",
"https://typedwebhook.tools/webhook/4c6d9...8720ab39"
],
"additionalOptions": {
"fullListMethod": "reject",
"fullListTime": 0,
"useTr": false,
"allowCallTimeFrom": 0,
"allowCallTimeTo": 86399,
"recordCall": true,
"recTrimLeft": 0,
"detectRobot": true,
"detectRobotMode": "back",
"providerId": null
},
"redialStrategyOptions": {
"redialStrategyEn": false,
"candidateLimit": {
"redial": false,
"count": 0
},
"numberLimit": {
"redial": false,
"count": 0
},
"busy": {
"redial": false,
"time": 1,
"count": 1
},
"noAnswer": {
"redial": false,
"time": 1,
"count": 1
},
"answerMash": {
"redial": false,
"time": 1,
"count": 1
},
"congestion": {
"redial": false,
"time": 1,
"count": 1
},
"answerNoList": {
"redial": false,
"time": 1,
"count": 1
}
}
}
| Название | Тип | Обязательное | Описание |
|---|---|---|---|
name |
string | Да | Имя задания. |
defaultExec |
string | Да | Всегда принимает значение robot. |
defaultExecData |
string | Да | UUID сценария для обзвона. |
secondExec |
string | Да | Действие при переадресации (end (Завершить), ignore (Ничего не делать), ch (Передать вызов на канал)). |
secondExecData |
string | Да, если secondExec = ch |
UUID канала для перевода. |
cidType |
string | Да | Определяемый номер (default (По умолчанию для транка), gornum (Один номер), pool (Группа номеров)). |
cidData |
string | Да, если cidType = gornum или pool |
ID сущности в cidType. |
startType |
string | Да | Режим запуска (manual (Вручную), time (В указанное время)). |
startMoment |
string | Да, если startType = time |
Дата и время начала обзвона (ГГГГ-ММ-ДД ЧЧ:ММ). |
cps |
float | Да | Интенсивность обзвона. Рассчитывается как 1 + N / 100 для N звонков в секунду (пример: N = 3, тогда CPS = 1.03), или как 1 - N / 100 для 1 звонка в N секунд (пример: N = 60, тогда CPS = 0.4). |
{
"id": {
"identity": "bce7d22e-dde6-4427-b391-ebbdfda44de6"
}
}
Описание полей ответа:
| Название | Тип | Обязательное | Описание |
|---|---|---|---|
id |
object | Да | Идентификатор задания. |
identity |
string | Да | Уникальный ID обзвона. |
{
"timestamp": 1544098870,
"type": "MyNamespace\\MyClass",
"error": "string",
"details": {}
}
Описание полей ответа:
| Название | Тип | Обязательное | Описание |
|---|---|---|---|
timestamp |
integer | Да | Текущее время. |
type |
string | Да | Класс исключения. |
error |
string | Да | Сообщение об ошибке. |
details |
object | null | Нет | Дополнительная информация об ошибке. |