Skip to main content

Конференц-звонок по запросу из API

«Вызов (конференция) по запросу» автоматически соединяет инициатора с абонентами из заданного списка. Сначала звонок поступает инициатору, после его ответа система последовательно обзванивает номера получателей. Для управления сценарием звонка предусмотрены четыре опциональных аудиофайла:

  1. «Файл оповещения инициатору» (приветствие в начале),
  2. «Файл оповещения соединяемому» (сообщение абоненту перед разговором),
  3. «Файл оповещения следующей попытки» (информирует инициатора о переборе номеров при неудаче) и
  4. «Файл оповещения когда не удалось соединить» (финальное сообщение при недозвоне по всему списку).

Если файл не выбран, соответствующий этап проходит без звукового уведомления. Оповещения прикрепляются в разделы "файлы"

Метод POST
https://cld.alovoice.uz/requestcall/{token}

Параметры при соединении двух контактов (двухсторонний звонок) multipart/form-data

{

  "callfrom": {"phone": "712037006", "lang": "ru"},
  "callto": [{"phone": "994412860", "lang": "ru"}, {"phone": "977076909", "lang": "uz"}, {"phone": "914379766", "lang": "ru"}],
  "extid": "123123"
}

{

  "callfrom": {"phone": "712037006", "lang": "ru"},
  "callto": [{"queue": "1"}],
  "extid": "123123"
}

{

  "callfrom": {"phone": "712037006", "lang": "ru"},
  "callto": [{"queue": "6000"}],
  "extid": "123123"
}

Параметры при соединении контакта с IVR multipart/form-data

{
  "callto": "712037006",
  "ivrid": 222,
  "fromline": 712037006
  "extid": "123123"
}

Описание параметров

callto - Номер принимающий звонок [XXXXXXX или +XXXXXXXXXXXX] (обязательно)

ivrid - ID IVR из настроек VPS в AloVoice

fromline - Номер линии который доступен VPSу в AloVoice

extid - ID или уникальный номер звонка в вашей системе

callfrom - Номер инициатора двухстороннего звонока [XXXXXXX или +XXXXXXXXXXXX] (обязательно если двухсторонний звонок)

lang - Язык общения по IVR (по умолчанию ru или выбор в IVR)

Ожидаемый результат (если есть обратный урл для результатов)

URL для обратных результатов передается специалистам AloVoice для регистрации

{
	id: <int> (ID звонка),
	from_number: <string> (Номер инициатора двухстороннего звонока),
	to_number: <string> (Номер принимавшего звонок),
	trunk_number: <string|int> (Номер линии),
	begin_time: <int> (Время звонка - UnixTimestamp),
	answer_time: <int> (Время ответа на звонок - UnixTimestamp),
	end_time: <int> (Время окончания звонка - UnixTimestamp),
	duration: <int> (Длительность звонка),
	dialstatus: <string> (Статус звонка),
	record: <string> (Ссылка к записи звонка),
	externalid: <int> (Внешний ID звонка),
	attempts: <array|object|string> (Попытки)
}

Входящий запрос по APIЗвонок Инициатору🔈 Файл: Оповещение инициатору(Если задан)Звонок Соединяемому(По списку)Успех?Нет / Занят🔈 Файл: След. попыткаСледующий номерСписок пуст🔈 Файл: Не удалосьКонец звонкаДа🔈 Файл: СоединяемомуСОЕДИНЕНИЕРазговор начат