maxim-oleinik/gravitel

PHP client for Gravitel API

0.2.0 2019-01-09 09:27 UTC

This package is auto-updated.

Last update: 2024-11-09 22:23:00 UTC


README

Latest Stable Version

doc version: 2017-08

Install

  1. Add to composer

     composer require maxim-oleinik/gravitel
    
  2. Implement \Gravitel\TransportInterface

     class MyHttpTransport implements \Gravitel\TransportInterface
    

Send Command

Список исходящих команд

  • Инициировать звонок

      /**
       * @param  string $user     - Логин оператора
       * @param  string $phone    - Номер телефона куда звоним
       * @param  string $phoneExt - Номер исходящего телефона для АОН
       */
      \Gravitel\Gravitel::makeCall($user, $phone, $phoneExt = null): \Gravitel\Response\MakeCallResponse`
    
  • Получить список групп

      \Gravitel\Gravitel::groups(): \Gravitel\Response\Group[]
    
  • Включить или выключить прием звонков сотрудником во всех его отделах

      \Gravitel\Gravitel::subscribeOnCalls($user, $enable, $groupId = null)
    

Вызов и обработка ошибок

    $gravitel = new Gravitel(new MyHttpTransport, $gravitelApiUrl, $gravitelApiToken);
    try {
        $response = $gravitel->makeCall($login, $phone);
    } catch (\Gravitel\Error $e) {
        $e->getCode(); // 400, 401, 500
        $e->getMessage();
        $e->getDebugInfo();
    }

Callback

Обработка входящих запросов от Гравител

    $cmd = \Gravitel\Callback\CallbackFactory::make($_REQUEST);

    // Проверка токена (Авторизация)
    if ($cmd->crm_token != $myPrivateToken) {
        throw new \InvalidArgumentException(__METHOD__.": Token invalid `{$cmd->crm_token}`");
    }

    switch (get_class($cmd)) {
        case \Gravitel\Callback\HistoryCmd::class:
            // ...
            break;
        case \Gravitel\Callback\EventCmd::class:
            // ...
            break;
        case \Gravitel\Callback\ContactCmd::class:
            // ...
            break;
        default:
            break;
    }