PHPackages                             bigperson/kontur-talk-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. bigperson/kontur-talk-sdk

ActiveLibrary[API Development](/categories/api)

bigperson/kontur-talk-sdk
=========================

PHP SDK для работы с API Kontur.Talk

v1.0.1(1y ago)22MITPHPPHP &gt;=8.2CI passing

Since Mar 14Pushed 1y ago1 watchersCompare

[ Source](https://github.com/bigperson/kontur-talk-sdk)[ Packagist](https://packagist.org/packages/bigperson/kontur-talk-sdk)[ RSS](/packages/bigperson-kontur-talk-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (5)Versions (3)Used By (0)

PHP SDK для работы с API Kontur Talk
====================================

[](#php-sdk-для-работы-с-api-kontur-talk)

[![Tests](https://github.com/bigperson/kontur-talk-sdk/actions/workflows/tests.yml/badge.svg)](https://github.com/bigperson/kontur-talk-sdk/actions/workflows/tests.yml)[![Latest Stable Version](https://camo.githubusercontent.com/b7bbb1b253c1d28553e7396e13e88e867e02a5de18f998e764cc62e16c3d4004/68747470733a2f2f706f7365722e707567782e6f72672f626967706572736f6e2f6b6f6e7475722d74616c6b2d73646b2f762f737461626c65)](https://packagist.org/packages/bigperson/kontur-talk-sdk)[![Total Downloads](https://camo.githubusercontent.com/ad16c5fdec13b0a0bb6892e84853294ae8f303c86ed924499ec32c9796030e30/68747470733a2f2f706f7365722e707567782e6f72672f626967706572736f6e2f6b6f6e7475722d74616c6b2d73646b2f646f776e6c6f616473)](https://packagist.org/packages/bigperson/kontur-talk-sdk)[![License](https://camo.githubusercontent.com/2d9b298fa283e870f5c064334a000143319770afa66fb4d300c66aabbda4d840/68747470733a2f2f706f7365722e707567782e6f72672f626967706572736f6e2f6b6f6e7475722d74616c6b2d73646b2f6c6963656e7365)](https://packagist.org/packages/bigperson/kontur-talk-sdk)

[![PHP Version](https://camo.githubusercontent.com/d840cef9807c8f76051ad687841d67f4d830c84e0d83236968e53124ef6742d5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e322d3838393242462e737667)](https://www.php.net/)

Неофициальный PHP SDK для удобной интеграции с API сервиса Контур.Толк.

> **Важно:** Данный SDK не является официальным продуктом компании СКБ Контур и разрабатывается независимо.

Установка
---------

[](#установка)

```
composer require bigperson/kontur-talk-sdk
```

Использование
-------------

[](#использование)

### Инициализация клиента

[](#инициализация-клиента)

```
use Kontur\Talk\TalkClient;

// Создание клиента API
$client = new TalkClient('company', 'your-api-key');
```

### Работа с пользователями

[](#работа-с-пользователями)

```
// Получение списка пользователей
$users = $client->users->get(100, 0, null, [], null, false, true);

// Получение пользователя по ключу
$user = $client->users->getByKey('user-key');

// Создание или обновление пользователей
$result = $client->users->createOrUpdate([
    [
        'email' => 'user@example.com',
        'firstname' => 'Иван',
        'surname' => 'Иванов',
        'post' => 'Менеджер'
    ]
]);

// Блокировка пользователя
$client->users->setPermissions('user-key', true);

// Разблокировка пользователя
$client->users->setPermissions('user-key', false);
```

### Работа с ролями

[](#работа-с-ролями)

```
// Получение списка ролей
$roles = $client->roles->getAll();

// Получение информации о роли
$role = $client->roles->get('admin', true);

// Создание роли
$newRole = $client->roles->create('Тестировщик', 'Роль для тестировщиков', [
    [
        'productId' => 'talk',
        'permissionId' => 'remoteControl'
    ]
]);

// Управление ролями пользователя
$client->roles->manageUserRoles('user-key', ['admin'], ['kioskAdmin']);
```

### Работа с комнатами

[](#работа-с-комнатами)

```
// Получение информации о комнате
$room = $client->rooms->get('room-key');

// Создание или обновление комнаты
$room = $client->rooms->createOrUpdate(
    'room-key',
    'Тестовая комната',
    'Описание комнаты',
    ['moderator-key-1', 'moderator-key-2'],
    new DateTime('2023-12-31T23:59:59Z'),
    true,
    false,
    'none',
    'none',
    'none',
    0
);

// Добавление модератора
$client->rooms->addModerator('room-key', 'user-key');

// Установка PIN-кода
$client->rooms->setPinCode('room-key', '123456');

// Удаление PIN-кода
$client->rooms->setPinCode('room-key', '');

// Принудительное завершение конференции
$client->rooms->endConference('room-key');
```

### Исходящие звонки

[](#исходящие-звонки)

```
// Выполнение исходящего звонка
$result = $client->rooms->notifyCall(
    'room-key',
    'Тестовая комната',
    'caller-user-key',
    [
        [
            'userKey' => 'callee-user-key',
            'userCallMethod' => 'talk'
        ],
        [
            'phoneNumber' => '+7 (999) 123-45-67'
        ],
        [
            'email' => 'user@example.com'
        ]
    ]
);

// Отмена звонка
$client->rooms->cancelCall('room-key');
```

Документация
------------

[](#документация)

Подробная документация по API доступна в официальной документации Контур.Толк.

Обработка ошибок
----------------

[](#обработка-ошибок)

SDK использует исключения для обработки ошибок:

```
use Kontur\Talk\Exception\TalkApiException;
use Kontur\Talk\Exception\TalkClientException;
use Kontur\Talk\Exception\TalkRateLimitException;
use Kontur\Talk\Exception\TalkNotFoundException;

try {
    $users = $client->users->get();
} catch (TalkNotFoundException $e) {
    // Ресурс не найден
    echo "Ресурс не найден: " . $e->getMessage();
} catch (TalkRateLimitException $e) {
    // Превышены ограничения по количеству запросов
    echo "Превышен лимит запросов к API: " . $e->getMessage();
} catch (TalkApiException $e) {
    // Ошибка API (400-499)
    echo "Ошибка API: " . $e->getMessage();
} catch (TalkClientException $e) {
    // Общая ошибка клиента
    echo "Ошибка клиента: " . $e->getMessage();
}
```

Требования
----------

[](#требования)

- PHP 8.2 или выше
- Guzzle HTTP 7.0 или выше
- Расширение JSON

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance45

Moderate activity, may be stable

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

425d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4d5dccbd021fd3882613034b49a5d0d6726d5a16a0224e99b5359d6058719265?d=identicon)[bigperson](/maintainers/bigperson)

---

Top Contributors

[![bigperson](https://avatars.githubusercontent.com/u/4757391?v=4)](https://github.com/bigperson "bigperson (13 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/bigperson-kontur-talk-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/bigperson-kontur-talk-sdk/health.svg)](https://phpackages.com/packages/bigperson-kontur-talk-sdk)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
