Powered By GitBook
Полезные кастомизации itgrix_amo (amoCRM)
Начиная с версии 2.0.0.
Дополнительные кастомизации описаны в разделе Полезные кастомизации (любая CRM).

Схема обработки звонка модулем интеграции Itgrix

(Схема для версий начиная с 2.4.0)
"Запрос разговора" – когда звонит телефон у сотрудника/клиента. В одном "звонке" может быть несколько "разговоров" (в случае перевода звонка).

Краткое описание кастомизаций

Файл кастомизации (по алфавиту)
Описание
1
Нужна ли регистрация звонка? Можно сделать черные/белые списки по внутреннему номеру/транку.
2
Изменение параметров регистрации звонка.
3
Изменение номера телефона перед регистрацией в CRM. Можно сменить формат телефонного номера (+7, 8...).
4
Изменение параметров создания контакта.
5
Изменение параметров создания сделки.
6
Изменение параметров при инициализации звонка из CRM. Можно позвонить через другой транк, через другой контекст, сменить формат номера и прочее.
7
Кастомизация пути до файла записи разговора.
Также в этом файле настраивается конвертирование из формата wav в mp3. Описание в статье Конвертация записей в формат MP3.
8
Изменение параметров создания задач по пропущенным звонкам. Изменение названия задачи может помешать опции автоматического завершения задач.

Входные и выходные параметры кастомизаций

1) need_registration

Используется для реализации функционала чёрных/белых список по номерам, транкам и прочим сложным условиям.
Подробное описание с примерами в статье Черные и белые списки. Как настроить?

2) process_call_params

Изменение параметров регистрации звонка.
Вход:
1
{
2
"params": {
3
"phone_number":<Телефонный номер клиента
4
(уже кастомизированный через process_client_phone)>,
5
"direction":<Направление звонка. Принимает значения:
6
"inbound" - входящий, "outbound" - исходящий>,
7
"call_result": " ",
8
"call_status":<Статус звонка. Принимает значения:
9
4 - отвеченный; 6 - пропущенный>,
10
"created_by":<ID ответственного пользователя>,
11
"responsible_user_id":<ID ответственного пользователя>,
12
"duration":<Длительность (последнего разговора)>,
13
"link":<Ссылка на получение записи (последнего разговора)>,
14
"call": {<Набор данных о звонке>},
15
"entity_type": <Тип сущности: 1-контакт, 2-компания, 3-сделка>,
16
"entity_id":<ID сущности строкой>,
17
"entity_new": <bool, создана ли сущность на этом звонке>
18
}
19
}
Copied!
Набор данных о звонке (call) описан в статье Параметры звонка (call) и разговора (conversation) в кастомизациях.
Вернуть:
1
{
2
"data": {
3
"phone_number":<Телефонный номер клиента>,
4
"direction":<Направление звонка. Принимает значения:
5
"inbound" - входящий, "outbound" - исходящий>,
6
"call_result": " ",
7
"call_status":<Статус звонка. Принимает значения:
8
4 - отвеченный; 6 - пропущенный>,
9
"created_by":<ID ответственного пользователя>,
10
"responsible_user_id":<ID ответственного пользователя>,
11
"duration":<Длительность>,
12
"link":<Ссылка на получение записи>
13
},
14
"state": "success"
15
}
Copied!

3) process_client_phone

Преобразование телефонных номеров клиентов.
Подробное описание с примерами в статье Изменение номера клиента перед отправкой в CRM.

4) process_contact_creation_params

