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

В данном форуме описаны все API, поддерживаемые нашими услугами.

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

Сообщение gch » 24 дек 2010, 14:33

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

Итак, для интеграции клик-вызова с вашим сайтом вы можете воспользоваться функциональностью нашего 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
 
Сообщения: 172
Зарегистрирован: 30 июл 2009, 15:36
Откуда: Москва

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

Сообщение gch » 10 мар 2011, 20:20

Пример использования 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>
gch
 
Сообщения: 172
Зарегистрирован: 30 июл 2009, 15:36
Откуда: Москва


Вернуться в API

Просмотр страницы «Кто сейчас на форуме COMTUBE»

Сейчас этот форум просматривают: нет зарегистрированных пользователей и гости: 8