sergeytolkachyov/wt-amo-crm-library-for-joomla-4

A small PHP library for Joomla 4 and Amo CRM. For developers.

WT Amo CRM library for Joomla 4

More info on developer site

A small PHP library for Joomla 4 and Amo CRM. For developers. As part of the package

• amoCRM connection library
• settings plugin for connecting to Amo CRM System - WT Amo CRM Library

Connecting the library to your Joomla extension

use Webtolk\Amocrm\Amocrm;
$amocrm = new Amocrm();
$result_amo_crm = $amocrm->getAccountInfo();

Amo CRM Fields for Joomla Form

The library contains a set of Joomla Form fields with information obtained from Amo CRM.

Accountinfo

Outputs html with data about the Amo CRM account. Example of using Joomla 4 modules and plugins in XML manifests.

<field addfieldprefix="Webtolk\Amocrm\Fields" type="accountinfo" name="accountinfo"/>

Companiestagslist -Companies tags list

A list of tags for companies in Amo CRM. An example of using Joomla 4 modules and plugins in XML manifests.

<field addfieldprefix="Webtolk\Amocrm\Fields" type="companiestagslist" name="company_tag_id"/>

Contactstagslist -Contacts tags list

A list of tags for contacts in Amo CRM. An example of using Joomla 4 modules and plugins in XML manifests.

<field addfieldprefix="Webtolk\Amocrm\Fields" type="contactstagslist" name="contact_tag_id"/>

Leadcustomfieldslist -Lead custom fields list

A list of custom Amo CRM fields for transactions.

<field addfieldprefix="Webtolk\Amocrm\Fields" type="leadcustomfieldslist" name="lead_custom_field_id"/>

Leadspipelineslist -Leads pipelines list

List of Amo CRM sales funnels.

<field addfieldprefix="Webtolk\Amocrm\Fields" type="leadspipelineslist" name="pipeline_id"/>

Leadstagslist -Leads tags list

List of tags for deals. Params:

• limit - tags count in list. Max 250

<field addfieldprefix="Webtolk\Amocrm\Fields" type="leadstagslist" limit="100" name="lead_tag_id"/>

How to install

• Installing the library in Joomla 4
• How to connect the AmoCRM library to your Joomla extension

List of library methods

• getAccountInfo
• getLeadById
• createLeads
• createLeadsComplex
• getTags
• getLeadsPiplines
• getLeadsCustomFields
• getContactsCustomFields
• getCompaniesCustomFields
• getCustomersCustomFields
• getContacts
• getUserById

Docs in progress. Methods are described in library code (PHP Doc block)

wt-amo-crm-library-for-joomla-4's Issues

сопоставления полей Amo CRM и JoomShopping

Здравствуйте,

Создал в Amocrm текстовые поля: Статус заказа, Способ оплаты, Способ доставки.
Сопоставил эти поля с Joomshoping. Основные данные о заказе приходят корректно, а из сопоставленных полей вместо текстовой информации приходят цифровые значения.

Joomla 4.3.4, JoomShopping 5.2.0

Метод getLeadById добавить обработку http кода 204

в ответе может быть HTTP код 204 "Сделка с указанным ID не существует". Добавить корректную обработку
https://www.amocrm.ru/developers/content/crm_platform/leads-api#lead-detail

PHP8 Deprecated: Required parameter $request_method follows optional parameter

Deprecated: Required parameter $request_method follows optional parameter $data in /libraries/Webtolk/Amocrm/src/Amocrm.php on line 48

Добавить кнопку сброса старого refresh token из базы

Если интеграцией не пользовались 3 месяца или же указываются данные другой интеграции - в параметрах библиотеки в базе остаётся старый refresh token, который библиотека пытается использовать для новой интеграции. возникает ошибка API 401 Token is not linked to client.
Варианта 2:

1. При сохранении плагина на событие сохранения расширения проверять токен и обновлять его исходя из данных формы (переавторизовываться заново и добавлять токен в базу)
2. сделать поле-кнопку на ajax для очистки старого refresh token