--- title: "WT AmoCRM library (Joomla) — Entities API - WebTolk" description: "Справочник по сущностям WT AmoCRM (Webtolk\\Amocrm\\Entities): кратко о методах для сделок, контактов, заметок, тегов, пользователей, webhook’ов и кастомных полей с примерами запросов." url: "https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/wt-amocrm-library-joomla-entities-api" date: "2026-06-04T18:02:16+00:00" language: "ru-RU" --- # WT AmoCRM library (Joomla) — Entities API WT Amo CRM library - Документация **Категория:** [Библиотеки](https://web-tolk.ru/dev/biblioteki) [Проект](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library)[Версии](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/versions)[Документация](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation)[GitHub](https://github.com/WebTolk/WT-Amo-CRM-library-for-Joomla-4) Справочник по сущностям WT AmoCRM (Webtolk\Amocrm\Entities): кратко о методах для сделок, контактов, заметок, тегов, пользователей, webhook’ов и кастомных полей с примерами запросов. Документация по сущностям AmoCRM из `Webtolk\Amocrm\Entities`. Общий паттерн использования: ``` use Webtolk\Amocrm\Amocrm; $amocrm = new Amocrm(); // Все сущности доступны как методы фасада $leads = $amocrm->leads()->getLeads(['limit' => 50]); $contacts = $amocrm->contacts()->getContacts(['limit' => 50]); ``` Все методы возвращают `object`. При ошибке — `{ error_code, error_message }`. ## Account `Webtolk\Amocrm\Entities\Account` - `getAccountInfo(): object` — получает информацию об аккаунте (`/api/v4/account`). Пример: ``` $account = $amocrm->account()->getAccountInfo(); ``` ## Contacts `Webtolk\Amocrm\Entities\Contacts` - `getContacts(array $data = []): object` — список контактов. - `getContactById(int $contact_id, string $with = ''): object` — контакт по ID. - `addContacts(array $data = []): object` — пакетное создание. - `editContactsBatch(array $data): object` — пакетное редактирование. - `editContact(int $contact_id, array $data): object` — редактирование по ID. Пример (создание): ``` $payload = [ [ 'name' => 'Иван Петров', 'custom_fields_values' => [ [ 'field_code' => 'PHONE', 'values' => [ ['enum_code' => 'WORK', 'value' => '+79990001122'] ] ] ] ] ]; $result = $amocrm->contacts()->addContacts($payload); ``` ## Leads `Webtolk\Amocrm\Entities\Leads` - `getLeadsPiplines(): object` — воронки (`/api/v4/leads/pipelines`). - `createLeadsComplex(array $data = []): object` — комплексное добавление. - `createLeads(array $data): object` — пакетное добавление сделок. - `getLeadById(int $id, string $with = ''): object` — сделка по ID. - `getLeads(array $data = []): object` — список сделок. - `editLeadsBatch(array $data): object` — пакетное редактирование. - `editLead(int $lead_id, array $data): object` — редактирование по ID. Пример (воронки): ``` $pipelines = $amocrm->leads()->getLeadsPiplines(); ``` ## Customfields `Webtolk\Amocrm\Entities\Customfields` - `getCustomFields(string $entity_type = 'leads', array $data = []): object` - Разрешённые типы: `leads`, `contacts`, `companies`, `customers`. - `getLeadsCustomFields()`, `getContactsCustomFields()`, `getCompaniesCustomFields()`, `getCustomersCustomFields()` - прокси-методы. - `editCustomFieldsBatch(string $entity_type, array $data, ?int $entity_id = null): object`- PATCH `/api/v4/{entity_type}/custom_fields` или `/custom_fields/{id}`. Пример: ``` $fields = $amocrm->customfields()->getContactsCustomFields(['limit' => 50]); ``` ## Notes `Webtolk\Amocrm\Entities\Notes` - `addNotes(string $entity_type = 'leads', int $entity_id = 0, array $notes = []): object` - `getNotes(string $entity_type, int $entity_id, array $params = []): object` - `editNotesBatch(string $entity_type, array $data): object` - `editNote(string $entity_type, int $entity_id, array $data, ?int $note_id = null): object` Разрешённые типы: `leads`, `contacts`, `companies`, `customers`. Пример (добавить текстовую заметку): ``` $notes = [ [ 'entity_id' => 123456, 'note_type' => 'common', 'params' => ['text' => 'Комментарий из Joomla'] ] ]; $result = $amocrm->notes()->addNotes('leads', 0, $notes); ``` ## Tags `Webtolk\Amocrm\Entities\Tags` - `getTags(string $entity_type = 'leads', array $data = []): object` Разрешённые типы: `leads`, `contacts`, `companies`, `customers`. Пример: ``` $tags = $amocrm->tags()->getTags('leads', ['limit' => 100]); ``` ## Users `Webtolk\Amocrm\Entities\Users` - `getUsers(array $data = []): object` — список пользователей. - `getUserById(int $user_id, string $with = ''): object` — пользователь по ID. - `addUsers(array $data): object` — пакетное добавление. - `getRoles(array $data = []): object` — список ролей. Пример: ``` $users = $amocrm->users()->getUsers(['limit' => 50]); ``` ## Webhooks `Webtolk\Amocrm\Entities\Webhooks` - `getWebhooks(array $data = []): object` - Поддерживает фильтр `filter[destination]` (URL кодируется). - `addWebhook(array $data): object` - `deleteWebhook(string $destination): object` - `getJoomlaWebhookUrl(): string` - Формирует URL `com_ajax` для входящих webhook. Пример (подписка на события): ``` $data = [ 'destination' => $amocrm->webhooks()->getJoomlaWebhookUrl(), 'settings' => ['lead_status', 'contact_add'] ]; $result = $amocrm->webhooks()->addWebhook($data); ``` ## 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-amo-crm-library", "name": "WT Amo CRM library" } }, { "@type": "ListItem", "position": 5, "item": { "@id": "/dev/biblioteki/wt-amo-crm-library/documentation", "name": "Документация" } }, { "@type": "ListItem", "position": 6, "item": { "name": "WT AmoCRM library (Joomla) — Entities API" } } ] } ``` ```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": "images/webtolk-1080p.jpg", "contentUrl": "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-amo-crm-library/documentation/wt-amocrm-library-joomla-entities-api", "name": "WT AmoCRM library (Joomla) — Entities API - WebTolk", "description": "Справочник по сущностям WT AmoCRM (Webtolk\\Amocrm\\Entities): кратко о методах для сделок, контактов, заметок, тегов, пользователей, webhook’ов и кастомных полей с примерами запросов.", "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": "WT AmoCRM library (Joomla) — Entities API", "url": "https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/wt-amocrm-library-joomla-entities-api", "description": "Справочник по сущностям WT AmoCRM (Webtolk\\Amocrm\\Entities): кратко о методах для сделок, контактов, заметок, тегов, пользователей, webhook’ов и кастомных полей с примерами запросов.", "mainEntityOfPage": { "@type": "WebPage", "url": "https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/wt-amocrm-library-joomla-entities-api" }, "keywords": [ "Joomla", " amocrm", " api", " rest api", " amocrm Entities", " Entities amocrm joomla " ] } ] } ```