makeCallBackCallFollowme - данный метод осуществляет callback между А-номером или номерами переданным в поле simpleCallBackFollowmeStruct  и B-номером.

Точка подключения: https://webapicommon.mtt.ru/index.php

Авторизация: Basic Auth

Метод: POST

Входные параметры

Name

Type

Description

id

string

id, маркер запроса, будет выдан в ответе на запрос.

customer_name*

string

Номер с которого осуществляется вызов, выдается МТТ

b_number*

string

Номер плеча B (по умолчанию). Номер, на который будет совершён звонок, по фактическому ответу плеча A.

caller_id

string

Номер, который будет показан абоненту плеча В. Данный параметр должен устанавливаться, либо в функции setCallBackFollowme либо в функции makecallbackfollowme.

callBackURL

string

URL, на который, будут посылаться уведомления о ходе вызова. Строго без http/www. Конечный файл, куда будут отправляться events должен называться event.php

simpleCallBackFollowmeStruct

array of simpleCallBackFollowmeStruct

Структуру simpleCallBackFollowmeStruct см. в примере успешного запроса

recordEnable

number

Запись звонка. По умолчанию - 1. Записывается.

duration

number

Общая продолжительность попытки вызова (сек.)

client_caller_id

string

Номер, который будет показан абоненту плеча A. По умолчанию - b_number

direction

numberr

Значение 0 или 1. Направление вызова. По умолчанию 0 - redirect_number (Плечо А)-->b_number (плечо B), 1 - b_number (плечо А)-->redirect_number (Плечо B)

callDescription

string

Комментарий к вызову.

dtmf_number

string

Дополнительный номер при наборе.

maxtime

string

Указывается в секундах. Суммарная максимальная длительность разговора по плечу А и по плечу B. По истечении заданного времени CallBack будет завершен.

* - обязательные поля

simpleCallBackFollowmeStruct

Name

Type

Description

order

number

Порядок следования номера при перенаправлении вызова

timeout

number

Таймаут (в секундах)- время дозвона с момента отправки Json запроса на осуществление вызова до прекращения дозвона. 

Рекомендуется устанавливать значение от 15 секунд.

redirect_number

string

Номер плеча А, по умолчанию.

type*

string

Тип очереди, файла, текста.

Возможные значения:
"Ringall" - вызываются все участники структуры, переданные в callBackFollowmeStruct (плечо А);
"Lineral" - вызов участников группы (плечо А), переданных в callBackFollowmeStruct, происходит последовательно.

name

string

Символьное имя номера для перенаправления вызова

side

string

Плечо для проигрывания файла или сообщения (А или В)

value

string

Информация для проигрывания или имя файла

* - обязательные поля

Выходные параметры

Name

Type

Description

callBackCall_id

string

Уникальный идентификатор вызова

Пример

Данный пример запроса с ранее установленной структурой вызова (см. setCallBackFollowme):

{
    "id": "1",
    "jsonrpc": "2.0",
    "method": "makeCallBackCallFollowme",
    "params": {
        "customer_name" : "883140500000000",
        "b_number" : "+79157775533"
     }
}

Данный пример запроса без предварительной установки структуры вызова - функцией setCallbackfollowme, передача структуры simpleCallBackFollowmeStruct в теле запроса makeCallBackCallFollowme:

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "makeCallBackCallFollowme",
  "params": {
    "customer_name": "883140500000000",
    "b_number": "7xxxxxxx",
    "callBackURL": "example.com", - СТРОГО без http/www 
    "caller_id" : "7xxxxxxxxxx",
    "recordEnable" : 1,
    "client_caller_id" : "7xxxxxxxxxx",
    "simpleCallBackFollowmeStruct": [
      {
        "order": 1,
        "timeout": 25,
        "redirect_number": "7xxxxxxxxxx",
        "caller_id": "7xxxxxxxxxx",
        "type": "ringall",
        "name": "sales"
      },
      {
        "order": 2,
        "timeout": 25,
        "redirect_number": "7xxxxxxxxxx",
        "caller_id": "7xxxxxxxxxx",
        "type": "ringall",
        "name": "sales_2"
      },
      {
        "order": 3,
        "type": "text", - задается  "Text to speech"( текст в речь)
        "value": "Звонок с сайта все продам ру",
        "side": "A" 
       },
       {
        "order": 4,
        "type": "file", - задается ранее установленный файл в функции "SetCallBackPrompt"
        "value": "for_all_sales",
        "side": "B"
       }
    ]
  }
 }

Успешный ответ

{
    "jsonrpc": "2.0",
    "id": "1",
    "result":
    {
        "callBackCall_id": "1256ffb10774226b390ad1a2bc892c9c"
    }
}

Не успешный ответ

{
    "jsonrpc":"2.0",
    "id":"iar_ringall",
    "result":
    {
        "error":1,
         "message":"Incorrect redirect_number format" - указан некорректный А - номер ( redirect_number)
         "message" : "Incorrect B-number format"- указан некорректный B-номер.
    }
}