@andrey4emk/npm-app-back-b24 0.3.3 → 0.3.6

package/README.md

@@ -10,6 +10,7 @@
     -   [OAuth функции](#oauth-функции)
     -   [Утилиты](#утилиты)
     -   [События](#события)
+    -   [ChatApp](#chatapp)
 -   [Переменные окружения](#переменные-окружения)
 -   [Скрипты](#скрипты)
 -   [Лицензия](#лицензия)
@@ -24,6 +25,7 @@ npm install @andrey4emk/npm-app-back-b24
 
 ```js
 import { create, refresh, save, errTask, Event } from "@andrey4emk/npm-app-back-b24";
+import { chatApp } from "@andrey4emk/npm-app-back-b24";
 import { AuthB24Model } from "./models/AuthB24.js"; // пример модели
 
 // OAuth функции
@@ -41,6 +43,13 @@ await errTask(b24Client, {
 // Работа с событиями
 const eventHandler = new Event(b24Client);
 const { error, events } = await eventHandler.get("ONCRMDYNAMICITEMUPDATE_149");
+
+// Работа с ChatApp
+await chatApp.makeTokenChatApp();
+const result = await chatApp.sendMessageChatApp("whatsApp", {
+    phone: "+1234567890",
+    message: "Привет!",
+});
 ```
 
 ## API
@@ -258,6 +267,203 @@ const { error, events } = await eventHandler.get("ONCRMDYNAMICITEMUPDATE_149");
         // updated содержит все события, кроме entityId: 101
         ```
 
+### ChatApp
+
+-   **`chatApp`** — готовый экземпляр класса `ChatApp` для работы с мессенджерами через платформу ChatApp Online.
+
+    ```js
+    import { chatApp } from "@andrey4emk/npm-app-back-b24";
+    ```
+
+    **Методы:**
+
+    -   **`makeTokenChatApp()`** — получить токены доступа для ChatApp API.
+
+        -   **Возвращает:** промис с объектом:
+
+            ```js
+            {
+                error: false;
+            }
+            ```
+
+            или при ошибке:
+
+            ```js
+            {
+                error: true,
+                message: "Не удалось получить токен ChatApp",
+                data: { /* API response */ }
+            }
+            ```
+
+        -   **Особенности:**
+            -   Сохраняет полученные токены в свойствах экземпляра (`accessToken`, `refreshToken` и т.д.).
+            -   Требует переменные окружения: `CHATAPP_EMAIL`, `CHATAPP_PASS`, `CHATAPP_APP_ID`.
+
+        ```js
+        const result = await chatApp.makeTokenChatApp();
+        if (!result.error) {
+            console.log("Токены успешно получены");
+        }
+        ```
+
+    -   **`refreshTokenChatApp()`** — обновить токены доступа.
+
+        -   **Возвращает:** промис с объектом:
+
+            ```js
+            {
+                error: false;
+            }
+            ```
+
+            или при ошибке:
+
+            ```js
+            {
+                error: true,
+                message: "Не удалось обновить токен ChatApp",
+                data: { /* API response */ }
+            }
+            ```
+
+        -   **Алгоритм:**
+            1. Пытается обновить токены через API.
+            2. Если обновление не удалось, автоматически получает новые токены через `makeTokenChatApp()`.
+
+        ```js
+        const result = await chatApp.refreshTokenChatApp();
+        if (!result.error) {
+            console.log("Токены обновлены");
+        }
+        ```
+
+    -   **`checkTokenChatApp()`** — проверить валидность текущего токена.
+
+        -   **Возвращает:** промис с объектом:
+
+            ```js
+            {
+                error: false,
+                message: "Токен действителен" // или "Токен обновлен"
+            }
+            ```
+
+            или при ошибке:
+
+            ```js
+            {
+                error: true,
+                message: "<текст ошибки>",
+                data: null
+            }
+            ```
+
+        -   **Особенности:**
+            -   Если токен невалидный, автоматически вызывает `refreshTokenChatApp()`.
+
+        ```js
+        const result = await chatApp.checkTokenChatApp();
+        console.log(result.message);
+        ```
+
+    -   **`getLicensesChatApp()`** — получить список лицензий для текущего аккаунта.
+
+        -   **Возвращает:** промис с объектом:
+
+            ```js
+            {
+                error: false,
+                message: "Лицензии успешно получены",
+                data: [ /* массив лицензий */ ]
+            }
+            ```
+
+            или при ошибке:
+
+            ```js
+            {
+                error: true,
+                message: "Не удалось получить лицензии ChatApp",
+                data: null
+            }
+            ```
+
+        -   **Структура лицензии в массиве:**
+            ```js
+            {
+                id: 15779,
+                licenseName: "*5787",
+                messengers: [
+                    { type: "grWhatsApp", name: "[WEB] WhatsApp" }
+                ]
+            }
+            ```
+
+        ```js
+        const result = await chatApp.getLicensesChatApp();
+        if (!result.error) {
+            console.log("Доступные лицензии:", result.data);
+        }
+        ```
+
+    -   **`sendMessageChatApp(messengerType, messageData)`** — отправить сообщение через мессенджер.
+
+        -   **Параметры:**
+
+            -   `messengerType` (string) — тип мессенджера: `"whatsApp"` или `"telegram"`.
+            -   `messageData` (object) — объект с данными сообщения:
+                -   `phone` (string) — номер телефона или ID чата получателя.
+                -   `message` (string) — текст сообщения.
+
+        -   **Возвращает:** промис с объектом:
+
+            ```js
+            {
+                error: false,
+                message: "Сообщение успешно отправлено в ChatApp через whatsApp",
+                data: null
+            }
+            ```
+
+            или при ошибке:
+
+            ```js
+            {
+                error: true,
+                message: "Ошибка при отправке сообщения в ChatApp через whatsApp",
+                data: null
+            }
+            ```
+
+        -   **Особенности:**
+            -   Перед отправкой автоматически проверяет токен через `checkTokenChatApp()`.
+            -   Использует конфигурацию из [config.js](config.js) для получения ID лицензий и типов мессенджеров.
+            -   Поддерживает отправку сообщений в WhatsApp и Telegram.
+
+        ```js
+        const result = await chatApp.sendMessageChatApp("whatsApp", {
+            phone: "+1234567890",
+            message: "Это тестовое сообщение",
+        });
+
+        if (!result.error) {
+            console.log(result.message);
+        } else {
+            console.error(result.message);
+        }
+        ```
+
+        **Пример отправки в Telegram:**
+
+        ```js
+        const result = await chatApp.sendMessageChatApp("telegram", {
+            phone: "123456789", // ID чата в Telegram
+            message: "Привет из приложения!",
+        });
+        ```
+
 ## Переменные окружения
 
 | Переменная                  | Назначение                                                    |
@@ -269,6 +475,9 @@ const { error, events } = await eventHandler.get("ONCRMDYNAMICITEMUPDATE_149");
 | `APP_B24_CLIENT_SECRET_DEV` | Client Secret для DEV окружения                               |
 | `APP_ENV`                   | Определяет окружение (`DEV` или production)                   |
 | `APP_NAME`                  | Название приложения (используется в описании задач)           |
+| `CHATAPP_EMAIL`             | Email аккаунта ChatApp                                        |
+| `CHATAPP_PASS`              | Пароль аккаунта ChatApp                                       |
+| `CHATAPP_APP_ID`            | ID приложения в ChatApp                                       |
 
 **Пример `.env`:**
 
@@ -280,6 +489,10 @@ APP_B24_CLIENT_SECRET_DEV=yyy
 APP_B24_CLIENT_ID=aaa
 APP_B24_CLIENT_SECRET=bbb
 APP_NAME=MyApp
+
+CHATAPP_EMAIL=your-email@example.com
+CHATAPP_PASS=your-password
+CHATAPP_APP_ID=your-app-id
 ```
 
 ## Скрипты

package/chatApp.js

@@ -0,0 +1,201 @@
+import { config } from "./config.js";
+import dotEnv from "dotenv";
+
+dotEnv.config();
+
+class ChatApp {
+    constructor() {
+        this.accessToken = null;
+        this.accessTokenEndTime = null;
+        this.refreshToken = null;
+        this.refreshTokenEndTime = null;
+    }
+
+    async makeTokenChatApp() {
+        try {
+            const response = await fetch("https://api.chatapp.online/v1/tokens", {
+                method: "POST",
+                headers: {
+                    Lang: "en",
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
+                },
+                body: JSON.stringify({
+                    email: process.env.CHATAPP_EMAIL,
+                    password: process.env.CHATAPP_PASS,
+                    appId: process.env.CHATAPP_APP_ID,
+                }),
+            });
+
+            const data = await response.json();
+            if (!data.success) {
+                return { error: true, message: "Не удалось получить токен ChatApp", data: data };
+            } else {
+                this.accessToken = data.data.accessToken;
+                this.accessTokenEndTime = data.data.accessTokenEndTime;
+                this.refreshToken = data.data.refreshToken;
+                this.refreshTokenEndTime = data.data.refreshTokenEndTime;
+                return { error: false };
+            }
+        } catch (error) {
+            return { error: true, message: error.message, data: null };
+        }
+    }
+
+    async refreshTokenChatApp() {
+        try {
+            const response = await fetch("https://api.chatapp.online/v1/tokens/refresh", {
+                method: "POST",
+                headers: {
+                    Lang: "en",
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
+                },
+                body: JSON.stringify({
+                    refreshToken: this.refreshToken,
+                }),
+            });
+            const data = await response.json();
+
+            if (!data.success) {
+                let resMakeToken = await this.makeTokenChatApp();
+
+                if (resMakeToken.error) {
+                    return { error: true, message: "Не удалось обновить токен ChatApp", data: data };
+                } else {
+                    return { error: false };
+                }
+            } else {
+                this.accessToken = data.accessToken;
+                this.accessTokenEndTime = data.accessTokenEndTime;
+                this.refreshToken = data.refreshToken;
+                this.refreshTokenEndTime = data.refreshTokenEndTime;
+                return { error: false };
+            }
+        } catch (error) {
+            return { error: true, message: error.message, data: null };
+        }
+    }
+
+    async checkTokenChatApp() {
+        try {
+            const response = await fetch("https://api.chatapp.online/v1/tokens/check", {
+                method: "POST",
+                headers: {
+                    Lang: "en",
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
+                },
+                body: JSON.stringify({
+                    accessToken: this.accessToken,
+                }),
+            });
+
+            const data = await response.json();
+            if (!data.success) {
+                await this.refreshTokenChatApp();
+                return { error: false, message: "Токен обновлен" };
+            } else {
+                return { error: false, message: "Токен действителен" };
+            }
+        } catch (error) {
+            return { error: true, message: error.message, data: null };
+        }
+    }
+
+    async getLicensesChatApp() {
+        try {
+            const response = await fetch("https://api.chatapp.online/v1/licenses", {
+                method: "GET",
+                headers: {
+                    Lang: "en",
+                    Accept: "application/json",
+                    Authorization: this.accessToken,
+                },
+            });
+            const data = await response.json();
+
+            if (!data.success) {
+                return { error: true, message: "Не удалось получить лицензии ChatApp", data: null };
+            } else {
+                return { error: false, message: "Лицензии успешно получены", data: data.licenses };
+            }
+        } catch (error) {
+            return { error: true, message: error.message, data: null };
+        }
+    }
+
+    async sendMessageChatApp(messangerType, messageData) {
+        // Проверяем что верно указан  messangerType и в messageData есть phone и message
+        if (!["whatsApp"].includes(messangerType) && !["telegram"].includes(messangerType)) {
+            return { error: true, message: "Неверный тип мессенджера", data: null };
+        }
+        if (!messageData.phone || !messageData.message) {
+            return { error: true, message: "Отсутствует phone или message", data: null };
+        }
+        let check = await this.checkTokenChatApp();
+        if (check.error) {
+            return { error: true, message: `Ошибка с токеном ChatApp в функции sendMessageChatApp класса ChatApp\n${check.message}`, data: null };
+        }
+        let phone = messageData.phone;
+        let message = messageData.message;
+        let url;
+        if (messangerType === "whatsApp") {
+            url = `https://api.chatapp.online/v1/licenses/${config.chatApp.type.whatsApp.licenseId}/messengers/${config.chatApp.type.whatsApp.messenger[0].type}/chats/${phone}/messages/text`;
+        }
+        if (messangerType === "telegram") {
+            url = `https://api.chatapp.online/v1/licenses/${config.chatApp.type.telegram.licenseId}/messengers/${config.chatApp.type.telegram.messenger[0].type}/chats/${phone}/messages/text`;
+        }
+        let res = await fetch(url, {
+            method: "POST",
+            headers: {
+                Lang: "en",
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                Authorization: this.accessToken,
+            },
+            body: JSON.stringify({
+                text: message,
+            }),
+        });
+        let data = await res.json();
+        if (!data.success) {
+            return { error: true, message: `Ошибка при отправке сообщения в ChatApp через ${messangerType}`, data: null };
+        } else {
+            return { error: false, message: `Сообщение успешно отправлено в ChatApp через ${messangerType}`, data: null };
+        }
+    }
+
+    async phoneCheckChatApp(messangerType, phone) {
+        if (!["whatsApp"].includes(messangerType) && !["telegram"].includes(messangerType)) {
+            return { error: true, message: "Неверный тип мессенджера", data: null };
+        }
+        let check = await this.checkTokenChatApp();
+        if (check.error) {
+            return { error: true, message: `Ошибка с токеном ChatApp в функции phoneCheckChatApp класса ChatApp\n${check.message}`, data: null };
+        }
+        let url;
+        if (messangerType === "whatsApp") {
+            url = `https://api.chatapp.online/v1/licenses/${config.chatApp.type.whatsApp.licenseId}/messengers/${config.chatApp.type.whatsApp.messenger[0].type}/chats/${phone}/check`;
+        }
+        if (messangerType === "telegram") {
+            url = `https://api.chatapp.online/v1/licenses/${config.chatApp.type.telegram.licenseId}/messengers/${config.chatApp.type.telegram.messenger[0].type}/chats/${phone}/check`;
+        }
+        let res = await fetch(url, {
+            method: "GET",
+            headers: {
+                Lang: "en",
+                Accept: "application/json",
+                Authorization: this.accessToken,
+            },
+        });
+        let data = await res.json();
+        if (!data.success) {
+            return { error: true, message: `Ошибка при проверке телефона в ChatApp через ${messangerType}`, data: null };
+        } else {
+            return { error: false, message: `Телефон успешно проверен в ChatApp через ${messangerType}`, data: data };
+        }
+    }
+}
+
+export const chatApp = new ChatApp();

package/config.js

@@ -0,0 +1,19 @@
+export const config = {
+    chatApp: {
+        // Получаем из класса ChatApp().getLicensesChatApp и статично сохраняем в конфиге тут
+        type: {
+            whatsApp: {
+                licenseId: 15779,
+                licenseTo: 1765027066,
+                licenseName: "*5787",
+                messenger: [{ type: "grWhatsApp", name: "[WEB] WhatsApp" }],
+            },
+            telegram: {
+                licenseId: 17530,
+                licenseTo: 1765552526,
+                licenseName: "*6980 telegram",
+                messenger: [{ type: "telegram", name: "Telegram Personal" }],
+            },
+        },
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@andrey4emk/npm-app-back-b24",
-    "version": "0.3.3",
+    "version": "0.3.6",
     "description": "Bitrix24 OAuth helpers for Node.js projects",
     "main": "index.js",
     "type": "module",
@@ -22,7 +22,9 @@
     "files": [
         "index.js",
         "b24.js",
-        "eventGet.js"
+        "eventGet.js",
+        "chatApp.js",
+        "config.js"
     ],
     "dependencies": {
         "@bitrix24/b24jssdk": "^0.5.1",