whatsapp-api-client-python

Fixes

• Fixed #49

Enhancements

• Added helpful links

Fixes

• Fixed logger

Enhancements

• Updated python-package.yml

Features

• Added time to logs
• Added links to docs
• Added GetAuthorizationCode method (thanks to @Jibek100)

Example:

greenAPI.account.getAuthorizationCode(11001234567)

Fixes

• Fixed workflows
• Fixed UploadFile method logging

Enhancements

• Updated docs
• Updated examples
• Updated tests

Features

• Added Python 3.12 support
• Added GetWaSettings method (thanks to @andreyMalyshkin)

Example:

greenAPI.sending.getWaSettings()

• Added SendPoll method (thanks to @Jibek100)

Example:

greenAPI.sending.sendPoll(
    "[email protected]",
    "Please choose a color:",
    [
        {"optionName": "Red"},
        {"optionName": "Green"},
        {"optionName": "Blue"}
    ]
)

Fixes

• Fixed webhook connection

Enhancements

• Updated examples

Features

• Added debug mode

  In debug mode you can see data received from the Green API. To enable debug mode, add debug_mode option with True value

greenAPI = API.GreenAPI(
    "", "", debug_mode=True
)

• Added raise_errors option

  If the option is enabled, it will be raised when an error is received

greenAPI = API.GreenAPI(
    "", "", raise_errors=True
)

• Fixed ReadTimeout error

• Fixed uploadFile

• Added media host

• Added UploadFile method
• Updated python version
• Updated webhook
• Updated tests

• Updated docs
• Updated examples

• Added badges
• Improved tests
• Updated workflows
• Fixed E711, E712, F401
• Bump requests from 2.30.0 to 2.31.0

• Added method GetMessage
• Updated category Account
• Updated category Sending
• Updated setup.py
• Added linkPreview parameter to SendMessage method

Add ForwardMessages method

Добавил класс GreenAPIError. Он вызывается, когда происходит ошибка (status_code != 200). Его можно обработать таким образом:

try:
    greenAPI.request("GetSettings")
except GreenAPIError as error:
    print(error.error_message)

Добавил GET HTTP метод, как метод по умолчанию.
Мелкие исправления и улучшения

Обновил Webhook класс. Теперь он называется Bot. И хранится этот класс в директории bot. Его можно импортировать вместе с GreenAPI классом:

from whatsapp_api_client_python import GreenAPI, Bot

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

@bot.handler("stateInstanceChanged")
def handler(body: dict):
    print(body["instanceData"])
    print("stateInstanceChanged")

При использовании декоратора message, можно указать текст сообщения в чате WhatsApp, на который нужно ответить (если не указывать, функция будет получать все входящие сообщения). Если функция возвращает строку, то она автоматически будет отправлена в тот же чат. Пример:

@bot.message("Привет")
def message(body: dict) -> str:
    print(body["senderData"])
    print("incomingMessageReceived")

    return f"""Привет, {body["senderData"]["senderName"]}"""

Если в чате написать сообщение Привет, то бот отправит это сообщение: Привет, <имя пользователя WhatsApp>.

Обновил setup.py. Теперь все пакеты библиотеки добавляются автоматически, исключая пакет тестов.

Refactoring that removes breaking changes prior 0.0.27

Back to stable 0.0.23

The release contains breaking changes

Улучшил импорты. Класс GreenApi переименовал в GreenAPI. Все API категории теперь property функции с подсказками типов (type hints). Улучшил функцию request (также добавил подсказки типов (typing)).

Обновлено:
Улучшил Response класс. Обновил инициализацию пакета (Теперь можно сразу импортировать GreenAPI класс). Также обновил тесты (unittest).