الربط المباشر بين منصة Whats360 ومنظومة n8n يتيح للمطورين وأصحاب المشاريع إلغاء التعقيد البرمجي لطلبات HTTP اليدوية، والاستفادة من واجهات رسائل تفاعلية، واستقبال فوري للرسائل عبر الويب هوك، وتشغيل وكلاء الذكاء الاصطناعي كأدوات مستقلة تتحدث مع العملاء وتنفذ العمليات لحظياً.

الهيكل المعتمد للملفات في بيئة TypeScript

يتبع المشروع معايير n8n الصارمة للأداء وقابلية الصيانة والتوسع السريع:

• credentials/Whats360Api.credentials.ts: إدارة المفاتيح وتشفيرها واختبار الاتصال التلقائي بالخادم.
• nodes/Whats360/Whats360.node.ts: المنطق التنفيذي لكافة العمليات الصادرة وربطها مع منظومة الأدوات الذكية.
• nodes/Whats360/GenericFunctions.ts: الطبقة الوسيطة لإجراء طلبات الشبكة، ومعالجة أخطاء المنصة، وتنظيف مدخلات الهواتف.
• nodes/Whats360/descriptions/: تقسيم واجهات الإدخال حسب الموارد (رسائل، أجهزة، حملات) لتحسين قراءة الكود.
• nodes/Whats360Trigger/Whats360Trigger.node.ts: الاستماع اللحظي إلى الأحداث والرسائل الواردة والتحقق من التوقيع الأمني.

// credentials/Whats360Api.credentials.ts
import { ICredentialType, INodeProperties, IAuthenticateGeneric, ICredentialTestRequest } from ‘n8n-workflow’;

export class Whats360Api implements ICredentialType {
  name = ‘whats360Api’;
  displayName = ‘Whats360 API’;
  documentationUrl = ‘https://whats360.live’;
  properties: INodeProperties[] = [
    {
      displayName: ‘Base URL’,
      name: ‘baseUrl’,
      type: ‘string’,
      default: ‘https://whats360.live’,
      required: true,
    },
    {
      displayName: ‘API Token’,
      name: ‘token’,
      type: ‘string’,
      typeOptions: { password: true },
      default: ”,
      required: true,
    },
  ];
  authenticate: IAuthenticateGeneric = {
    type: ‘generic’,
    properties: { qs: { token: ‘={{$credentials.token}}’ } },
  };
  test: ICredentialTestRequest = {
    request: {
      baseURL: ‘={{$credentials.baseUrl}}’,
      url: ‘/api/v1/instances’,
      method: ‘GET’,
    },
  };
}

تنبيه أمني هام:

لا تقم أبداً بكتابة التوكن كقيمة نصية صريحة داخل عقدة Code أو HTTP Request عامة. استخدام ملف الاعتمادات المخصص يضمن تشفير القيمة عبر مفتاح التشفير الرئيسي الخاص بـ n8n ويحجبها تماماً من سجلات التشغيل والتصدير.

// nodes/Whats360/Whats360.node.ts (مقتطف تنفيذي)
import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from ‘n8n-workflow’;
import { whats360ApiRequest, formatToJid } from ‘./GenericFunctions’;

export class Whats360 implements INodeType {
  description: INodeTypeDescription = {
    displayName: ‘Whats360’,
    name: ‘whats360’,
    icon: ‘file:whats360.svg’,
    group: [‘transform’],
    version: 1,
    usableAsTool: true,
    properties: [ /* معرفات الحقول والعمليات */ ],
  };

  async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
    const items = this.getInputData();
    const returnData: INodeExecutionData[] = [];
    for (let i = 0; i < items.length; i++) {
      try {
        const resource = this.getNodeParameter(‘resource’, i) as string;
        const operation = this.getNodeParameter(‘operation’, i) as string;
        const instanceId = this.getNodeParameter(‘instanceId’, i) as string;
        const jid = formatToJid(this.getNodeParameter(‘jid’, i) as string);

        if (resource === ‘message’ && operation === ‘sendText’) {
          const msg = this.getNodeParameter(‘message’, i) as string;
          const response = await whats360ApiRequest.call(this, ‘GET’, ‘/api/v1/send-text’, {}, {
            instance_id: instanceId,
            jid: jid,
            msg: msg,
          });
          returnData.push({ json: response, pairedItem: { item: i } });
        }
      } catch (error) {
        if (this.continueOnFail()) {
          returnData.push({ json: { error: (error as Error).message }, pairedItem: { item: i } });
          continue;
        }
        throw error;
      }
    }
    return [returnData];
  }
}

هيكل عمل سيناريو خدمة العملاء الذكي