a24wh

Python library for Bitrix24 incoming webhooks by Automatization24.

Библиотека Python для работы с входящими вебхуками Bitrix24 от Automatization24.

README (EN)

Version

The package uses classic semantic versioning.

Current version:

0.1.2

Public API

Only 6 public helpers are exported from a24wh:

from a24wh import request24, req24, save_json, batch_list, batch_by_params, to_chat

Install

Install from PyPI:

pip install a24wh

Supported Python versions:

3.10, 3.11, 3.12, 3.13, 3.14

Quick Start

`request24(...)`

import os
from a24wh import request24

response = request24(
    method="crm.deal.get",
    parameters={"id": 10},
    webhook_url=os.getenv("WEBHOOK"),
    all_iters=False,
    )

request24(...) is the helper for classic Bitrix24 REST.

`req24(...)`

import os
from a24wh import req24

response = req24(
    method="crm.item.list",
    parameters={
        "select": ["id", "title"],
        "filter": {
            ">id": 0,
            },
        },
    webhook_url=os.getenv("WEBHOOK"),
    all_iters=False,
    )

req24(...) is the helper for Bitrix24 REST v3.

List method with automatic pagination:

import os
from a24wh import request24

response = request24(
    method="crm.deal.list",
    parameters={
        "order": {"ID": "ASC"},
        "filter": {"=CATEGORY_ID": 0},
        "select": ["ID"],
        },
    webhook_url=os.getenv("WEBHOOK"),
    all_iters=True,
    )

`save_json(...)`

from a24wh import save_json

save_json(response, file_title="crm.deal.get")

`batch_list(...)`

import os
from a24wh import batch_list

response = batch_list(
    method="crm.deal.list",
    parameters={
        "order": {"ID": "ASC"},
        "filter": {"=CATEGORY_ID": 14},
        "select": ["ID", "STAGE_ID", "CONTACT_ID"],
        },
    webhook_url=os.getenv("WEBHOOK"),
    )

`batch_by_params(...)`

import os
from a24wh import batch_by_params

response = batch_by_params(
    method="crm.deal.get",
    params_list=[
        {"id": 56328},
        {"id": 56370},
        {"id": 56380},
        ],
    webhook_url=os.getenv("WEBHOOK"),
    )

`to_chat(...)`

import os
from a24wh import to_chat

response = to_chat(
    text="Test message",
    chat_id="chat11111",
    webhook_url=os.getenv("WEBHOOK_CHAT"),
    )

Response Structure

request24(...), req24(...), batch_list(...), and batch_by_params(...) always return a dict.

Success example:

{"result": ...}

Error example:

{
    "error_result": True,
    "error_type": "http_error",
    "error_code": "500",
    "error_message": "Bitrix24 returned HTTP 500.",
    "method": "crm.deal.get",
    "portal": "example.bitrix24.ru",
    "status_code": 500,
    }

Recommended check:

if "error_result" in response:
    print(response["error_message"])
else:
    print(response)

Environment Variables

Copy-ready .env block with library defaults:

A24WH_DEFAULT_WEBHOOK_URL=
A24WH_TIMEOUT=60
A24WH_RETRY_COUNT=3
A24WH_RETRY_DELAY=1.0
A24WH_REQUEST_DELAY=1.0
A24WH_AUTO_CONFIGURE_LOGGING=0
A24WH_LOG_LEVEL=INFO
A24WH_LOG_TO_CONSOLE=1
A24WH_LOG_TO_FILE=0
A24WH_LOG_FILE=a24wh.log

You can paste this block into .env and change only the values you need.

To enable verbose local logging, change these values in the same block:

A24WH_AUTO_CONFIGURE_LOGGING=1
A24WH_LOG_LEVEL=DEBUG
A24WH_LOG_TO_FILE=1

If webhook_url=None, the library tries to use A24WH_DEFAULT_WEBHOOK_URL.

That gives you two working styles:

Explicit webhook in code:

response = request24(
    method="crm.deal.get",
    parameters={"id": 10},
    webhook_url=os.getenv("WEBHOOK"),
    all_iters=False,
    )

Default webhook from environment:

response = request24(
    method="crm.deal.get",
    parameters={"id": 10},
    webhook_url=None,
    all_iters=False,
    )

Logging

The library logger name is a24wh.

The package does not override application logging automatically unless local auto logging is enabled through environment variables from the block above.

Usage Examples

Batch list example:

import os
from a24wh import batch_list

response = batch_list(
    method="crm.deal.list",
    parameters={
        "order": {"ID": "ASC"},
        "filter": {"=CATEGORY_ID": 14},
        "select": ["ID", "TITLE", "STAGE_ID"],
        },
    webhook_url=os.getenv("WEBHOOK"),
    )

