Полезные кастомизации itgrix_amo (amoCRM)
Начиная с версии 2.0.0.
(Схема для версий начиная с 2.9.0)
"Запрос разговора" – когда звонит телефон у сотрудника/клиента.
В одном "звонке" может быть несколько "разговоров" (в случае перевода звонка).
№ | Файл кастомизации
(по алфавиту) | Описание |
1 | Нужна ли регистрация звонка?
Можно сделать черные/белые списки по внутреннему номеру/транку. | |
2 | Изменение параметров регистрации звонка. | |
3 | Изменение номера телефона перед регистрацией в CRM.
Можно сменить формат телефонного номера (+7, 8...). | |
4 | Изменение параметров создания контакта. | |
5 | Изменение параметров создания сделки. | |
6 | Изменение параметров при инициализации звонка из CRM.
Можно позвонить через другой транк, через другой контекст, сменить формат номера и прочее. | |
7 | Кастомизация пути до файла записи разговора. Также в этом файле настраивается конвертирование из формата wav в mp3. Описание в статье Конвертация записей в формат MP3. | |
8 | Изменение параметров создания задач по пропущенным звонкам. Изменение названия задачи может помешать опции автоматического завершения задач. |
Используется для реализации функционала чёрных/белых список по номерам, транкам и прочим сложным условиям.
Изменение параметров регистрации звонка.
Вход:
{
"params": {
"phone_number": “<Телефонный номер клиента
(уже кастомизированный через process_client_phone)>”,
"direction": “<Направление звонка. Принимает значения:
"inbound" - входящий, "outbound" - исходящий>”,
"call_result": " ",
"call_status": “<Статус звонка. Принимает значения:
4 - отвеченный; 6 - пропущенный>”,
"created_by": “<ID ответственного пользователя>”,
"responsible_user_id": “<ID ответственного пользователя>”,
"duration": “<Длительность (последнего разговора)>”,
"link": “<Ссылка на получение записи (последнего разговора)>”,
"call": {<Набор данных о звонке>},
"entity_type": <Тип сущности: 1-контакт, 2-компания, 3-сделка>,
"entity_id": “<ID сущности строкой>”,
"entity_new": <bool, создана ли сущность на этом звонке>
}
}
Набор данных о звонке (call) описан в статье Параметры звонка (call) и разговора (conversation) в кастомизациях.
Вернуть:
{
"data": {
"phone_number": “<Телефонный номер клиента>”,
"direction": “<Направление звонка. Принимает значения:
"inbound" - входящий, "outbound" - исходящий>”,
"call_result": " ",
"call_status": “<Статус звонка. Принимает значения:
4 - отвеченный; 6 - пропущенный>”,
"created_by": “<ID ответственного пользователя>”,
"responsible_user_id": “<ID ответственного пользователя>”,
"duration": “<Длительность>”,
"link": “<Ссылка на получение записи>”
},
"state": "success"
}
Преобразование телефонных номеров клиентов.
Изменение параметров создания контакта.
В amoCRM по умолчанию в контакте нет поля для телефонного номера. Вместо этого используются пользовательские поля контактов.
Itgrix_amo работает с полем контактов
"code": "PHONE" с доступным значением "enum": "WORK". Если такого поля для контактов в аккаунте нет, то модуль не запустится.Вход:
{
"params": {
"call": {<Набор данных о звонке.
См. раздел “Параметры звонка (call)”>},
"custom_fields": [{
"id": “<ID пользовательского поля контактов в аккаунте
(получено автоматически)>”,
"values": [{
"enum": “<Значение поля.
Itgrix работает со значением "WORK">”,
"value": “<Номер телефона звонившего>”
}]
}],
"name": “<Имя контакта. По умолчанию "Контакт <Тел.номер>">”,
"responsible_user_id": “<ID ответственного пользователя>”,
"tags": “<Теги. По умолчанию "Itgrix">”
}
}
Вернуть:
{
"data": {
"custom_fields": [{
"id": “<ID пользовательского поля контактов в аккаунте>”,
"values": [{
"enum": “<Значение поля>”,
"value": “<Номер телефона звонившего>”
}]
}],
"name": “<Имя контакта>”,
"responsible_user_id": “<ID ответственного пользователя>”,
"tags": “<Теги через запятую>”,
},
"state": "success"
}
Набор данных о звонке (call) описан в статье Параметры звонка (call) и разговора (conversation) в кастомизациях.
Изменение параметров создания сделки.
Вход:
{
"params": {
"call": {<Набор данных о звонке.
См. раздел “Параметры звонка (call)”>},
"contacts_id": [“<ID контакта, с которыми связана сделка>”],
"name": “<Название сделки.
По умолчанию "<Тел.номер> - входящий/исходящий звонок">”,
"pipeline_id": “<ID воронки сделок>”,
"responsible_user_id": “<ID ответственного пользователя>”,
"tags": “<Теги. По умолчанию "Itgrix">”
}
}
Вернуть:
{
"data": {
"contacts_id": [“<ID контакта>”],
"name": “<Название сделки>”,
"pipeline_id": “<ID воронки сделок>”,
"responsible_user_id": “<ID ответственного пользователя>”,
"tags": “<Теги через запятую>”
}
"state": "success"
}
Набор данных о звонке (call) описан в статье Параметры звонка (call) и разговора (conversation) в кастомизациях.
Изменение параметров при инициализации звонка из amoCRM.
Преобразование пути до файла записи разговора.
При регистрации звонка в amoCRM в заметку будет добавлен плеер для проигрывания записи этого звонка (по ссылке, которую модуль Itgrix добавляет автоматически). Но плеер поддерживает только формат mp3.
Изменение параметров создания задач по пропущенным звонкам.
Вход:
{
"params": {
"complete_till_at": “<Дата-время, когда задача должна быть завершена
(в формате Unix Timestamp)>”,
"element_id": “<ID сущности, к которой привязана задача>”,
"element_type": “<Тип сущности, к которой привязана задача.
Числовое значение: 1 - Контакт, 2 - Сделка>”,
"is_completed": “<Выполнена ли задача. При создании всегда false>”,
"responsible_user_id": “<ID ответственного пользователя>”,
"task_type": “<Тип задачи. Числовое значение:
1 - Звонок, 2 - Встреча, 3 - Письмо>”,
"text": “<Описание задачи. По умолчанию "Перезвонить <Тел.номер>">”,
}
}
Вернуть:
{
"data": {
"complete_till_at": “<Дата-время, когда задача должна быть завершена
(в формате Unix Timestamp)>”,
"element_id": “<ID сущности, к которой привязана задача>”,
"element_type": “<Тип сущности, к которой привязана задача.
Числовое значение: 1 - Контакт, 2 - Сделка>”,
"is_completed": “<Выполнена ли задача. При создании всегда false>”,
"responsible_user_id": “<ID ответственного пользователя>”,
"task_type": “<Тип задачи. Числовое значение:
1 - Звонок, 2 - Встреча, 3 - Письмо>”,
"text": “<Описание задачи>”,
},
"state": "success"
}