Изменение параметров создания контакта.
В amoCRM по умолчанию в контакте нет поля для телефонного номера. Вместо этого используются пользовательские поля контактов.
Itgrix_amo работает с полем контактов "code": "PHONE" с доступным значением "enum": "WORK". Если такого поля для контактов в аккаунте нет, то модуль не запустится.
Подробное описание пользовательских полей в документации API amoCRM.
Вход:
1
{
2
"params": {
3
"call": {<Набор данных о звонке.
4
См. раздел “Параметры звонка (call)>},
5
"custom_fields": [{
6
"id":<ID пользовательского поля контактов в аккаунте
7
(получено автоматически)>,
8
"values": [{
9
"enum":<Значение поля.
10
Itgrix работает со значением "WORK">,
11
"value":<Номер телефона звонившего>
12
}]
13
}],
14
"name":<Имя контакта. По умолчанию "Контакт <Тел.номер>">,
15
"responsible_user_id":<ID ответственного пользователя>,
16
"tags":<Теги. По умолчанию "Itgrix">
17
}
18
}
Copied!
Вернуть:
1
{
2
"data": {
3
"custom_fields": [{
4
"id":<ID пользовательского поля контактов в аккаунте>,
5
"values": [{
6
"enum":<Значение поля>,
7
"value":<Номер телефона звонившего>
8
}]
9
}],
10
"name":<Имя контакта>,
11
"responsible_user_id":<ID ответственного пользователя>,
12
"tags":<Теги через запятую>,
13
},
14
"state": "success"
15
}
Copied!
Набор данных о звонке (call) описан в статье Параметры звонка (call) и разговора (conversation) в кастомизациях.

5) process_lead_creation_params

Изменение параметров создания сделки.
Вход:
1
{
2
"params": {
3
"contacts_id": [<ID контакта, с которыми связана сделка>],
4
"name":<Название сделки.
5
По умолчанию "<Тел.номер> - входящий/исходящий звонок">,
6
"pipeline_id":<ID воронки сделок>,
7
"responsible_user_id":<ID ответственного пользователя>,
8
"tags":<Теги. По умолчанию "Itgrix">
9
}
10
}
Copied!
Вернуть:
1
{
2
"data": {
3
"contacts_id": [<ID контакта>],
4
"name":<Название сделки>,
5
"pipeline_id":<ID воронки сделок>,
6
"responsible_user_id":<ID ответственного пользователя>,
7
"tags":<Теги через запятую>
8
}
9
"state": "success"
10
}
Copied!

6) process_originate_params

Изменение параметров при инициализации звонка из amoCRM.
Подробное описание с примерами в статье Изменение параметров при click-to-call.

7) process_record_file_path

Преобразование пути до файла записи разговора.
Подробное описание с примерами в статье Кастомизация имени файла аудиозаписи.
При регистрации звонка в amoCRM в заметку будет добавлен плеер для проигрывания записи этого звонка (по ссылке, которую модуль Itgrix добавляет автоматически). Но плеер поддерживает только формат mp3.
При установке Itgrix_amo по умолчанию уже включена конвертация файлов записей разговоров в mp3.

8) process_task_creation_params

Изменение параметров создания задач по пропущенным звонкам.
Вход:
1
{
2
"params": {
3
"complete_till_at":<Дата-время, когда задача должна быть завершена
4
(в формате Unix Timestamp)>,
5
"element_id":<ID сущности, к которой привязана задача>,
6
"element_type":<Тип сущности, к которой привязана задача.
7
Числовое значение: 1 - Контакт, 2 - Сделка>,
8
"is_completed":<Выполнена ли задача. При создании всегда false>,
9
"responsible_user_id":<ID ответственного пользователя>,
10
"task_type":<Тип задачи. Числовое значение:
11
1 - Звонок, 2 - Встреча, 3 - Письмо>,
12
"text":<Описание задачи. По умолчанию "Перезвонить <Тел.номер>">,
13
}
14
}
Copied!
Вернуть:
1
{
2
"data": {
3
"complete_till_at":<Дата-время, когда задача должна быть завершена
4
(в формате Unix Timestamp)>,
5
"element_id":<ID сущности, к которой привязана задача>,
6
"element_type":<Тип сущности, к которой привязана задача.
7
Числовое значение: 1 - Контакт, 2 - Сделка>,
8
"is_completed":<Выполнена ли задача. При создании всегда false>,
9
"responsible_user_id":<ID ответственного пользователя>,
10
"task_type":<Тип задачи. Числовое значение:
11
1 - Звонок, 2 - Встреча, 3 - Письмо>,
12
"text":<Описание задачи>,
13
},
14
"state": "success"
15
}
Copied!
Last modified 2mo ago