بدء سريع · Node.js
إرسال أول رسالة واتساب من Node.js
طريقتان: مكتبة wasaas الرسمية على npm، أو fetch خام إن لم تُرد أي اعتمادية إضافية. كلاهما يصل إلى نفس واجهة REST API.
الطريقة الأولى: مكتبة wasaas
bash
npm install wasaasNo runtime dependencies. تأتي بأنواع TypeScript جاهزة. بعد التثبيت، أرسل الرسالة:
javascript
import { Wasaas } from "wasaas";
const client = new Wasaas({ apiKey: process.env.WASAAS_API_KEY });
const res = await client.messages.sendText({
sessionId: "customer-5-1",
to: "966501234567",
message: "مرحبًا من Wasaas 👋",
});
console.log(res);
// { success: true, to: "966501234567", status: "sent" }الطريقة الثانية: fetch خام (بدون أي اعتمادية)
نفس الطلب بـ fetch المدمجة في Node.js (الإصدار 18 فأعلى)، بدون تثبيت أي شيء:
javascript
const res = await fetch("https://wasaas.org/api/v1/messages", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.WASAAS_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
session_id: "customer-5-1",
to: "966501234567",
message: "مرحبًا من Wasaas 👋",
}),
});
const data = await res.json();
// { success: true, to: "966501234567", status: "sent" }إن فشل الطلب
المكتبة ترمي WasaasAPIError بخاصية status. طريق fetch الخام يقرأ نفس الرمز من res.status مباشرة. أهم الرموز: 401 مفتاح غير صالح · 404 الجلسة غير موجودة · 429 تجاوز الحصة الشهرية.
حدود حقيقية
هذا ربط غير رسمي ومبني على الجلسات عبر رمز QR، وليس منصة واتساب الرسمية لمنتجات الأعمال. أنواع الرسائل المدعومة هي النص والصورة والمستند فقط، ولا يوجد حاليًا إرسال أحداث (webhooks) إلى سيرفرك الخاص.
إلى أين تذهب بعد ذلك
- دليل Node.js الكامل — الصور والمستندات والجلسات والتحقق من الأرقام
- الحصول على مفتاح API — إن لم ينشئ المفتاح بعد
- توثيق REST API (بالإنجليزية) — كل نقطة نهاية وحقل تستدعيه المكتبة
- أسعار واجهة API للواتساب — حدود الرسائل لكل باقة