voximplant.infocall.startwithtext
Осуществить автозвонок голосовым роботом
Описание
Метод voximplant.infocall.startwithtext запускает автозвонок и воспроизводит получателю заданный текст с помощью синтеза речи.
Параметры
FROM_LINE
string
обязательный
Идентификатор исходящей линии, с которой запускается звонок.
Список доступных линий можно получить методом voximplant.line.get
TO_NUMBER
string
обязательный
Номер, на который нужно выполнить звонок
TEXT_TO_PRONOUNCE
string
обязательный
Текст, который будет озвучен получателю
VOICE
string
необязательный
Идентификатор голоса для синтеза речи.
Если не передан, используется голос по умолчанию для языка портала.
Список доступных голосов можно получить методом voximplant.tts.voices.get
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"FROM_LINE":"reg151083","TO_NUMBER":"79991234567","TEXT_TO_PRONOUNCE":"Добрый день. Напоминаем о записи"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/voximplant.infocall.startwithtext
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"FROM_LINE":"reg151083","TO_NUMBER":"79991234567","TEXT_TO_PRONOUNCE":"Добрый день. Напоминаем о записи","auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/voximplant.infocall.startwithtext
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
// Shape of the payload returned in result (match the "response handling" section of the page)
type InfocallStartWithTextResult = {
RESULT: boolean
CALL_ID: string
}
try {
const response = await $b24.actions.v2.call.make<InfocallStartWithTextResult>({
method: 'voximplant.infocall.startwithtext',
params: {
FROM_LINE: 'reg151083',
TO_NUMBER: '79991234567',
TEXT_TO_PRONOUNCE: 'Good afternoon. Reminder about your appointment',
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info('Infocall started:', result.RESULT, 'Call ID:', result.CALL_ID)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function startInfocallWithText() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'voximplant.infocall.startwithtext',
params: {
FROM_LINE: 'reg151083',
TO_NUMBER: '79991234567',
TEXT_TO_PRONOUNCE: 'Good afternoon. Reminder about your appointment',
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info('Infocall started:', result.RESULT, 'Call ID:', result.CALL_ID)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', startInfocallWithText)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.voximplant.infocall.startwithtext(
from_line='reg151083',
to_number='79991234567',
text_to_pronounce='Добрый день. Напоминаем о записи',
).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
try {
$response = $b24Service
->core
->call(
'voximplant.infocall.startwithtext',
[
'FROM_LINE' => 'reg151083',
'TO_NUMBER' => '79991234567',
'TEXT_TO_PRONOUNCE' => 'Добрый день. Напоминаем о записи',
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error: ' . $e->getMessage();
}
BX24.callMethod(
'voximplant.infocall.startwithtext',
{
FROM_LINE: 'reg151083',
TO_NUMBER: '79991234567',
TEXT_TO_PRONOUNCE: 'Добрый день. Напоминаем о записи'
},
function(result)
{
if (result.error())
{
console.error(result.error(), result.error_description());
}
else
{
console.log(result.data());
}
}
);
require_once('crest.php');
$result = CRest::call(
'voximplant.infocall.startwithtext',
[
'FROM_LINE' => 'reg151083',
'TO_NUMBER' => '79991234567',
'TEXT_TO_PRONOUNCE' => 'Добрый день. Напоминаем о записи',
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "voximplant.infocall.startwithtext", b24.Params{
"FROM_LINE": "reg151083",
"TO_NUMBER": "79991234567",
"TEXT_TO_PRONOUNCE": "Добрый день. Напоминаем о записи",
})
if err != nil {
return fmt.Errorf("voximplant.infocall.startwithtext: %w", err)
}
var item struct {
Result bool `json:"RESULT"`
CallID string `json:"CALL_ID"`
}
if err := json.Unmarshal(res.Result, &item); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println(item.Result, item.CallID)
Ответ
HTTP-статус: 200
{
"result": {
"RESULT": true,
"CALL_ID": "infocall.4aa8f8e35bb6ece352fec0537b58ac42.1773740701"
},
"time": {
"start": 1773740709,
"finish": 1773740710.094622,
"duration": 1.0946218967437744,
"processing": 1,
"date_start": "2026-03-17T12:45:09+03:00",
"date_finish": "2026-03-17T12:45:10+03:00",
"operating_reset_at": 1773741309,
"operating": 0.14156007766723633
}
}
Возвращаемые данные
result
object
Объект с результатом запуска автозвонка
RESULT
boolean
Признак успешного запуска.
true — автозвонок успешно запущен
CALL_ID
string
Идентификатор звонка
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": "ERROR_CORE",
"error_description": "Infocall limit for this month is exceeded"
}
| Код | Описание | Значение |
|---|---|---|
ERROR_CORE |
Making infocall using LINK_BASE_NUMBER is not allowed |
Нельзя запускать автозвонок через служебную линию |
ERROR_CORE |
Could not find config for number <LINE_ID> |
Не найдена конфигурация для указанной линии |
ERROR_CORE |
Infocall limit for this month is exceeded |
Превышен месячный лимит автозвонков |
ERROR_CORE |
Phone number is not correct |
Некорректный номер в TO_NUMBER |
ERROR_CORE |
Infocall failure |
Ошибка при запуске автозвонка |
ACCESS_DENIED |
Access denied |
Недостаточно прав на выполнение исходящих звонков |

