amo-connector 0.1.0
A Python connector for the amoCRM API.
Requires Python: >=3.8

# pyamocrm

## Описание

Библиотека, основанная на amocrm api для упрощенного введения данных в amocrm. 

В текущей версии перенесены только части сделок(leads), как лицензии и контакты. В данный момент подходит в основном для продажи каких либо лицензий и привязки к ним разных контактов, но легко модифицируется за счет добавления к ним различных полей.

## Использование

Библиотека требует времени для подготовки личного кабинета перед использованием. Первоочередно, нужно зарегестрировать api. Для этого:
1. В Личном кабинете слева откройте вкладку amoМаркет
2. В правом верхнем углу нажмите на три точки -> создать интеграцию -> внешняя интеграция
3. Вставьте любую картинку 400x272px, какую либо ссылку, желательно на вашем домене как ссылку для перенаправления, предоставьте полный доступ(можноо исключить удаление, оно все равно не работает), придумайте название и описание. 
4. Откройте вкладку установленные в верхней части вкладки amoМаркет, выберите добавленную интеграцию и откройте "Ключи и доступы".
5. Создайте долгосрочный ключ на интересующий вас срок и сохраните его где либо, далее используйте его при создании коннектора, как параметр token
6. Далее, переключаемся во вкладку списки -> контакты -> Добавить контакт.
7. Задайте контакту Имя, Телефон, Email. Переключитесь во вкладку настроить, добавить поле, и создайте текстовое поле "Комментарий(можно назвать иначе)". Задайте также и комментарий. 
8. Сохраните изменения, скопируйте в адресной строке id созданного контакта, и вызовите get_contact_fields. Первый параметр - id созданного контакта, второй - токен из пункта 5. Вы получите ответ:
```
{'id': 37709111, 'name': 'Тест Имя', 'first_name': '', 'last_name': '', 'responsible_user_id': 12781906, 'group_id': 0, 'created_by': 0, 'updated_by': 0, 'created_at': 1754057333, 'updated_at': 1754057333, 'closest_task_at': None, 'is_deleted': False, 'is_unsorted': False, 'custom_fields_values': [{'field_id': 1733073, 'field_name': 'Телефон', 'field_code': 'PHONE', 'field_type': 'multitext', 'values': [{'value': '+79999998899', 'enum_id': 1414479, 'enum_code': 'WORK'}]}, {'field_id': 1733075, 'field_name': 'Email', 'field_code': 'EMAIL', 'field_type': 'multitext', 'values': [{'value': 'your_mail@gmail.com1234567', 'enum_id': 1414491, 'enum_code': 'WORK'}]}], 'account_id': 32567394, '_links': {'self': {'href': 'https://nimblealexx527.amocrm.ru/api/v4/contacts/37709111?page=1&limit=250'}}, '_embedded': {'tags': [], 'companies': []}}
```
Из него нас интересует часть custom_fields_values:
в структуре есть 3 элемента: телефон, email, комментарий. Перед каждым из полей есть свой field_id. Сохраните его для последующего использования

9. Проделываем похожую процедуру с лицензиями: открываем сделки, при необходимости выбираем необходимую воронку и создаем сделку. Во вкладке настроек добавляем поля Комментарий, Дата начала лицензии, Дата окончания лицензии, и срок действия. вызываем метод get_license_fields, и также ищем custom_fields_values, сохраняем их.

10. При всех этих параметрах создаём коннектор и с его помощью уже вызываем методы, описанные в src/examples.py