nobox-chat-sdk 1.0.0__tar.gz

nobox_chat_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: nobox-chat-sdk
+Version: 1.0.0
+Summary: Official Python SDK and SignalR/Webhook Integration for NoBox.Ai platform
+Home-page: https://gitlab.ubig.co.id/erik/nobox-chat-python
+Author: NoBox.Ai Team
+Author-email: support@nobox.ai
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# NoBox.Ai Chat Python SDK (`nobox-chat-sdk`)
+
+Official Python Client SDK and Real-time Webhook Receiver Application for **NoBox.Ai** Omnichannel Platform Integration.
+
+🔗 **GitLab Repository**: [https://gitlab.ubig.co.id/erik/nobox-chat-python](https://gitlab.ubig.co.id/erik/nobox-chat-python)
+
+---
+
+## 🐍 Preview Aplikasi Demo & Interactive Console Inspector
+
+Package ini menyediakan solusi **Python SDK lengkap** (dukungan Python 3.7+) yang dilengkapi dengan Service REST API, Webhook HMAC-SHA256 Verifier & Parser, serta **Flask Web Application & Interactive Traffic Inspector** bawaan untuk mempermudah debugging dan integrasi platform NoBox.Ai.
+
+---
+
+## 📦 Instalasi & Dependensi
+
+### Opsi A: Instalasi via PyPI / Pip
+
+```bash
+pip install nobox-chat-sdk
+```
+
+Atau instalasi langsung dari Git Repository:
+
+```bash
+pip install git+https://gitlab.ubig.co.id/erik/nobox-chat-python.git
+```
+
+### Opsi B: Import Library di Kode Python
+
+```python
+from nobox_chat import NoboxChat
+
+# Inisialisasi SDK
+nb = NoboxChat(base_url="https://id.nobox.ai/", app_name="NoBoxChatPython", app_version="1.0.0")
+```
+
+---
+
+## ✨ Fitur Utama
+
+- 🔑 **Autentikasi Native Python**: Login ke NoBox.Ai REST API untuk memperoleh Bearer Token secara otomatis.
+- 📋 **Chatrooms & Messages Manager**: Service intuitif untuk mengambil daftar percakapan, channel, akun WhatsApp terhubung, serta riwayat pesan.
+- 📤 **Fast Message Dispatcher & Media Upload**: Mengirim pesan teks dan konversi attachment base64 ke URL media secara langsung.
+- 🔐 **Webhook HMAC-SHA256 Verifier & Event Parser**: Verifikasi keamanan signature `X-Nobox-Signature-256` dan parsing event payload otomatis (`TerimaPesan`, `TerimaAck`, `TerimaRead`).
+- 📊 **AppInfo & Metadata Tracking**: Melacak header metadata `X-App-Name: NoBoxChatPython` dan `X-App-Version: 1.0.0` pada setiap request API.
+
+---
+
+## 📂 Struktur Repositori
+
+```text
+nobox-chat-python/
+├── setup.py                      # Konfigurasi PyPI Package Installer
+├── requirements.txt              # Dependensi Python (requests, flask)
+├── README.md                     # Dokumentasi Resmi Python SDK
+├── nobox_chat.py                # Core Python SDK Library (`NoboxChat`)
+├── app.py                        # Flask Web Application & Webhook Receiver
+├── templates/
+│   └── index.html                # Frontend Web UI Demo
+└── static/                       # Custom CSS/JS Static Assets
+```
+
+---
+
+## 📖 Panduan Penggunaan Python SDK (`NoboxChat`)
+
+### 1. Autentikasi & Generate Token
+
+```python
+from nobox_chat import NoboxChat
+
+nb = NoboxChat()
+
+# Login untuk mendapatkan Bearer token
+result = nb.generate_token("user@example.com", "password")
+
+if not result["IsError"]:
+    token = result["Data"]
+    print("Token Berhasil Didapatkan:", token)
+else:
+    print("Gagal Login:", result["Error"])
+```
+
+---
+
+### 2. Mengambil Daftar Percakapan & Riwayat Chat
+
+```python
+# 1. Ambil 20 Percakapan Teratas
+chatrooms = nb.fetch_chatrooms(take=20)
+print("Daftar Chatroom:", chatrooms["Data"])
+
+# 2. Ambil Riwayat Pesan berdasarkan Room ID
+messages = nb.fetch_messages(room_id="ROOM_ID_123", take=50)
+print("Riwayat Pesan:", messages["Data"])
+```
+
+---
+
+### 3. Mengirim Pesan Teks & Media via REST API
+
+```python
+# 1. Mengirim Pesan Teks
+send_res = nb.send_message(
+    ext_id="628123456789",
+    channel_id=1,
+    account_id="744927678136325",
+    text="Halo dari Python SDK NoBox.Ai!"
+)
+
+# 2. Upload Attachment Base64
+with open("photo.jpg", "rb") as f:
+    import base64
+    b64_data = base64.b64encode(f.read()).decode("utf-8")
+
+upload_res = nb.upload_base64_to_file({
+    "media": {
+        "filename": "photo.jpg",
+        "mimetype": "image/jpeg",
+        "data": b64_data
+    }
+})
+```
+
+---
+
+### 4. Webhook Verification & Event Handler
+
+```python
+from nobox_chat import NoboxChat
+
+# Verifikasi & Parse Payload Webhook HMAC-SHA256
+try:
+    event_data = NoboxChat.handle_webhook(
+        payload_body=raw_json_body,
+        signature_header=request_headers.get("X-Nobox-Signature-256"),
+        webhook_secret="YOUR_WEBHOOK_SECRET",
+        throw_error=True
+    )
+    print("Webhook Valid! Event:", event_data)
+except ValueError as e:
+    print("Webhook Invalid:", str(e))
+```
+
+---
+
+## 🌐 Menjalankan Flask Application Demo secara Lokal
+
+Untuk menjalankan aplikasi demo Web UI & Webhook receiver lokal:
+
+```bash
+pip install -r requirements.txt
+python app.py
+```
+
+Buka browser Anda di: `http://localhost:5001` atau `http://127.0.0.1:5001`.
+
+---
+
+## 📄 Lisensi
+
+Proyek ini dirilis di bawah lisensi **MIT License**.

nobox_chat_sdk-1.0.0/README.md

@@ -0,0 +1,163 @@
+# NoBox.Ai Chat Python SDK (`nobox-chat-sdk`)
+
+Official Python Client SDK and Real-time Webhook Receiver Application for **NoBox.Ai** Omnichannel Platform Integration.
+
+🔗 **GitLab Repository**: [https://gitlab.ubig.co.id/erik/nobox-chat-python](https://gitlab.ubig.co.id/erik/nobox-chat-python)
+
+---
+
+## 🐍 Preview Aplikasi Demo & Interactive Console Inspector
+
+Package ini menyediakan solusi **Python SDK lengkap** (dukungan Python 3.7+) yang dilengkapi dengan Service REST API, Webhook HMAC-SHA256 Verifier & Parser, serta **Flask Web Application & Interactive Traffic Inspector** bawaan untuk mempermudah debugging dan integrasi platform NoBox.Ai.
+
+---
+
+## 📦 Instalasi & Dependensi
+
+### Opsi A: Instalasi via PyPI / Pip
+
+```bash
+pip install nobox-chat-sdk
+```
+
+Atau instalasi langsung dari Git Repository:
+
+```bash
+pip install git+https://gitlab.ubig.co.id/erik/nobox-chat-python.git
+```
+
+### Opsi B: Import Library di Kode Python
+
+```python
+from nobox_chat import NoboxChat
+
+# Inisialisasi SDK
+nb = NoboxChat(base_url="https://id.nobox.ai/", app_name="NoBoxChatPython", app_version="1.0.0")
+```
+
+---
+
+## ✨ Fitur Utama
+
+- 🔑 **Autentikasi Native Python**: Login ke NoBox.Ai REST API untuk memperoleh Bearer Token secara otomatis.
+- 📋 **Chatrooms & Messages Manager**: Service intuitif untuk mengambil daftar percakapan, channel, akun WhatsApp terhubung, serta riwayat pesan.
+- 📤 **Fast Message Dispatcher & Media Upload**: Mengirim pesan teks dan konversi attachment base64 ke URL media secara langsung.
+- 🔐 **Webhook HMAC-SHA256 Verifier & Event Parser**: Verifikasi keamanan signature `X-Nobox-Signature-256` dan parsing event payload otomatis (`TerimaPesan`, `TerimaAck`, `TerimaRead`).
+- 📊 **AppInfo & Metadata Tracking**: Melacak header metadata `X-App-Name: NoBoxChatPython` dan `X-App-Version: 1.0.0` pada setiap request API.
+
+---
+
+## 📂 Struktur Repositori
+
+```text
+nobox-chat-python/
+├── setup.py                      # Konfigurasi PyPI Package Installer
+├── requirements.txt              # Dependensi Python (requests, flask)
+├── README.md                     # Dokumentasi Resmi Python SDK
+├── nobox_chat.py                # Core Python SDK Library (`NoboxChat`)
+├── app.py                        # Flask Web Application & Webhook Receiver
+├── templates/
+│   └── index.html                # Frontend Web UI Demo
+└── static/                       # Custom CSS/JS Static Assets
+```
+
+---
+
+## 📖 Panduan Penggunaan Python SDK (`NoboxChat`)
+
+### 1. Autentikasi & Generate Token
+
+```python
+from nobox_chat import NoboxChat
+
+nb = NoboxChat()
+
+# Login untuk mendapatkan Bearer token
+result = nb.generate_token("user@example.com", "password")
+
+if not result["IsError"]:
+    token = result["Data"]
+    print("Token Berhasil Didapatkan:", token)
+else:
+    print("Gagal Login:", result["Error"])
+```
+
+---
+
+### 2. Mengambil Daftar Percakapan & Riwayat Chat
+
+```python
+# 1. Ambil 20 Percakapan Teratas
+chatrooms = nb.fetch_chatrooms(take=20)
+print("Daftar Chatroom:", chatrooms["Data"])
+
+# 2. Ambil Riwayat Pesan berdasarkan Room ID
+messages = nb.fetch_messages(room_id="ROOM_ID_123", take=50)
+print("Riwayat Pesan:", messages["Data"])
+```
+
+---
+
+### 3. Mengirim Pesan Teks & Media via REST API
+
+```python
+# 1. Mengirim Pesan Teks
+send_res = nb.send_message(
+    ext_id="628123456789",
+    channel_id=1,
+    account_id="744927678136325",
+    text="Halo dari Python SDK NoBox.Ai!"
+)
+
+# 2. Upload Attachment Base64
+with open("photo.jpg", "rb") as f:
+    import base64
+    b64_data = base64.b64encode(f.read()).decode("utf-8")
+
+upload_res = nb.upload_base64_to_file({
+    "media": {
+        "filename": "photo.jpg",
+        "mimetype": "image/jpeg",
+        "data": b64_data
+    }
+})
+```
+
+---
+
+### 4. Webhook Verification & Event Handler
+
+```python
+from nobox_chat import NoboxChat
+
+# Verifikasi & Parse Payload Webhook HMAC-SHA256
+try:
+    event_data = NoboxChat.handle_webhook(
+        payload_body=raw_json_body,
+        signature_header=request_headers.get("X-Nobox-Signature-256"),
+        webhook_secret="YOUR_WEBHOOK_SECRET",
+        throw_error=True
+    )
+    print("Webhook Valid! Event:", event_data)
+except ValueError as e:
+    print("Webhook Invalid:", str(e))
+```
+
+---
+
+## 🌐 Menjalankan Flask Application Demo secara Lokal
+
+Untuk menjalankan aplikasi demo Web UI & Webhook receiver lokal:
+
+```bash
+pip install -r requirements.txt
+python app.py
+```
+
+Buka browser Anda di: `http://localhost:5001` atau `http://127.0.0.1:5001`.
+
+---
+
+## 📄 Lisensi
+
+Proyek ini dirilis di bawah lisensi **MIT License**.

nobox_chat_sdk-1.0.0/nobox_chat.py

@@ -0,0 +1,202 @@
+"""
+NoBox Chat Python SDK
+NoBox.Ai Chat integration via REST API & Webhook.
+
+Usage:
+    from nobox_chat import NoboxChat
+
+    nb = NoboxChat()
+    nb.generate_token("email@domain.com", "password")
+    chatrooms = nb.fetch_chatrooms()
+    nb.send_message(ext_id, channel_id, account_id, "Hello from Python!")
+"""
+
+import json
+import hashlib
+import hmac
+import re
+import requests
+import urllib3
+urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
+
+
+class NoboxChat:
+    """Main NoBox.Ai Chat SDK class."""
+
+    BODY_TYPE_MAP = {
+        1: "Text", 2: "Audio", 3: "Image", 4: "Video", 5: "File",
+        7: "Sticker", 9: "Location", 10: "Order", 11: "Product",
+        12: "VCARD", 13: "VCARD_MULTI",
+    }
+
+    def __init__(self, token: str = "", base_url: str = "https://id.nobox.ai/", app_name: str = "NoBoxChatPython", app_version: str = "1.0.0"):
+        self.base_url = base_url.rstrip("/") + "/"
+        self.token = token
+        self.app_name = app_name
+        self.app_version = app_version
+
+    def set_token(self, token: str):
+        self.token = token
+
+    def get_token(self):
+        return self.token
+
+    def set_base_url(self, base_url: str):
+        self.base_url = base_url.rstrip("/") + "/"
+
+    def set_app_info(self, app_name: str, app_version: str = "1.0.0"):
+        if app_name:
+            self.app_name = app_name
+        if app_version:
+            self.app_version = app_version
+
+    # ── Internal helpers ────────────────────────────────────────────────
+
+    @staticmethod
+    def _parse_error_message(data: dict, raw_response: str = "") -> str:
+        if not data:
+            return re.sub(r"<[^>]+>", "", raw_response) if raw_response else "Server error"
+        if "Error" in data:
+            err = data["Error"]
+            if isinstance(err, dict):
+                return err.get("InitialText", err.get("Message", json.dumps(err)))
+            if isinstance(err, str):
+                return err
+        for key in ("message", "Message", "error"):
+            if key in data and isinstance(data[key], str):
+                return data[key]
+        return "Server error"
+
+    def _request(self, endpoint: str, payload: dict = None, requires_auth: bool = True) -> dict:
+        """Internal requester"""
+        url = self.base_url + endpoint.lstrip("/")
+        headers = {
+            "Content-Type": "application/json",
+            "X-App-Name": self.app_name,
+            "X-App-Version": self.app_version,
+            "User-Agent": f"{self.app_name}/{self.app_version}"
+        }
+        if requires_auth and self.token:
+            headers["Authorization"] = f"Bearer {self.token}"
+        try:
+            resp = requests.post(url, json=payload or {}, headers=headers, timeout=30, verify=False)
+            http_code = resp.status_code
+            data = resp.json()
+        except requests.RequestException as e:
+            return {"IsError": True, "Code": 500, "Data": None, "Error": str(e)}
+        except (json.JSONDecodeError, ValueError):
+            return {"IsError": True, "Code": http_code, "Data": None, "Error": f"Invalid JSON: {resp.text[:200]}"}
+
+        if "Error" in data and data["Error"] is not None:
+            return {
+                "IsError": True,
+                "Code": http_code,
+                "Data": data.get("Entities", data.get("Data")),
+                "Error": self._parse_error_message(data, resp.text),
+            }
+        return {
+            "IsError": False,
+            "Code": http_code,
+            "Data": data.get("Entities", data.get("Data", data)),
+            "Error": None,
+        }
+
+    # ── Public API ──────────────────────────────────────────────────────
+
+    def generate_token(self, username: str, password: str) -> dict:
+        """Authenticate user, store token."""
+        url = self.base_url + "AccountAPI/GenerateToken"
+        headers = {
+            "Content-Type": "application/json",
+            "X-App-Name": self.app_name,
+            "X-App-Version": self.app_version,
+            "User-Agent": f"{self.app_name}/{self.app_version}"
+        }
+        try:
+            resp = requests.post(
+                url,
+                json={"username": username, "password": password},
+                headers=headers,
+                timeout=30,
+                verify=False,
+            )
+            http_code = resp.status_code
+            data = resp.json()
+        except requests.RequestException as e:
+            return {"IsError": True, "Code": 500, "Data": None, "Error": str(e)}
+        except (json.JSONDecodeError, ValueError):
+            return {"IsError": True, "Code": http_code, "Data": None, "Error": f"Invalid JSON: {resp.text[:200]}"}
+
+        if "token" in data and data["token"]:
+            self.token = data["token"]
+            return {"IsError": False, "Code": http_code, "Data": data["token"], "Error": None}
+
+        error_msg = self._parse_error_message(data, resp.text)
+        return {"IsError": True, "Code": http_code, "Data": None, "Error": error_msg, "RawResponse": resp.text}
+
+    def fetch_chatrooms(self, take: int = 20, sort: list = None) -> dict:
+        """Fetch conversation list."""
+        payload = {"Sort": sort or ["Up DESC"], "Take": take}
+        return self._request("Services/Chat/Chatrooms/List", payload)
+
+    def fetch_messages(self, room_id=None, ext_id=None, take: int = 20, sort: list = None) -> dict:
+        """Fetch message history per room."""
+        payload = {"Sort": sort or ["In DESC"], "Take": take, "EqualityFilter": {}}
+        if room_id:
+            payload["EqualityFilter"]["RoomId"] = room_id
+        return self._request("Services/Chat/Chatmessages/List", payload)
+
+    def fetch_account_list(self) -> dict:
+        """Fetch WhatsApp accounts."""
+        payload = {"IncludeColumns": ["Id", "Name", "Channel"], "ColumnSelection": 1}
+        return self._request("Services/Nobox/Account/List", payload)
+
+    def fetch_channels(self) -> dict:
+        """Fetch channels."""
+        payload = {"IncludeColumns": ["Id", "Nm"], "ColumnSelection": 1}
+        return self._request("Services/Master/Channel/List", payload)
+
+    def send_message(self, ext_id, channel_id, account_id, text: str = "", body_type: int = 1, attachment=None) -> dict:
+        """Send message via REST API."""
+        payload = {
+            "ExtId": str(ext_id),
+            "ChannelId": int(channel_id),
+            "AccountIds": str(account_id),
+            "BodyType": int(body_type),
+            "Body": str(text),
+            "Attachment": attachment,
+        }
+        return self._request("Inbox/Send", payload)
+
+    def upload_base64_to_file(self, payload: dict) -> dict:
+        """Upload base64 media."""
+        return self._request("Inbox/UploadFile/ConvertBase64ToFile", payload)
+
+    # ── Webhook ─────────────────────────────────────────────────────────
+
+    @staticmethod
+    def handle_webhook(payload_body: str, signature_header: str, webhook_secret: str, throw_error: bool = True):
+        """Validate & parse HMAC-SHA256 webhook payload."""
+        if not signature_header:
+            if throw_error:
+                raise ValueError("Unauthorized: Missing Webhook Signature header.")
+            return None
+
+        provided = re.sub(r"sha256=", "", signature_header.lower())
+        expected = hmac.new(webhook_secret.encode(), payload_body.encode(), hashlib.sha256).hexdigest()
+
+        if not hmac.compare_digest(expected, provided):
+            if throw_error:
+                raise ValueError("Unauthorized: Invalid webhook signature.")
+            return None
+
+        data = json.loads(payload_body)
+        if not data:
+            if throw_error:
+                raise ValueError("Bad Request: Invalid JSON payload.")
+            return None
+        return data
+
+
+# Backward compatibility alias
+NoboxInbox = NoboxChat

nobox_chat_sdk-1.0.0/nobox_chat_sdk.egg-info/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: nobox-chat-sdk
+Version: 1.0.0
+Summary: Official Python SDK and SignalR/Webhook Integration for NoBox.Ai platform
+Home-page: https://gitlab.ubig.co.id/erik/nobox-chat-python
+Author: NoBox.Ai Team
+Author-email: support@nobox.ai
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# NoBox.Ai Chat Python SDK (`nobox-chat-sdk`)
+
+Official Python Client SDK and Real-time Webhook Receiver Application for **NoBox.Ai** Omnichannel Platform Integration.
+
+🔗 **GitLab Repository**: [https://gitlab.ubig.co.id/erik/nobox-chat-python](https://gitlab.ubig.co.id/erik/nobox-chat-python)
+
+---
+
+## 🐍 Preview Aplikasi Demo & Interactive Console Inspector
+
+Package ini menyediakan solusi **Python SDK lengkap** (dukungan Python 3.7+) yang dilengkapi dengan Service REST API, Webhook HMAC-SHA256 Verifier & Parser, serta **Flask Web Application & Interactive Traffic Inspector** bawaan untuk mempermudah debugging dan integrasi platform NoBox.Ai.
+
+---
+
+## 📦 Instalasi & Dependensi
+
+### Opsi A: Instalasi via PyPI / Pip
+
+```bash
+pip install nobox-chat-sdk
+```
+
+Atau instalasi langsung dari Git Repository:
+
+```bash
+pip install git+https://gitlab.ubig.co.id/erik/nobox-chat-python.git
+```
+
+### Opsi B: Import Library di Kode Python
+
+```python
+from nobox_chat import NoboxChat
+
+# Inisialisasi SDK
+nb = NoboxChat(base_url="https://id.nobox.ai/", app_name="NoBoxChatPython", app_version="1.0.0")
+```
+
+---
+
+## ✨ Fitur Utama
+
+- 🔑 **Autentikasi Native Python**: Login ke NoBox.Ai REST API untuk memperoleh Bearer Token secara otomatis.
+- 📋 **Chatrooms & Messages Manager**: Service intuitif untuk mengambil daftar percakapan, channel, akun WhatsApp terhubung, serta riwayat pesan.
+- 📤 **Fast Message Dispatcher & Media Upload**: Mengirim pesan teks dan konversi attachment base64 ke URL media secara langsung.
+- 🔐 **Webhook HMAC-SHA256 Verifier & Event Parser**: Verifikasi keamanan signature `X-Nobox-Signature-256` dan parsing event payload otomatis (`TerimaPesan`, `TerimaAck`, `TerimaRead`).
+- 📊 **AppInfo & Metadata Tracking**: Melacak header metadata `X-App-Name: NoBoxChatPython` dan `X-App-Version: 1.0.0` pada setiap request API.
+
+---
+
+## 📂 Struktur Repositori
+
+```text
+nobox-chat-python/
+├── setup.py                      # Konfigurasi PyPI Package Installer
+├── requirements.txt              # Dependensi Python (requests, flask)
+├── README.md                     # Dokumentasi Resmi Python SDK
+├── nobox_chat.py                # Core Python SDK Library (`NoboxChat`)
+├── app.py                        # Flask Web Application & Webhook Receiver
+├── templates/
+│   └── index.html                # Frontend Web UI Demo
+└── static/                       # Custom CSS/JS Static Assets
+```
+
+---
+
+## 📖 Panduan Penggunaan Python SDK (`NoboxChat`)
+
+### 1. Autentikasi & Generate Token
+
+```python
+from nobox_chat import NoboxChat
+
+nb = NoboxChat()
+
+# Login untuk mendapatkan Bearer token
+result = nb.generate_token("user@example.com", "password")
+
+if not result["IsError"]:
+    token = result["Data"]
+    print("Token Berhasil Didapatkan:", token)
+else:
+    print("Gagal Login:", result["Error"])
+```
+
+---
+
+### 2. Mengambil Daftar Percakapan & Riwayat Chat
+
+```python
+# 1. Ambil 20 Percakapan Teratas
+chatrooms = nb.fetch_chatrooms(take=20)
+print("Daftar Chatroom:", chatrooms["Data"])
+
+# 2. Ambil Riwayat Pesan berdasarkan Room ID
+messages = nb.fetch_messages(room_id="ROOM_ID_123", take=50)
+print("Riwayat Pesan:", messages["Data"])
+```
+
+---
+
+### 3. Mengirim Pesan Teks & Media via REST API
+
+```python
+# 1. Mengirim Pesan Teks
+send_res = nb.send_message(
+    ext_id="628123456789",
+    channel_id=1,
+    account_id="744927678136325",
+    text="Halo dari Python SDK NoBox.Ai!"
+)
+
+# 2. Upload Attachment Base64
+with open("photo.jpg", "rb") as f:
+    import base64
+    b64_data = base64.b64encode(f.read()).decode("utf-8")
+
+upload_res = nb.upload_base64_to_file({
+    "media": {
+        "filename": "photo.jpg",
+        "mimetype": "image/jpeg",
+        "data": b64_data
+    }
+})
+```
+
+---
+
+### 4. Webhook Verification & Event Handler
+
+```python
+from nobox_chat import NoboxChat
+
+# Verifikasi & Parse Payload Webhook HMAC-SHA256
+try:
+    event_data = NoboxChat.handle_webhook(
+        payload_body=raw_json_body,
+        signature_header=request_headers.get("X-Nobox-Signature-256"),
+        webhook_secret="YOUR_WEBHOOK_SECRET",
+        throw_error=True
+    )
+    print("Webhook Valid! Event:", event_data)
+except ValueError as e:
+    print("Webhook Invalid:", str(e))
+```
+
+---
+
+## 🌐 Menjalankan Flask Application Demo secara Lokal
+
+Untuk menjalankan aplikasi demo Web UI & Webhook receiver lokal:
+
+```bash
+pip install -r requirements.txt
+python app.py
+```
+
+Buka browser Anda di: `http://localhost:5001` atau `http://127.0.0.1:5001`.
+
+---
+
+## 📄 Lisensi
+
+Proyek ini dirilis di bawah lisensi **MIT License**.

nobox_chat_sdk-1.0.0/nobox_chat_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+nobox_chat.py
+setup.py
+nobox_chat_sdk.egg-info/PKG-INFO
+nobox_chat_sdk.egg-info/SOURCES.txt
+nobox_chat_sdk.egg-info/dependency_links.txt
+nobox_chat_sdk.egg-info/requires.txt
+nobox_chat_sdk.egg-info/top_level.txt

nobox_chat_sdk-1.0.0/nobox_chat_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

nobox_chat_sdk-1.0.0/nobox_chat_sdk.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.0

nobox_chat_sdk-1.0.0/nobox_chat_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+nobox_chat

nobox_chat_sdk-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

nobox_chat_sdk-1.0.0/setup.py

@@ -0,0 +1,27 @@
+import os
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="nobox-chat-sdk",
+    version="1.0.0",
+    author="NoBox.Ai Team",
+    author_email="support@nobox.ai",
+    description="Official Python SDK and SignalR/Webhook Integration for NoBox.Ai platform",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://gitlab.ubig.co.id/erik/nobox-chat-python",
+    py_modules=["nobox_chat"],
+    packages=find_packages(),
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.7",
+    install_requires=[
+        "requests>=2.25.0",
+    ],
+)