Batch by params example:

import os
from a24wh import batch_by_params

response = batch_by_params(
    method="crm.deal.get",
    params_list=[
        {"id": 56328},
        {"id": 56370},
        {"id": 56380},
        ],
    webhook_url=os.getenv("WEBHOOK"),
    )

Smart process list example:

import os
from a24wh import batch_list

response = batch_list(
    method="crm.item.list",
    parameters={
        "entityTypeId": 190,
        "filter": {"=categoryId": 3},
        "select": ["id", "title", "stageId"],
        },
    webhook_url=os.getenv("WEBHOOK"),
    )

Save response to JSON:

from a24wh import save_json

save_json(response, file_title="crm.deal.list")

Tests

cd /path/to/a24wh
python -m unittest discover -s tests -v

README (RU)

Версия

Пакет использует классическую семантическую версионность.

Текущая версия:

0.1.2

Публичный API

Из a24wh наружу экспортируются только 6 публичных методов:

from a24wh import request24, req24, save_json, batch_list, batch_by_params, to_chat

Установка

Установка из PyPI:

pip install a24wh

Поддерживаемые версии Python:

3.10, 3.11, 3.12, 3.13, 3.14

Быстрый старт

`request24(...)`

import os
from a24wh import request24

response = request24(
    method="crm.deal.get",
    parameters={"id": 10},
    webhook_url=os.getenv("WEBHOOK"),
    all_iters=False,
    )

request24(...) используйте для классического REST Bitrix24.

`req24(...)`

import os
from a24wh import req24

response = req24(
    method="crm.item.list",
    parameters={
        "select": ["id", "title"],
        "filter": {
            ">id": 0,
            },
        },
    webhook_url=os.getenv("WEBHOOK"),
    all_iters=False,
    )

req24(...) используйте для REST v3 Bitrix24.

Списочный метод с автоматическим сбором всех страниц:

import os
from a24wh import request24

response = request24(
    method="crm.deal.list",
    parameters={
        "order": {"ID": "ASC"},
        "filter": {"=CATEGORY_ID": 0},
        "select": ["ID"],
        },
    webhook_url=os.getenv("WEBHOOK"),
    all_iters=True,
    )

`save_json(...)`

from a24wh import save_json

save_json(response, file_title="crm.deal.get")

`batch_list(...)`

import os
from a24wh import batch_list

response = batch_list(
    method="crm.deal.list",
    parameters={
        "order": {"ID": "ASC"},
        "filter": {"=CATEGORY_ID": 14},
        "select": ["ID", "STAGE_ID", "CONTACT_ID"],
        },
    webhook_url=os.getenv("WEBHOOK"),
    )

`batch_by_params(...)`

import os
from a24wh import batch_by_params

response = batch_by_params(
    method="crm.deal.get",
    params_list=[
        {"id": 56328},
        {"id": 56370},
        {"id": 56380},
        ],
    webhook_url=os.getenv("WEBHOOK"),
    )

`to_chat(...)`

import os
from a24wh import to_chat

response = to_chat(
    text="Тестовое сообщение",
    chat_id="chat11111",
    webhook_url=os.getenv("WEBHOOK_CHAT"),
    )

Структура ответа

request24(...), req24(...), batch_list(...) и batch_by_params(...) всегда возвращают dict.

Пример успешного ответа:

{"result": ...}

Пример ответа с ошибкой:

{
    "error_result": True,
    "error_type": "http_error",
    "error_code": "500",
    "error_message": "Bitrix24 returned HTTP 500.",
    "method": "crm.deal.get",
    "portal": "example.bitrix24.ru",
    "status_code": 500,
    }

Рекомендуемая проверка:

if "error_result" in response:
    print(response["error_message"])
else:
    print(response)

Переменные окружения

Готовый блок .env со значениями по умолчанию библиотеки:

A24WH_DEFAULT_WEBHOOK_URL=
A24WH_TIMEOUT=60
A24WH_RETRY_COUNT=3
A24WH_RETRY_DELAY=1.0
A24WH_REQUEST_DELAY=1.0
A24WH_AUTO_CONFIGURE_LOGGING=0
A24WH_LOG_LEVEL=INFO
A24WH_LOG_TO_CONSOLE=1
A24WH_LOG_TO_FILE=0
A24WH_LOG_FILE=a24wh.log

Можно вставить этот блок в .env и поменять только нужные значения.

Чтобы включить подробное локальное логирование, поменяй в этом же блоке такие значения:

A24WH_AUTO_CONFIGURE_LOGGING=1
A24WH_LOG_LEVEL=DEBUG
A24WH_LOG_TO_FILE=1

Если webhook_url=None, библиотека пытается использовать A24WH_DEFAULT_WEBHOOK_URL.

Это дает два рабочих варианта:

Явно передавать webhook в коде:

response = request24(
    method="crm.deal.get",
    parameters={"id": 10},
    webhook_url=os.getenv("WEBHOOK"),
    all_iters=False,
    )

Использовать дефолтный webhook из окружения:

response = request24(
    method="crm.deal.get",
    parameters={"id": 10},
    webhook_url=None,
    all_iters=False,
    )

Логирование

Имя логгера библиотеки: a24wh.

Пакет не переопределяет логирование приложения автоматически, пока ты сам не включишь локальную автоконфигурацию через переменные окружения из блока выше.

Примеры использования

Пример batch list:

import os
from a24wh import batch_list

response = batch_list(
    method="crm.deal.list",
    parameters={
        "order": {"ID": "ASC"},
        "filter": {"=CATEGORY_ID": 14},
        "select": ["ID", "TITLE", "STAGE_ID"],
        },
    webhook_url=os.getenv("WEBHOOK"),
    )

Пример batch by params:

import os
from a24wh import batch_by_params

response = batch_by_params(
    method="crm.deal.get",
    params_list=[
        {"id": 56328},
        {"id": 56370},
        {"id": 56380},
        ],
    webhook_url=os.getenv("WEBHOOK"),
    )

Пример для списка смарт-процесса:

import os
from a24wh import batch_list

response = batch_list(
    method="crm.item.list",
    parameters={
        "entityTypeId": 190,
        "filter": {"=categoryId": 3},
        "select": ["id", "title", "stageId"],
        },
    webhook_url=os.getenv("WEBHOOK"),
    )

Сохранение ответа в JSON:

from a24wh import save_json

save_json(response, file_title="crm.deal.list")

Тесты

cd /path/to/a24wh
python -m unittest discover -s tests -v

Release files for a24wh 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for a24wh 0.1.2
File	Size	Uploaded
a24wh-0.1.2.tar.gz	19.8 kB	May 21, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for a24wh 0.1.2
File	Interpreter	ABI	Platform	Reset
a24wh-0.1.2-py3-none-any.whl 15.7 kB May 21, 2026	Python 3	none	any	Details

Total release size: 35.5 kB

Release files / a24wh-0.1.2.tar.gz

Download URL	a24wh-0.1.2.tar.gz
Size	19.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`182829c069ae9a7f35fdb76ecf6120b546e2ec0ae681a09dfecef3d7681eb44d`
BLAKE2b-256 checksum How to use checksums	`8607e479b700daf17ea6a5fb7248ec6d1a96df33f96aab78c0c78e66f8a8c1d0`
Upload date	May 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.8`

Release files / a24wh-0.1.2-py3-none-any.whl

Download URL	a24wh-0.1.2-py3-none-any.whl
Size	15.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a5977ecf9ed123e0ba4d6c5f24176e76388f6ec65d4e60ef0d84f3e081992d40`
BLAKE2b-256 checksum How to use checksums	`69ba66eea1474e3ef706024560fe58a148eb87489e9d99eb0817f52ad831a2ae`
Upload date	May 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.8`

Release history Release notifications | RSS feed

This release

0.1.2 This release

May 21, 2026 2 release files

0.1.0

Apr 12, 2026 2 release files

a24wh 0.1.2

a24wh

README (EN)

Version

Public API

Install

Quick Start

request24(...)

req24(...)

save_json(...)

batch_list(...)

batch_by_params(...)

to_chat(...)

Response Structure

Environment Variables

Logging

Usage Examples

Tests

README (RU)

Версия

Публичный API

Установка

Быстрый старт

request24(...)

req24(...)

save_json(...)

batch_list(...)

batch_by_params(...)

to_chat(...)

Структура ответа

Переменные окружения

Логирование

Примеры использования

Тесты

Project links

Key dates

1 maintainer

Credits

License expression

Requires

Tags

Classifiers

Release files for a24wh 0.1.2

Source distribution (sdist)

Built distribution (wheel)

Release files / a24wh-0.1.2.tar.gz

Release files / a24wh-0.1.2-py3-none-any.whl

Release history Release notifications | RSS feed

`request24(...)`

`req24(...)`

`save_json(...)`

`batch_list(...)`

`batch_by_params(...)`

`to_chat(...)`

`request24(...)`

`req24(...)`

`save_json(...)`

`batch_list(...)`

`batch_by_params(...)`

`to_chat(...)`