Общие сведения
Events - система событий, позволяющая выполнить сторонний код или отправить запрос во внешний скрипт (посредством GET или POST запросов) в зависимости от происходящих в системе событий (например, Добавление нового клиента). Доступна только для коробочного варианта поставки.
Подключить свои обработчики на те или иные события можно с помощью файла "developer/events.php", поставлемого с открытым исходным кодом в коробочном варианте. Файл содержит перечень поддерживаемых событий, а также некоторые примеры использования.
Файл "events.php" содержит подробные комментарии, но ниже мы подробнее рассмотрим каждое событие и получаемые при этом параметры.
Внимание
система Events дополнена системой Webhook, которая позволяет подключаться к событиям без необходимости включений в код
Зарегистрированные события
Для клиентов
client.import
Получаемые аргументы:
- array clids - массив clid новых записей клиентов
- array pids - массив pid новых записей клонтактов
- integer autor - id сотрудника, выполнившего действие
- integer user - id ответственного сотрудника
client.expressadd
Событие, срабатывающее при добавлении Клиента/Контакта через Экспресс-форму, через обработчик лидов
Получаемые аргументы:
- integer pid - pid новой записи клонтакта
- integer clid - clid новой записи клиента
- nteger autor - id сотрудника, выполнившего действие
- integer user - id ответственного сотрудника
client.add
Событие, срабатывающее при добавлении Клиента через обычную-форму, через обращения
Получаемые аргументы:
- integer clid - clid новой записи клиента
- integer autor - id сотрудника, выполнившего действие
- integer user - id ответственного сотрудника
client.edit
Событие, срабатывающее при изменении Клиента
Получаемые аргументы:
- integer clid - clid новой записи клиента
- integer autor - id сотрудника, выполнившего действие
- integer user - id ответственного сотрудника
- array newparam - массив измененных параметров
client.delete
Событие, срабатывающее при удалении Клиента
Получаемые аргументы:
- integer clid - clid новой записи клиента
- integer autor - id сотрудника, выполнившего действие
- integer user - id ответственного сотрудника
client.change.recv
Событие, срабатывающее при изменении реквизитов Клиента
Получаемые аргументы:
- integer clid - clid новой записи клиента
- integer autor - id сотрудника, выполнившего действие
- integer user - id ответственного сотрудника
client.change.user
Событие, срабатывающее при изменении Ответственного за Клиента
Получаемые аргументы:
- integer clid - clid новой записи клиента
- integer autor - id сотрудника, выполнившего действие
- integer user - id ответственного сотрудника
Для контактов
person.add
Событие, срабатывающее при добавлении Контакта через обычную-форму, через обращения
Получаемые аргументы:
- string pid - pid новой записи клонтакта
- string autor - id сотрудника, выполнившего действие
- string user - id ответственного сотрудника
person.edit
Событие, срабатывающее при изменении Контакта
Получаемые аргументы:
- integer pid - pid записи контакта
- integer autor - id сотрудника, выполнившего действие
- integer user - id ответственного сотрудника
person.delete
Событие, срабатывающее при удалении Контакта
Получаемые аргументы:
- integer pid - pid записи контакта
- integer autor - id сотрудника, выполнившего действие
- integer user - id ответственного сотрудника
person.change.user
Событие, срабатывающее при изменении Ответственного за Контакт
Получаемые аргументы:
- integer pid - pid записи контакта
- integer autor - id сотрудника, выполнившего действие
- integer user - id ответственного сотрудника
Для сделок
deal.add
Событие, срабатывающее при добавлении новой сделки
Получаемые аргументы:
- integer did - did записи сделки
- integer autor - id сотрудника, выполнившего действие
- string userUID - UID ответственного сотрудника во внешней системе
deal.edit
Событие, срабатывающее при изменении основной информации сделки
Получаемые аргументы:
- integer did - did записи сделки
- integer autor - id сотрудника, выполнившего действие
- array newparam - массив измененных параметров
deal.delete
Событие, срабатывающее при удалении сделки
Получаемые аргументы:
- integer did - did записи сделки
- integer autor - id сотрудника, выполнившего действие
deal.change.user
Событие, срабатывающее при изменении ответственного за сделку
Получаемые аргументы:
- integer did - did записи сделки
- integer autor - id сотрудника, выполнившего действие
- integer olduser - id предыдущего сотрудника, ответственного за сделку
- integer newuser - id нового сотрудника, ответственного за сделку
- string comment - комментарий внесения изменений
deal.change.step
Событие, срабатывающее при изменении ответственного за сделку
Получаемые аргументы:
- integer did - did записи сделки
- integer autor - id сотрудника, выполнившего действие
- integer stepOld - название предыдущего этапа (например 10)
- integer stepNew - название нового этапа (например 20)
deal.close
Событие, срабатывающее при закрытии сделки
Получаемые аргументы:
- integer did - did записи сделки
- integer autor - id сотрудника, выполнившего действие
- string summa - сумма закрытия сделки (фактическая, например - 10340.00)
- string status - статус закрытия (например Победа)
invoice.add
Событие, срабатывающее при добавлении нового счета
Получаемые аргументы:
- integer did - did записи сделки
- integer autor - id сотрудника, выполнившего действие
- string user - id ответственного сотрудника
- string userUID - UID ответственного сотрудника во внешней системе
- string summa - сумма счета (например - 10340.00) * string invoice - номер счета
invoice.edit
Событие, срабатывающее при внесении изменений в счет
Получаемые аргументы:
- integer did - did записи сделки
- integer autor - id сотрудника, выполнившего действие
- string user - id ответственного сотрудника
- string userUID - UID ответственного сотрудника во внешней системе
- string summa - сумма счета (например - 10340.00) * string invoice - номер счета
invoice.doit
Событие, срабатывающее при отметке счета оплаченным
Получаемые аргументы:
- integer did - did записи сделки
- integer autor - id сотрудника, выполнившего действие
- string userUID - UID ответственного сотрудника во внешней системе
- string invoice - номер счета
- string summa - сумма платежа (например - 10340.00), может быть частичной
- string summaNew - сумма созданного платежа (например - 10340.00), вычисляется как разница сумм по счету и суммы платежа
invoice.expressadd
Событие, срабатывающее при внесении платежа без выставления счета
Получаемые аргументы:
- integer did - did записи сделки
- integer autor - id сотрудника, выполнившего действие
- string userUID - UID ответственного сотрудника во внешней системе
- string invoice - номер счета
- string summa - сумма платежа (например - 10340.00), может быть частичной
- string summaNew - сумма созданного платежа (например - 10340.00), вычисляется как разница сумм по счету и суммы платежа
Для напоминаний
task.add
Событие, срабатывающее при добавлении напоминания
- integer id - id записи напоминания
- integer autor - id сотрудника, выполнившего действие
task.edit
Событие, срабатывающее при изменении напоминания
- integer id - id записи напоминания
- integer autor - id сотрудника, выполнившего действие
task.doit
Событие, срабатывающее при выполнении напоминания
- integer id - id записи напоминания
- integer autor - id сотрудника, выполнившего действие
Для истории активностей
history.add
Событие, срабатывающее при добавлении записи в Историю
- integer id - id записи напоминания
- integer autor - id сотрудника, выполнившего действие
history.edit
Событие, срабатывающее при изменении записи в Историю
- integer id - id записи
- integer autor - id сотрудника, выполнившего действие
history.doit
Событие, срабатывающее при выполнении напоминания
- integer id - id записи напоминания
- integer autor - id сотрудника, выполнившего действие
Для заявок
lead.do
Событие, срабатывающее при обработке заявки
Внимание
при обработке заявки другие события не вызываются
- integer id - id записи
- integer autor - id сотрудника, выполнившего действие
- integer clid - id записи клиента, если добавлен новый клиент
- integer pid - id записи контакта, если добавлен новый контакт
- integer did - id записи сделки, если добавлена
Для обращений
entry.add
Событие, срабатывающее при добавлении обращения
- integer id - id записи обращения
- integer clid - id записи клиента
- integer pid - id записи контакта
- integer did - id записи сделки, если добавлена
- integer autor - id сотрудника, выполнившего действие
entry.status
Событие, срабатывающее при отмене обращения
- integer id - id обращения
- integer autor - id сотрудника, выполнившего действие
- integer status = 2 ['0' => 'Новое', '1' => 'Обработано', '2' => 'Отменено'];
Доступно с версии 2019.3
Для Документов
contract.add
Событие, срабатывающее при добавлении Документа
- integer id - id записи Документа
- string number - номер Документа
- string datum - дата Документа
- integer payer - id записи Плательщика
- integer clid - id записи Заказчика
- integer pid - id записи контакта
- integer did - id записи сделки, если добавлена
- integer autor - id сотрудника, выполнившего действие
contract.edit
Событие, срабатывающее при изменении Документа
- integer id - id записи Документа
- string number - номер Документа
- string datum - дата Документа
- integer payer - id записи Плательщика
- integer clid - id записи Заказчика
- integer pid - id записи контакта
- integer did - id записи сделки, если добавлена
- integer autor - id сотрудника, выполнившего действие
contract.delete
Событие, срабатывающее при удалении Документа
- integer id - id записи Документа
- integer did - id записи сделки, если добавлена
- integer autor - id сотрудника, выполнившего действие
Для Актов
akt.add
Событие, срабатывающее при добавлении Документа
- integer id - id записи Документа
- string number - номер Документа
- string datum - дата Документа
- integer payer - id записи Плательщика
- integer clid - id записи Заказчика
- integer pid - id записи контакта
- integer did - id записи сделки, если добавлена
- integer autor - id сотрудника, выполнившего действие
akt.edit
Событие, срабатывающее при изменении Документа
- integer id - id записи Документа
- string number - номер Документа
- string datum - дата Документа
- integer payer - id записи Плательщика
- integer clid - id записи Заказчика
- integer pid - id записи контакта
- integer did - id записи сделки, если добавлена
- integer autor - id сотрудника, выполнившего действие
akt.delete
Событие, срабатывающее при удалении Документа
- integer id - id записи Документа
- integer did - id записи сделки, если добавлена
- integer autor - id сотрудника, выполнившего действие