Рецепты по типовым задачам

[leshchenko1979]

Пишите сюда ваши задачи, с которыми вы сталкиваетесь.

Мы создадим раздел "Рецепты" в документации, куда будем писать решения типовых задач.

Если вы увидели чужую задачу, которую вы считаете актуальной, проголосуйте за неё (upvote).

[overlord1781]

Алексей приветствую. В первую очередь спасибо тебе за данную работу, она реально интересна и полезна.
Предложение 1. Расписать более подробно как правильно пользоваться библиотекой. Дело в том что в начале я не где не увидел как правильно её использовать, в плане настроек доступа хука. Благо дошел до этой мысли сам.
Тоесть я бы подробно расписал как запустить библиотеку.

Зачем я пользуюсь данной библиотекой (может наведет вас на интересные мысли)
Я в принципе хочу попробовать использовать данную библиотеку для создания дашборда компании. Связать данные из 1С по продажам с информацией по лидам сделкам меенеджерам и т.д. с последующим анализом. Так как мне не нравится то как это устроено в битрикс.

Есть ли какие то задачи с которыми я могу помочь в развитии библиотеки? Сам я не ахти какой программист, но ищу где можно попрактиковаться

[leshchenko1979]

Привет!

Настройки доступа хука - это больше общий вопрос интеграций с 1С, с этой ли библиотекой или без неё.

Но не проблема, ссылку можно добавить в Readme.

Что касается помощи - можно брать любой понравившийся issue и пробовать с ним разобраться.

Например, можно добавить в Readme ссылку на статью о настройке доступов для хука. :)

[Dirogar]

Рецепт по выгрузке звонков.

class BitrixData:
    START_DATE: str = datetime(2024, 1, 1).strftime('%Y-%m-%d')
    END_DATE: str = datetime(2024, 6, 30).strftime('%Y-%m-%d')
    CALL_SUCCESS_CODE: int = 200
    CALL_FAILED_REASON: str = 'Success call'
    BITRIX_WEBHOOK_URL: str = os.getenv('BITRIX_WEBHOOK_URL')

    def __init__(self):
        """Инициализирует объект для работы с API Bitrix."""
        self.bitrix = BitrixAsync(self.BITRIX_WEBHOOK_URL)

    async def fetch_calls(self) -> List[Dict[str, Any]]:
        """Выводит список сделок за промежуток времени."""
        with self.bitrix.slow():
            return await self.bitrix.get_all(
                'voximplant.statistic.get',
                params={
                    'filter': {
                        '>=CALL_START_DATE': self.START_DATE,
                        '<=CALL_START_DATE': self.END_DATE,
                        'CALL_FAILED_CODE': self.CALL_SUCCESS_CODE,
                        'CALL_FAILED_REASON': self.CALL_FAILED_REASON
                    }
                             })

     async def fetch_activity_id(
            self, calls: List
    ) -> dict:
        """
        Возвращает список активностей по ID.

        :param calls: список звонков с параметром CRM_ACTIVITY_ID
        :return: Список словарей с информацией об активностях
        """
        return await self.bitrix.get_by_ID(
            'crm.activity.get', [d['CRM_ACTIVITY_ID'] for d in calls])

Но есть проблема с тем что битрикс возвращает список звонков, у которых родительская сущность - Контакт (Скорей всего это какой-то косяк интеграции с телефонией, у нас стоит Informunity). Хотя звонок был произведён из сделки. Проблему можно обойти получив activity, а он в свою очередь уже подвязан с сущностью crm откуда был произведён звонок.