Java-Script API для звонков по клик-вызову

[gch]

Этот текст является частью руководства по созданию клик-вызова с произвольным дизайном. Другая часть руководства находится здесь

Итак, для интеграции клик-вызова с вашим сайтом вы можете воспользоваться функциональностью нашего API.
Для этого добавьте вызов скрипта на страницу вашего сайта:

Код: Выделить всё

<script src="http://comtube.com/get_js.php?option=callme_api" charset="utf-8" type="text/javascript"></script>

После подгрузки скрипта станет доступен объект clmAPI.

Как пользоваться?

1. Узнайте свой идентификатор клик-вызова. В разделе Клик-вызов:клик-вызовы выберите клик-вызов, идентификатор которого вы хотите узнать. Зайдите в раздел "HTML-код" и обратите внимание на подзаголовок "ссылка для доступа к услуге". Идентификатор клик-вызова (он же hash) - это последовательность символов, располагающаяся правее hash=. Пример значения: SkGVxDL6WpVkyor0@On6dw
   
2. Сконфигурируйте объект clmAPI с помощь его функций:
   
   

   Код: Выделить всё

   clmAPI.setHash(hash)

   
   - установка идентификатора клик-вызова.
   
   Входной параметр:
   - hash - это строка, являющаяся идентификатором клик-вызова.
   
   
   

   Код: Выделить всё

   clmAPI.setCallSuccessCallback(func)

   
   - установка callback-функции, вызываемой в случае успешного телефонного вызова
   
   Входной параметр:
   - func - пользовательская callback-функция. По умолчанию устанавливается следующая callback-функция:
   

   Код: Выделить всё

   function() {
    alert('Calling now.. (Replace this callback by yours)')
};

   
   
   
   

   Код: Выделить всё

   clmAPI.setCallFailCallback(func)

   
   - установка callback-функции, вызываемой, в случае возникновения ошибки при попытки совершить телефонный вызов.
   
   Входной параметр:
   - func - пользовательская callback-функция. В неё передаются объект с кодами и описаниями ошибок (errObj). По умолчанию устанавливается следующая callback-функция:
   

   Код: Выделить всё

   function(errObj) {
    alert('Fail to call. err = ' + errObj.err + ', err.desc = ' + errObj.err_desc + ' (Replace this callback by yours)')
};

   
   
   
   

   Код: Выделить всё

   clmAPI.call(phone_num)

   
   - звонок на указанный номер
   
   Входной параметр:
   - phone_num - это строка с телефонным номером. При указании телефонного номера убедитесь, что вы ознакомлены с порядком ввода номеров.
   
   
3. Создайте свой произвольный дизайн страницы с вводом номера для связи через клик-вызов и укажите требуемые обработчики событий, которые будут вызывать clmAPI.call(phone_num)
   Например такими могут быть ваш элемент ввода номера и кнопка "позвонить":
   
   

   Код: Выделить всё

   <input type="text" autocomplete="off" id="click-to-call-input" />
<input type="button" onclick="clmAPI.call( document.getElementById('click-to-call-input').value )" value="Позвонить!" />

Обращаем ваше внимание на то, что при использовании API необходимым условием является то, что вы обязуетесь поставить ссылку на описание услуги клик-вызов на нашем сайте http://www.comtube.ru/index/callme_about (т.е. написать "powered by comtube", вместо comtube - наш логотип http://comtube.com/res/images/comtube_logo_small10.gif). Ссылка может находится во всплывающем окне (т.е. не видна посетителям вашего сайта сразу), главное, чтобы она была в принципе.

[gch]

Пример использования API. Скопируйте данный HTML-код, замените значение YOUR_HASH и вставьте на вашу страницу.

Код: Выделить всё

<script src="http://comtube.com/get_js.php?option=callme_api&lang=ru" charset="utf-8" type="text/javascript"></script>

<table>
<tr>
    <td>Введите номер:</td>
    <td><input id="phonenum" type="text" onkeydown="callmeCheckEnter(event);" autocomplete="off"></td>
    <td><input type="button" onclick="callmeCall()" value="Позвонить"></td>
</tr>
</table>
<div id="result"></div>

<script type="text/javascript">

function callmeInit() {
    clmAPI.setHash('YOUR_HASH');
   
    var failCallback = function(errObj) {
        var block = document.getElementById('result');
        var str = 'Позвонить не удалось, ' + errObj.err_desc;
       
        block.innerHTML = str;
    };
   
    var successCallback = function() {
        var block = document.getElementById('result');
        var str = 'Ждите звонка!';
       
        block.innerHTML = str;
    };
   
    clmAPI.setCallSuccessCallback(successCallback)
    clmAPI.setCallFailCallback(failCallback)
}

function callmeCall()
{
    callmeInit();
   
    var phonenum = document.getElementById('phonenum').value;
   
    clmAPI.call(phonenum);
}

function callmeCheckEnter(event)
{
    if (checkHitEnter(event))
    {
        callmeCall();
    }
}

function checkHitEnter(evt)
{
    evt = evt || window.event;
    var key = evt.keyCode || evt.charCode || evt.which;
    return (key == 13)
}
</script>