Senden API
الرئيسيةوثائق API لـWhatsApp وTelegram وMAX

للمطورين والذكاء الاصطناعي

ابدأ بطلب واحد.

HTTP API موحّد للحسابات العادية في WhatsApp وTelegram وMAX. تصف الوثائق العامة العقد؛ ولا تتاح قائمة حساباتك إلا باستخدام مفتاحك.

تنزيل حزمة ZIP ↓OpenAPI JSON

1. أنشئ حسابًا واتصالًا

سجّل باستخدام بريدك الإلكتروني وأكّد العنوان عبر الرسالة ثم ادخل إلى لوحة التحكّم. اختر خدمة المراسلة وأكمل طريقة الدخول المتاحة عبر رمز QR أو رقم الهاتف. يتطلب Telegram بيانات application API credentials الخاصة بك. تظهر خطوات الدخول الإضافية المحتملة في لوحة التحكّم.

2. أنشئ مفتاح API

في «الملف الشخصي ← مفاتيح API»، أنشئ مفتاحًا مستقلًا للمشروع. تُمنح صلاحية القراءة افتراضيًا؛ ويلزم إذن write للإرسال والتغييرات الأخرى. تظهر القيمة مرة واحدة. احفظها ضمن أسرار backend، وليس في المتصفح أو Git أو مطالبة الذكاء الاصطناعي.

3. احصل على الاتصالات والدليل الكامل

curl 'https://api-senden.ru/api/v1/integrations/manifest' \
  --header 'Authorization: Bearer YOUR_API_KEY'

تتضمن الاستجابة instances, connectedMessengers, commands و permissions. تخص الاتصالات مساحتك فقط، وتُستبعد المؤرشفة صراحةً. للإرسال، اختر حسابًا بحالة state: connected.

4. اختر محادثة وأرسل وتحقّق من النتيجة

احصل على معرّفات المحادثات الفعلية عبر GET /api/v1/instances/{id}/chats. يتم إرسال النص والملف عبر POST /api/v1/instances/{id}/messages باستخدام قيمة ثابتة واحدة من Idempotency-Key. تعني استجابة 202 الإضافة إلى قائمة الانتظار، وليس التسليم. تتاح الحالات والرسائل الواردة عبر السجل وSSE وwebhook وقائمة انتظار الإشعارات. راجع إمكانات وسيلة الاتصال المحددة أدناه.

في MAX، تتضمن نتيجة contacts.lookup حاليًا معرّف المستخدم، ولا يجوز اعتباره تلقائيًا معرّف محادثة خاصة. استخدم المعرّف من قائمة المحادثات لتحديد المستلم. لا تُعد إرسال الرسالة بمفتاح جديد إذا كانت نتيجة الإرسال الأول غير معروفة.

الأحداث وأمان webhook

عند استخدام webhook، تحقّق من توقيع HMAC وعالج الأحداث بحيث لا تتكرر آثارها عند الإعادة. يجب أن تكون نقطة الاستقبال عنوان HTTPS عامًا؛ وتُحظر الشبكات المحلية والخاصة. يُستخدم SSE لتدفق الأحداث؛ ويؤدي استلام إشعار من القائمة إلى إنشاء lease ويتطلب صلاحية write، ثم يُؤكّد عبر ack. تتوفر المعلمات وصيغ الطلبات الكاملة في OpenAPI.

مواد جاهزة

دون مفاتيح أو رموز QR أو جلسات أو بيانات مستخدمين. لا ينفّذ تشغيل العملاء سوى طلب discovery.

openapi.jsonتنزيل ↓postman.collection.jsonتنزيل ↓senden-node.mjsتنزيل ↓senden-python.pyتنزيل ↓quickstart.httpتنزيل ↓llms.txtتنزيل ↓ai-context.jsonتنزيل ↓README.txtتنزيل ↓.env.exampleتنزيل ↓

الدليل الكامل: 70 أمر HTTP

هذا هو دليل API العام؛ ويُبيّن دعم كل أمر أصلي وحاجته إلى اتصال نشط على حدة. يحتوي دليل /methods على الجزء الأصلي فقط.

