Metadata-Version: 2.1
Name: chatlabs-support
Version: 0.1.3
Summary: 
Home-page: https://github.com/RostHarcha/chatlabs-support
Author: Rostislaww
Author-email: rostiki.com@mail.ru
Requires-Python: >=3.11,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Provides-Extra: chatlabs-aiogram-support
Provides-Extra: chatlabs-django-support
Requires-Dist: aiogram (>=3.16.0,<4.0.0) ; extra == "chatlabs-aiogram-support"
Requires-Dist: aiogram-dialog (>=2.3.0,<3.0.0) ; extra == "chatlabs-aiogram-support"
Requires-Dist: channels (>=4.2.0,<5.0.0) ; extra == "chatlabs-django-support"
Requires-Dist: daphne (>=4.1.2,<5.0.0) ; extra == "chatlabs-django-support"
Requires-Dist: django (==5.0.1) ; extra == "chatlabs-django-support"
Requires-Dist: django-filter (>=24.3,<25.0) ; extra == "chatlabs-django-support"
Requires-Dist: djangorestframework (>=3.15.2,<4.0.0) ; extra == "chatlabs-django-support"
Description-Content-Type: text/markdown

# Закладки
- [ChatLabs Support](#chatlabs-support)
    - [Aiogram Support](#chatlabs-aiogram-support)
        - [Установка](#chatlabs-aiogram-support---установка)
    - [Django Support](#chatlabs-django-support)
        - [Установка](#chatlabs-django-support---установка)
        - [Отправляемые сообщения](#chatlabs-django-support---отправляемые-сообщения)
        - [Получаемые сообщения](#chatlabs-django-support---Получаемые-сообщения)

# ChatLabs Support

## ChatLabs Aiogram Support

### ChatLabs Aiogram Support - Установка

`pip install chatlabs-support[chatlabs_aiogram_support]`

Необходимые переменные окружения:
- `BACKEND_SCHEMA`
- `BACKEND_HOST`
- `BACKEND_PORT`

Добавление роутера поддержки в диспетчер:
```python
from aiogram import Dispatcher

from chatlabs_support import chatlabs_aiogram_support as support

dp = Dispatcher()

dp.include_router(support.dialog_router)
```

Добавление кнопки поддержки в окно:
```python
from aiogram_dialog import Dialog, Window
from aiogram_dialog.widgets.kbd import Start
from aiogram_dialog.widgets.text import Const

from chatlabs_support import chatlabs_aiogram_support as support

Dialog(
    ...,
    Window(
        ...,
        Start(
            text=Const('Поддержка'),
            id='support',
            state=support.main_state,
        ),
        ...,
    ),
    ...,
)
```

Альтернативный вариант:
```python
from aiogram_dialog import Dialog, Window

from chatlabs_support import chatlabs_aiogram_support as support

Dialog(
    ...,
    Window(
        ...,
        support.SupportStartButton,
        ...,
    ),
    ...,
)
```

## ChatLabs Django Support

### ChatLabs Django Support - Установка

`pip install chatlabs-support[chatlabs_django_support]`

Для привязки тикетов необходимо определить модель пользователя
```python
# myapp/models.py

class MyUser(models.Model):
    telegram_id = models.BigIntegerField(
        primary_key=True,
        unique=True,
    )
    ...
```
Обратите внимание, что наличие в этой модели поля
telegram_id (PK, Unique) - обязательно

```python
# django_project/settings.py

INSTALLED_APPS = [
    'daphne',
    'channels',
    ...,
    'myapp',
    'chatlabs_support.chatlabs_django_support',
]

ASGI_APPLICATION = 'django_project.asgi.application'

CHANNEL_LAYERS = {
    'default': {
        'BACKEND': 'channels.layers.InMemoryChannelLayer',
    },
}

SUPPORT_TELEGRAM_USER_MODEL = 'myapp.MyUser'
```

```python
# django_project/asgi.py

import os

from channels.auth import AuthMiddlewareStack
from channels.routing import ProtocolTypeRouter, URLRouter
from django.core.asgi import get_asgi_application

from chatlabs_support.chatlabs_django_support.routing import ws_urlpatterns

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'example_project.settings')

application = ProtocolTypeRouter({
    'http': get_asgi_application(),
    'websocket': AuthMiddlewareStack(URLRouter(ws_urlpatterns)),
})
```

```python
# django_project/urls.py

urlpatterns = [
    ...,
    path('support/', include('chatlabs_support.chatlabs_django_support.urls')),
]
```

### ChatLabs Django Support - Отправляемые сообщения

Принять тикет в работу:
```json
{
    "type": "ticket.assign",
    "id": 16 // ID тикета
}
```

Сообщение просмотрено:
```json
{
    "type": "ticket.message.viewed",
    "ticket_id": 16, // ID тикета
    "message_id": 28 // ID сообщения
}
```

Отправить сообщение:
```json
{
    "type": "ticket.message.new",
    "ticket_id": 16, // ID тикета
    "text": "The is some text" // текст сообщения
}
```

Тикет открыт (запросить список сообщений):
```json
{
    "type": "ticket.message.list",
    "ticket_id": 16, // ID тикета
}
```

### ChatLabs Django Support - Получаемые сообщения

Создан новый тикет:
```json
{
    "type": "ticket.created",
    "ticket": {
        "id": 21, // ID тикета
        "user": { // Информация о пользователе
            "telegram_id": 4 // telegram_id пользователя
        },
        "support_manager": null, // назначенный менеджер
        "created_at": "2024-12-29T16:10:38.620768Z", // дата создания
        "title": "have a prob" // заголовок тикета
    }
}
```

Тикет назначен:
```json
{
    "type": "ticket.assigned",
    "id": 16, // ID тикета
    "support_manager": 1, // ID менеджера
}
```

Сообщение просмотрено:
```json
{
    "type": "ticket.message.viewed",
    "message": {
        "id": 29, // ID сообщения
        "created_at": "2024-12-29T15:21:18.498325Z", // дата создания
        "sender": "user", // отправитель, "user" - пользователь, "supp" - менеджер
        "text": "jhklhjbkbklb", // текст сообщения
        "viewed": true, // сообщение просмотрено
        "ticket": 16 // ID тикета
    }
}
```

Новое сообщение:
```json
{
    "type": "ticket.message.new",
    "message": {
        "id": 31, // ID сообщения
        "created_at": "2024-12-29T16:08:04.267002Z", // дата создания
        "sender": "supp", // отправитель, "user" - пользователь, "supp" - менеджер
        "text": "some_text", // текст сообщения
        "viewed": true, // сообщение просмотрено
        "ticket": 16 // ID тикета
    }
}
```

Список сообщений в тикете:
```json
{
    "type": "ticket.message.list",
    "ticket_id": 16, // ID тикета
    "messages": [
        {
            "id": 31, // ID сообщения
            "created_at": "2024-12-29T16:08:04.267002Z", // дата создания
            "sender": "supp", // отправитель, "user" - пользователь, "supp" - менеджер
            "text": "some_text", // текст сообщения
            "viewed": true, // сообщение просмотрено
            "ticket": 16 // ID тикета
        },
        {
            "id": 30, // ID сообщения
            "created_at": "2024-12-29T15:22:01.299698Z", // дата создания
            "sender": "user", // отправитель, "user" - пользователь, "supp" - менеджер
            "text": "jhklhjbkbklb", // текст сообщения
            "viewed": false, // сообщение просмотрено
            "ticket": 16 // ID тикета
        },
    ]
}
```

