---
title: "WebhooksEntity: вебхуки СДЭК для Joomla и PHP | WT CDEK - WebTolk"
description: "WebhooksEntity для Joomla: подписки на вебхуки и URL обработчика. Документация WT CDEK, параметры API СДЭК и PHP-примеры для разработчиков."
url: "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-webhooks"
date: "2026-11-02T13:07:51+00:00"
language: "ru-RU"
---

## Breadcrumbs

[Главная](https://web-tolk.ru/) > [Расширения Joomla](https://web-tolk.ru/dev) > [Библиотеки](/dev/biblioteki) > [WT CDEK library](/dev/biblioteki/wt-cdek-library-for-joomla-developers) > [Документация](/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation) > WebhooksEntity: вебхуки СДЭК для Joomla и PHP

# WebhooksEntity: вебхуки СДЭК для Joomla и PHP

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

**Категория:** [Библиотеки](https://web-tolk.ru/dev/biblioteki)

[Проект](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers)[Версии](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/versions)[Документация](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation)[GitHub](https://github.com/WebTolk/WT-CDEK-Joomla-PHP-library)

WebhooksEntity в библиотеке WT CDEK для Joomla: подписки на вебхуки и URL обработчика. На странице — назначение, параметры и примеры PHP для расширений Joomla.

`Webtolk\Cdekapi\Entities\WebhooksEntity` используется для управления подписками на вебхуки СДЭК. Через нее можно посмотреть активные подписки, создать новую, удалить существующую и даже получить Joomla URL для входящих вебхуков, если используется системный плагин `wtcdek`.

Получение Entity:

```
$webhooks = $cdek->webhooks();
```

## `getAllowedTypes(): array`

**Сигнатура**

```
public function getAllowedTypes(): array
```

**REST API**

Не вызывает REST API.

**Что делает**

Возвращает список допустимых типов подписок, которые знает сама библиотека:

- `ORDER_STATUS`
- `ORDER_MODIFIED`
- `PRINT_FORM`
- `RECEIPT`
- `PREALERT_CLOSED`
- `ACCOMPANYING_WAYBILL`
- `OFFICE_AVAILABILITY`
- `DELIV_PROBLEM`
- `DELIV_AGREEMENT`
- `COURIER_INFO`

**Что возвращает**

Массив строк с допустимыми типами вебхуков.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();
$types = $cdek->webhooks()->getAllowedTypes();
```

## `getAll(): array`

**Сигнатура**

```
public function getAll(): array
```

**REST API**

`GET /v2/webhooks`

**Что делает**

Возвращает все активные подписки на вебхуки.

**Параметры**

Метод не принимает параметров.

**Что возвращает**

Массив подписок.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();
$webhooks = $cdek->webhooks()->getAll();
```

## `create(string $url, string $type): array`

**Сигнатура**

```
public function create(string $url, string $type): array
```

**REST API**

`POST /v2/webhooks`

**Что делает**

Создает новую подписку на вебхук.

**Параметры**

- `$url` — корректный URL обработчика;
- `$type` — один из типов из `getAllowedTypes()`.

Библиотека отдельно проверяет валидность URL и допустимость типа.

**Что возвращает**

Асинхронный ответ API со статусом создания подписки.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->webhooks()->create(
    'https://example.com/index.php?option=com_ajax&plugin=wtcdek&group=system&format=raw&action=webhook',
    'ORDER_STATUS'
);
```

## `deleteByUuid(string $uuid): array`

**Сигнатура**

```
public function deleteByUuid(string $uuid): array
```

**REST API**

`DELETE /v2/webhooks/{uuid}`

**Что делает**

Удаляет подписку на вебхук по UUID.

**Параметры**

- `$uuid` — UUID подписки.

**Что возвращает**

Массив ответа API.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->webhooks()->deleteByUuid('11111111-1111-1111-1111-111111111111');
```

## `getByUuid(string $uuid): array`

**Сигнатура**

```
public function getByUuid(string $uuid): array
```

**REST API**

`GET /v2/webhooks/{uuid}`

**Что делает**

Возвращает данные одной подписки на вебхук.

**Параметры**

- `$uuid` — UUID подписки.

**Что возвращает**

Массив данных по подписке.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->webhooks()->getByUuid('11111111-1111-1111-1111-111111111111');
```

## `getJoomlaWebhookUrl(): string`

**Сигнатура**

```
public function getJoomlaWebhookUrl(): string
```

**REST API**

Не вызывает REST API.

**Что делает**

Собирает Joomla URL для приема входящих вебхуков через `com_ajax` и системный плагин `wtcdek`. Метод работает только если:

- плагин `System - WT Cdek` включен;
- в его параметрах задан `webhook_token`.

**Что возвращает**

Строку URL или пустую строку, если URL нельзя собрать.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();
$url = $cdek->webhooks()->getJoomlaWebhookUrl();
```

[Обзор и начало работы](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-library-joomla-form-fields)

[Исходный код WT CDEK 1.4.0 на GitHub](https://github.com/WebTolk/WT-CDEK-Joomla-PHP-library/blob/v.1.4.0/lib_webtolk_wtcdek/src/Entities/WebhooksEntity.php)

## JSON-LD Schema

```json
{
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17",
    "itemListElement": [
        {
            "@type": "ListItem",
            "position": 1,
            "item": {
                "@id": "https://web-tolk.ru/",
                "name": "Главная"
            }
        },
        {
            "@type": "ListItem",
            "position": 2,
            "item": {
                "@id": "https://web-tolk.ru/dev",
                "name": "Расширения Joomla"
            }
        },
        {
            "@type": "ListItem",
            "position": 3,
            "item": {
                "@id": "/dev/biblioteki",
                "name": "Библиотеки"
            }
        },
        {
            "@type": "ListItem",
            "position": 4,
            "item": {
                "@id": "/dev/biblioteki/wt-cdek-library-for-joomla-developers",
                "name": "WT CDEK library"
            }
        },
        {
            "@type": "ListItem",
            "position": 5,
            "item": {
                "@id": "/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation",
                "name": "Документация"
            }
        },
        {
            "@type": "ListItem",
            "position": 6,
            "item": {
                "name": "WebhooksEntity: вебхуки СДЭК для Joomla и PHP"
            }
        }
    ]
}
```

```json
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Organization",
            "@id": "https://web-tolk.ru/#/schema/Organization/base",
            "name": "WebTolk",
            "url": "https://web-tolk.ru/",
            "logo": {
                "@type": "ImageObject",
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo",
                "url": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "contentUrl": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "width": 1920,
                "height": 1080
            },
            "image": {
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo"
            },
            "sameAs": [
                "https://github.com/WebTolk",
                "https://github.com/sergeytolkachyov",
                "https://vk.com/web_tolk",
                "https://vk.com/webtolkru",
                "https://tenchat.ru/sergeytolkachyov",
                "https://t.me/sergeytolkachyov",
                "https://t.me/webtolkru"
            ]
        },
        {
            "@type": "WebSite",
            "@id": "https://web-tolk.ru/#/schema/WebSite/base",
            "url": "https://web-tolk.ru/",
            "name": "WebTolk",
            "publisher": {
                "@id": "https://web-tolk.ru/#/schema/Organization/base"
            }
        },
        {
            "@type": "WebPage",
            "@id": "https://web-tolk.ru/#/schema/WebPage/base",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-webhooks",
            "name": "WebhooksEntity: вебхуки СДЭК для Joomla и PHP | WT CDEK - WebTolk",
            "description": "WebhooksEntity для Joomla: подписки на вебхуки и URL обработчика. Документация WT CDEK, параметры API СДЭК и PHP-примеры для разработчиков.",
            "isPartOf": {
                "@id": "https://web-tolk.ru/#/schema/WebSite/base"
            },
            "about": {
                "@id": "https://web-tolk.ru/#/schema/TechArticle/base"
            },
            "inLanguage": "ru-RU",
            "breadcrumb": {
                "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17"
            }
        },
        {
            "@type": "TechArticle",
            "headline": "WebhooksEntity: вебхуки СДЭК для Joomla и PHP",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-webhooks",
            "description": "WebhooksEntity в библиотеке WT CDEK для Joomla: подписки на вебхуки и URL обработчика. На странице — назначение, параметры и примеры PHP для расширений Joomla.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-webhooks"
            },
            "keywords": [
                "Joomla",
                " PHP",
                " СДЭК API",
                " WT CDEK",
                " WebhooksEntity",
                " подписки на вебхуки и URL обработчика"
            ]
        }
    ]
}
```