أوامر Senden API العامة وأوامر Bearer
الدالة والمسارالغرضالدعمالصلاحيات
GET/api/v1/healthفحص العمليةwhatsapp, telegram, maxread
GET/api/v1/statusالاتصالات وحالاتهاwhatsapp, telegram, maxread
POST/api/v1/instancesإنشاء اتصالwhatsapp, telegram, maxwrite
GET/api/v1/instancesالحصول على الاتصالات النشطة أو المؤرشفةwhatsapp, telegram, maxread
DELETE/api/v1/instances/{id}إيقاف الاتصال وأرشفته مع حفظ السجل والجلسةwhatsapp, telegram, maxwrite
PATCH/api/v1/instances/{id}تغيير اسم الاتصالwhatsapp, telegram, maxwrite
GET/api/v1/instances/{id}حالة الاتصالwhatsapp, telegram, maxread
POST/api/v1/instances/{id}/restoreاستعادة الاتصال من الأرشيف ضمن الحدود، دون الاتصال تلقائيًاwhatsapp, telegram, maxwrite
POST/api/v1/instances/{id}/connectبدء تسجيل الدخولwhatsapp, telegram, maxwrite
POST/api/v1/instances/{id}/authمتابعة خطوة تسجيل الدخول الحاليةwhatsapp, telegram, maxwrite
POST/api/v1/instances/{id}/stopالإيقاف مع حفظ الجلسةwhatsapp, telegram, maxwrite
POST/api/v1/instances/{id}/logoutطلب تسجيل الخروجwhatsapp, telegram, maxwrite
GET/api/v1/instances/{id}/chatsالحصول على المحادثاتwhatsapp, telegram, maxيتطلب اتصالًاread
GET/api/v1/instances/{id}/messagesسجل الرسائل المحفوظwhatsapp, telegram, maxread
POST/api/v1/instances/{id}/messagesإضافة نص أو ملف إلى قائمة الانتظارwhatsapp, telegram, maxwriteIdempotency-Key
POST/api/v1/instances/{id}/messages/from-urlتحميل ملف HTTPS بأمان وإضافة المستند إلى قائمة الانتظارwhatsapp, telegram, maxwriteIdempotency-Key
GET/api/v1/instances/{id}/settingsإعدادات الاتصال والأحداثwhatsapp, telegram, maxread
PUT/api/v1/instances/{id}/settingsتغيير الإعداداتwhatsapp, telegram, maxwrite
GET/api/v1/instances/{id}/queueقائمة انتظار رسائل دائمةwhatsapp, telegram, maxread
POST/api/v1/instances/{id}/queue/clearإلغاء كل الرسائل بحالة queuedwhatsapp, telegram, maxwrite
POST/api/v1/instances/{id}/queue/{messageId}/cancelإلغاء رسالة واحدة بحالة queuedwhatsapp, telegram, maxwrite
POST/api/v1/instances/{id}/queue/{messageId}/retryإعادة المحاولة لخطأ مؤكّد بحالة failed فقطwhatsapp, telegram, maxwrite
GET/api/v1/instances/{id}/notifications/statsعدد الإشعارات المنتظرة والمعالجةwhatsapp, telegram, maxread
POST/api/v1/instances/{id}/notifications/receiveاستلام إشعار مع حجز مؤقت وانتظارwhatsapp, telegram, maxwrite
DELETE/api/v1/instances/{id}/notifications/{receiptId}تأكيد المعالجة باستخدام معرّف الاستلام الحاليwhatsapp, telegram, maxwrite
GET/api/v1/instances/{id}/deliveriesنتائج تسليم webhookwhatsapp, telegram, maxread
GET/api/v1/instances/{id}/deliveries/statsعدادات مهام webhookwhatsapp, telegram, maxread
POST/api/v1/instances/{id}/deliveries/clearإلغاء مهام webhook المنتظرة والمعاد محاولة تسليمها ومهام dead-letterwhatsapp, telegram, maxwrite
GET/api/v1/instances/{id}/deliveries/{jobId}/attemptsسجل محاولات webhookwhatsapp, telegram, maxread
POST/api/v1/instances/{id}/deliveries/{jobId}/retryإعادة محاولة تسليم webhook من dead-letterwhatsapp, telegram, maxwrite
GET/api/v1/eventsالأحداث باستخدام مؤشرwhatsapp, telegram, maxread
GET/api/v1/streamتدفق أحداث SSEwhatsapp, telegram, maxread
POST/api/v1/filesرفع ملف بحجم لا يتجاوز 20 ميغابايتwhatsapp, telegram, maxwrite
GET/api/v1/files/{fileId}تنزيل ملف محلي سبق رفعهwhatsapp, telegram, maxread
PUT/api/v1/configإعدادات التطبيق واتصالات الشبكةwhatsapp, telegram, maxwrite
GET/api/v1/methodsدليل العمليات المتاحةwhatsapp, telegram, maxread
GET/api/v1/integrations/manifestاتصالات المساحة الحالية والأوامر وملفات التكامل الجاهزة، دون المفاتيح وبيانات تسجيل الدخولwhatsapp, telegram, maxread
GET/api/v1/integrations/files/{name}تنزيل قالب تكامل أو أرشيف ZIP عام دون بيانات شخصيةwhatsapp, telegram, maxread
POST/api/v1/instances/{id}/operations/account.settings.getالملف الشخصي للحساب المتصلwhatsapp, telegram, maxيتطلب اتصالًاread
POST/api/v1/instances/{id}/operations/contacts.listقائمة جهات الاتصالwhatsapp, telegram, maxيتطلب اتصالًاread
POST/api/v1/instances/{id}/operations/contacts.getمعلومات جهة الاتصالwhatsapp, telegram, maxيتطلب اتصالًاread
POST/api/v1/instances/{id}/operations/contacts.lookupالتحقق من وجود حساب برقم الهاتف أو المعرّفwhatsapp, telegram, maxيتطلب اتصالًاread
POST/api/v1/instances/{id}/operations/contacts.createإضافة جهة اتصالtelegram, maxيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/contacts.updateتعديل جهة اتصالtelegramيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/contacts.deleteحذف جهة اتصالtelegram, maxيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/profile.avatar.getالحصول على الصورة الشخصيةwhatsappيتطلب اتصالًاread
POST/api/v1/instances/{id}/operations/messages.historyتحميل السجل من خدمة المراسلةtelegram, maxيتطلب اتصالًاread
POST/api/v1/instances/{id}/operations/messages.getالحصول على رسالة من خدمة المراسلةtelegram, maxيتطلب اتصالًاread
POST/api/v1/instances/{id}/operations/messages.readوضع علامة مقروءة على الرسائلwhatsapp, telegram, maxيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/messages.deleteحذف رسالةwhatsapp, telegram, maxيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/messages.editتعديل نص رسالةwhatsapp, telegram, maxيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/messages.forwardإعادة توجيه الرسائل المحددةwhatsapp, telegram, maxيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/messages.reactتغيير التفاعل مع رسالةwhatsapp, telegram, maxيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/messages.contactإرسال بطاقة جهة اتصالwhatsapp, telegramيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/messages.locationإرسال الموقعwhatsapp, telegramيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/messages.pollإرسال استطلاعwhatsapp, telegramيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/chats.typingإظهار مؤشر الكتابةwhatsapp, telegramيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/chats.archiveأرشفة محادثةwhatsapp, telegramيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/chats.unarchiveاستعادة محادثة من الأرشيفwhatsapp, telegramيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/chats.expirationإعداد الرسائل ذاتية الاختفاءwhatsapp, telegramيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/chats.reactionsالحصول على التفاعلات المتاحةtelegramيتطلب اتصالًاread
POST/api/v1/instances/{id}/operations/groups.getمعلومات المجموعةwhatsapp, telegram, maxيتطلب اتصالًاread
POST/api/v1/instances/{id}/operations/groups.createإنشاء مجموعةwhatsapp, telegram, maxيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/groups.renameتغيير اسم المجموعةwhatsapp, telegramيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/groups.members.addإضافة عضوwhatsapp, telegram, maxيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/groups.members.removeإزالة عضوwhatsapp, telegram, maxيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/groups.admins.addتعيين مسؤول للمجموعةwhatsappيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/groups.admins.removeإلغاء صلاحية مسؤول المجموعةwhatsappيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/groups.leaveمغادرة المجموعةwhatsapp, telegram, maxيتطلب اتصالًاwriteIdempotency-Key
POST/api/v1/instances/{id}/operations/groups.settingsتغيير إذن واحد للمجموعةwhatsappيتطلب اتصالًاwriteIdempotency-Key

من الفكرة إلى التكامل

اربط حسابك الأول

أنشئ حسابًا وأكّد بريدك الإلكتروني وابدأ بطلب قائمة الاتصالات.

إنشاء حساب ↗إلى لوحة التحكّم