Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

URL: https://twin24.ai/cis/api/v1/telephony/incomingRules/create/batch

pycURL
Раскрыть
titlecURL (Нажмите, чтобы раскрыть)
Блок кода
language
python
themeDJango
title
collapsetrue
curl --location 'https://twin24.ai/cis/api/v1/telephony/incomingRules/create/batch' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer TOKEN' \
--data '{
    "additionalOptions": {
        "callRecord": "all",
        "comment": "Комментарий"
    },
    "incomingCallsOptions": {
        "action": "robot",
        "botId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
        "cidAsName": "
num_name
default",
        "cidAsNumber": "
caller
default",
        "reserveAction": "default",
        "reserveActionData": null,
        "reserveCidAsName": "original",
        "reserveCidAsNumber": "original"
    },
   
 "notificationOptions": {
        "
condition
type": "
unanswer
off",
        "
emailReceivers
condition": 
[]
"unanswer",
        "
smsReceivers
emailReceivers": [],
        "
type
smsReceivers": 
"off"
[]
    },
    
"webhookUrls": [
        "https://sample.com"
    ],
    "names": [
        "Название номера 1",
        "Название номера 2"
    ],
    "numbers": [
        "71234567001",
        "71234567002"
    ],
    "connectionOptionsList": [
        {
            "authUser": "",
            "forceOutOverChannel": true,
            "fromDomain": "",
            "login": "",
            "password": "",
            "providerId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
            "did": "123",
            "numberAsDid": false
        },
        {
            "authUser": "",
            "forceOutOverChannel": true,
            "fromDomain": "",
            "login": "",
            "password": "",
            "providerId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
            "did": "456",
            "numberAsDid": true
        }
    ]
}'
Раскрыть
titleТело запроса (Нажмите, чтобы раскрыть)
Блок кода
languagepy
themeDJango
titleТело запроса
collapsetrue
{
    "additionalOptions": {
        "callRecord": "all",
        "comment": "Комментарий"
    },
    "incomingCallsOptions": {
        "action": "robot",
        "botId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
        "cidAsName": "
num_name
default",
        "cidAsNumber": "
caller
default",
        "reserveAction": "default",
        "reserveActionData": null,
        "reserveCidAsName": "original",
        "reserveCidAsNumber": "original"
    },
   
 "notificationOptions": {
        "
condition
type": "
unanswer
off",
        "
emailReceivers
condition": 
[]
"unanswer",
        "
smsReceivers
emailReceivers": [],
        "
type
smsReceivers": 
"off"
[]
    },
    
"webhookUrls": [
        "https://sample.com"
    ],
    "names": [
        "Название номера 1",
        "Название номера 2"
    ],
    "numbers": [
        "71234567001",
        "71234567002"
    ],
    "connectionOptionsList": [
        {
            "authUser": "",
            "forceOutOverChannel": true,
            "fromDomain": "",
            "login": "",
            "password": "",
            "providerId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
            "did": "123",
            "numberAsDid": false
        },
        {
            "authUser": "",
            "forceOutOverChannel": true,
            "fromDomain": "",
            "login": "",
            "password": "",
            "providerId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
            "did": "456",
            "numberAsDid": true
        }
    ]
}

Описание полей метода:

Поле

Тип

Обязательно

Описание

additionalOptions

ObjectНетДополнительные опции

|    callRecord

StringНет

Включить ли запись диалогов. 

Принимает значения:

  • all – включить
  • off – выключить

|    comment

StringНетКомментарий к добавленным номерам

incomingCallsOptions

ObjectДаНастройки правил обработки входящих звонков

|    action

StringДа

Действие при входящем звонке. 

Принимает значения:

  • robot – перевести звонок на робота
  • end – не обрабатывать входящие звонки

|    botId

StringДа, если action = robotИдентификатор бота для перевода

|    cidAsName

StringДа, если action = robot

Имя звонящего

Принимает значения:

  • default – значение по умолчанию (рекомендуемое)
  • num_caller – номер звонящего
  • num_name – название номера
  • num_called – номер назначения (текущий номер)

|    cidAsNumber

StringДа, если action = robot

Номер звонящего

Принимает значения:

  • default – значение по умолчанию (рекомендуемое)
  • caller – номер звонящего
  • called – номер назначения (текущий номер)

|    reserveAction

StringДа, если action = robotВсегда принимает значение default

|    reserveActionData

String

nullДа, если action = robotВсегда принимает значение null

|    reserveCidAsName

StringДа, если action = robotВсегда принимает значение original

|    reserveCidAsNumber

StringДа, если action = robotВсегда принимает значение original

notificationOptions

ObjectДа

Параметры нотификаций (на данный момент не активны, но обязательны для заполнения). 

В описании параметров ниже будет указано только значение, которое нужно передавать в этом поле

|    type

StringДаoff

|    condition

StringДаunanswer

|    emailReceivers

Empty ListДа[
String
]

|    smsReceivers

Empty ListДа[
String
]

|    type

String

webhookUrls

List[String]НетМассив адресов для отправки вебхуков по входящим звонкам

names

List[String]ДаМассив имен добавляемых номеров

numbers

List[String]ДаМассив добавляемых номеров

connectionOptionsList

List[Object]ДаМассив настроек добавляемых номеров

|    authUser

StringНетПользователь для аутентификации

|    forceOutOverChannel

BooleanНет

Принудительно отправлять звонки через данное подключение. 

Если true – любые вызовы в мир будут отправлены через текущего провайдера и с использованием указанных учетных данных

|    fromDomain

StringНетЗначение fromDomain

|    login

StringНетЛогин для авторизации номера

|    password

StringНетПароль для авторизации номера

|    providerId

StringДаИдентификатор транка/оператора

|    did

StringДа, если numberAsDid falseDID (Direct Inward Dialing)

|    numberAsDid

Boolean

...

languagepython
themeDJango
titleОтвет в формате JSON
collapsetrue
ДаЕсли true, то в качестве DID используется сам номер


При успешном выполнении метода придет ответ с кодом 200 без тела

Описание полей ответа:

...

Поле

...

Тип

...