События (до версии 3.0.0)

Обновлено 16.04.2024

Модуль поддерживает события на основе ядра d7 Битрикс.

Общие

• onBeforeWebhook — перед срабатыванием вебхука. Позволяет добавить свою логику на изменения со стороны амо, а также отменить синхронизацию статусов и флагов амо -> магазин;
• onBeforePushData — непосредственно перед началом передачи информации в amoCrm, позволяет модифицировать поля создаваемых сущностей, а также отменить или, наоборот, включить их отправку;
• onAfterPushData — после завершения передачи информации в amoCRM.

Обычное добавление контактов, компаний, сделок и задач

• onBeforePushStandardData — перед началом отправления данных, позволяет включить/отключить создание контактов, компаний, сделок и задач, а также отменить отправку;
• onAfterPushStandardData — после отправления данных.

Неразобранное

• onBeforePushUnsortedData — перед началом отправления «неразобранного», позволяет включить/отключить создание контакта и компании, а также отменить отправку;
• onPushUnsortedData — перед непосредственным отправлением «неразобранного», позволяет внести изменения в создаваемые сущности («неразобранное», контакт, сделка, компания), а также отменить отправку;
• onAfterPushUnsortedData — после отправления «неразобранного»;

Товары

• beforeSearchOneByBasketItem — перед поиском товара в amoCRM на основе товара в корзине;
• afterSearchOneByBasketItem — после поиска товара в amoCRM на основе товара в корзине;
• beforeMakeCatalogElementByBasketItem — перед созданием товара для amoCRM на основе товара в корзине;
• afterMakeCatalogElementByBasketItem — после создания товара для amoCRM на основе товара в корзине.

События rest-запросов

Ядро Rover\AmoCRM\Model\Rest

• beforeRestRequest — перед выполнением любого rest-запроса
• afterRestRequest — после выполнения любого rest-запроса
• beforeRestAuth — перед запросом авторизации
• afterRestAuth — после запроса авторизации

Контакт/Компания Rover\AmoCRM\Model\Rest\Contact

• beforeContactAdd — перед запросом добавления контакта/компании
• afterContactAdd — после запроса добавления контакта/компании
• beforeContactUpdate — перед запросом обновления контакта/компании
• afterContactUpdate — после запроса обновления контакта/компании
• beforeContactGetList — перед запросом получения списка контактов/компаний
• afterContactGetList — после запроса получения списка контактов/компаний

Сделка Rover\AmoCRM\Model\Rest\Lead

• beforeLeadAdd — перед запросом добавления сделки
• afterLeadAdd — после запроса добавления сделки
• beforeLeadUpdate — перед запросом обновления сделки
• afterLeadUpdate — после запроса обновления сделки
• beforeLeadGetList — перед запросом получения списка сделок
• afterLeadGetList — после запроса получения списка сделок

Задача Rover\AmoCRM\Model\Rest\Task

• beforeTaskAdd — перед запросом добавления задачи
• afterTaskAdd — после запроса добавления задачи

«Неразобранное» Rover\AmoCRM\Model\Rest\Unsorted

• beforeUnsortedAdd — перед запросом добавления «неразобранного»
• afterUnsortedAdd — после запроса добавления «неразобранного»
• beforeUnsortedGetList — перед запросом получения списка «неразобранного»
• afterUnsortedGetList — после запроса получения списка «неразобранного»

Примечание Rover\AmoCRM\Model\Rest\Note

• beforeNoteAdd — перед запросом добавления примечания
• afterNoteAdd — после запроса добавления примечания
• beforeNoteGetList — перед запросом получения списка примечаний
• afterNoteGetList — после запроса получения списка примечаний

Порядок следования параметров в событиях rest-запросов

Для событий, начинающегося с before[тип сущности]GetList (например beforeNoteGetList):

1. url запроса
2. тело запроса (массив)
3. запрашиваемые поля (массив)

Для остальных, начинающихся с before

1. url запроса
2. тело запроса (массив)

С after[тип сущности]GetList (например afterNoteGetList)::

1. url запроса
2. тело запроса (массив)
3. запрашиваемые поля (массив)
4. тело ответа (массив)
5. код ответа
6. сообщение об ошибке (если есть)

Для остальных, начинающихся с after

1. url запроса
2. тело запроса (массив)
3. тело ответа (массив)
4. код ответа
5. сообщение об ошибке (если есть)

Если в обработчике события, начинающегося на before (кроме beforeRestRequest) вернуть результат с типом \Bitrix\Main\EventResult::ERROR, то соответствующий запрос выполнен не будет.

Пример

Назначение обработчика на событие:

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler('rover.amocrm', 'afterContactGetList', ['\Rover\AmoCRM\Event', 'onAfterContactGetList']);

Сам обработчик:

namespace Rover\AmoCRM;

use Rover\AmoCRM\Helper\Log;
use \Bitrix\Main;

class Event
{
    public static function onAfterContactGetList(Main\Event $event)
    {
        $result = $event->getParameter(3);

        Log::addNote('Contact::getList results count:',  isset($result['_embedded']['items']) ? count($result['_embedded']['items']) : 0);
    }
}