Немного о интеграции с CRM AMO

Удобно, когда из одного места можно контролировать обмен с клиентами по множеству каналов связи. Какая-то двусмысленная фраза получилась ))) Поясню) Речь идет, конечно же, про АМО CRM. Годы идут, реклама рекламирует, директора и руководящий состав всё это впитывают, они (АМО) растут, у них появилось довольно неплохое API, а после недавних изменений OAUTH 2.0 (об этом подробнее в другой 🙂 ). Как с ним работать? Да легко)

Для начала создадим функцию для подключения:

Функция Подключение() Экспорт
HTTPСоединение = Новый HTTPСоединение("XXX.amocrm.ru",443,,,,,Новый ЗащищенноеСоединениеOpenSSL());
HTTPЗапрос = Новый HTTPЗапрос("/private/api/auth.php");
HTTPЗапрос.Заголовки.Вставить("Content-type", "application/x-www-form-urlencoded");
HTTPЗапрос.Заголовки.Вставить("USERAGENT", "amoCRM-API-client/1.0");
HTTPЗапрос.Заголовки.Вставить("SSL_VERIFYPEER", 0);
HTTPЗапрос.Заголовки.Вставить("SSL_VERIFYHOST", 0);
HTTPЗапрос.УстановитьТелоИзСтроки("USER_LOGIN=***ЛОГИН АМО***&USER_HASH=***ХЕШ ПАРОЛЬ***", КодировкаТекста.UTF8, ИспользованиеByteOrderMark.Авто);
Попытка
Ответ = HTTPСоединение.ОтправитьДляОбработки(HTTPЗапрос);
Куки = Ответ.Заголовки.Получить("Set-Cookie");
Возврат Куки
исключение
сообщить("Не смог подключиться к Amo!", СтатусСообщения.ОченьВажное);
Возврат Неопределено
КонецПопытки;
КонецФункции

В итоге у нас будет ключик. Он нам и нужен ) Теперь, если мы что то хотим сделать, нам не нужно каждый раз авторизовываться.

Например, мы хотим обновить заказ в АМО:

//ЗаказСсылка - ссылка на заказ, или массив заказов, если нужно несколько за раз отправить
//Подключение - наши ранее созданные куки подключением
//Транзакция - уникальный идентификатор, где то созданный ранее для удобного ведения/чтения логов
Функция ОбновитьЗаказ(ЗаказСсылка, Подключение = Неопределено, Транзакция="")
Если Подключение = Неопределено тогда
Куки = Подключение();
иначе
Куки = Подключение;
КонецЕсли;
Если Куки = Неопределено тогда
Возврат Неопределено //какие то проблемы с подключением
КонецЕсли;
ВремФайл = ПолучитьИмяВременногоФайла("json");
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.ОткрытьФайл(ВремФайл, "UTF-8");
ЗаписьJSON.ЗаписатьНачалоОбъекта();
ЗаписьJSON.ЗаписатьИмяСвойства("update");
ЗаписьJSON.ЗаписатьНачалоМассива();
Если ТипЗнч(ЗаказСсылка) = Тип("ДокументСсылка.ЗаказПокупателя") тогда
ДобавитьВМассив(ЗаписьJSON,ЗаказСсылка, Транзакция);//Заполняем телом заказа
иначеЕсли ТипЗнч(ЗаказСсылка) = Тип("Массив") тогда
для чч=0 по ЗаказСсылка.Количество()-1 цикл
ДобавитьВМассив(ЗаписьJSON,ЗаказСсылка[чч], Транзакция); //Заполняем телами заказов
КонецЦикла;
КонецЕсли;
ЗаписьJSON.ЗаписатьКонецМассива();
ЗаписьJSON.ЗаписатьКонецОбъекта();
ЗаписьJSON.УстановитьСтроку();
ЗаписьJSON.Закрыть();
Текст = Новый ТекстовыйДокумент;
Текст.Прочитать(ВремФайл, "UTF-8");
СтрокаJSON = Текст.ПолучитьТекст();
HTTPСоединение = Новый HTTPСоединение("XXX.amocrm.ru",443,,,,,Новый ЗащищенноеСоединениеOpenSSL());
HTTPЗапрос = Новый HTTPЗапрос("/api/v2/leads"); ///api/v2/leads
HTTPЗапрос.Заголовки.Вставить("RETURNTRANSFER", Истина);
HTTPЗапрос.Заголовки.Вставить("USERAGENT", "amoCRM-API-client/1.0");
HTTPЗапрос.Заголовки.Вставить("URL", "https://XXX.amocrm.ru/api/v2/leads");
HTTPЗапрос.Заголовки.Вставить("CUSTOMREQUEST", "POST");
HTTPЗапрос.Заголовки.Вставить("POSTFIELDS", КодироватьСтроку(СтрокаJSON,СпособКодированияСтроки.КодировкаURL));
HTTPЗапрос.Заголовки.Вставить("HEADER", Ложь);
HTTPЗапрос.Заголовки.Вставить("Cookie", Куки);
HTTPЗапрос.Заголовки.Вставить("SSL_VERIFYPEER", 0);
HTTPЗапрос.Заголовки.Вставить("SSL_VERIFYHOST", 0);
HTTPЗапрос.УстановитьТелоИзСтроки(СтрокаJSON, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.Авто);
Ответ = HTTPСоединение.ОтправитьДляОбработки(HTTPЗапрос);
Если Ответ.КодСостояния = 200 тогда
ЧтениеJSON = Новый ЧтениеJSON;
ЧтениеJSON.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку("UTF-8"));
ОтветВСтруктуре1С = ПрочитатьJSON(ЧтениеJSON);
Если ОтветВСтруктуре1С<>Неопределено тогда
Возврат ОтветВСтруктуре1С._embedded.items[0].id;
иначе
Возврат Ложь // подключились, но что то пошло не так
КонецЕсли;
иначе
Возврат Ложь // подключились, но что то пошло не так
КонецЕсли;
КонецФункции

Вот и пригодились куки) А если в первый раз вызывается функция обновления заказа, ну ничего, вызовется функция подключения.

Код сокращен до минимума из первоначального моего варианта, чисто показать пример, кое что, кое где в этом варианте уже не очень логично.

Всем удачи! )