تُرسل رسائل SMS من هاتفك المحمول الخاص.اكتشف كيف يعمل
المنصةAPI-first structureأجهزة آمنةإبراز التنفيذمراقبة الترايينات المتعددةالوثائق المغلقة
مركز المطورين/واجهة برمجة تطبيقات WhatsApp

WA · 9 عمليات موثّقة

WhatsApp API

إرسال رسائل ووسائط الإعلام من طراز WhatsApp، وفشلات الاستعادة، والتحقق من أعداد المستفيدين، وتلقي رسائل مأمونة بعد طلب صريح للتزامن.

هواتف متصلة تتزامن المحادثات ووسائط الإعلام
قاعدة RESThttps://api.smsmobileapi.com

JSON responses ; HTTPS required − UTF-8

إربط مفتاحك

اتصل مرة، ثم اختبار نقاط النهاية عبر SMS، المكالمات، الإخطارات،WhatsAppوالبريد الإلكتروني.

ابدأ هنا

طلبك الأول في أربع خطوات

1

الاتصال والتمكينWhatsAppمن أجل مُتنقل مُدعم.

2

تأكد من أن المستلم لديه نقطة النهاية

3

أرسل مع (واني)

4

لاسترجاع الرسائل: جمع التعبئة، الاتصال/الغوا/التزامن/، انتظارا للتعافي، ثم الاتصال/الغيتا.

تلقي رسائل إلزامية قبل استرجاعها

الطلبWhatsAppتزامن أولا.

قبل أن تتصل/getwaتم تلقيهWhatsAppرسائل، يجب أن تطلبي نافذة متزامنة من خلالhttps://api.smsmobileapi.com/getwa/synchronisation/. وهذه الخطوة الصريحة مطلوبة لضمان الأذن بالتبادل بين WhatsApp و SMSMobileAPI. انتظروا التعافي، ثم اتصلوا/getwa.

إفتح نقطة النهاية المتزامنة المطلوبة
تطبيق الجوال SMSMobileAPI الآمن الذي يربط الهاتف بلوحة تحكم الويب وREST API لعمليات الرسائل القصيرة والمكالمات
اتصال مشفر من الهاتف المحمول إلى النظام الأساسي

تطبيق الهاتف المحمول الرسمي

الجسر الآمن بين هاتفك ولوحة المعلومات وواجهة برمجة التطبيقات.

تمر عمليات الرسائل القصيرة والمكالمات عبر تطبيق SMSMobileAPI الرسمي المثبت على هاتفك المتصل. يقوم التطبيق بإقران الجهاز بحسابك بشكل آمن، ومزامنة الأحداث المصرح بها، وربط شبكة الجوال بلوحة التحكم وواجهة برمجة التطبيقات REST.

1تطبيق الجوالإقران الهاتف وشريحة SIM الخاصة به 2رابط مشفريصادق البيانات ويحميها في العبور 3لوحة التحكم وواجهة برمجة التطبيقاتتتحكم في سير العمل والنشاط
  • الإصدارات الموقعة الموزعة من خلال قوائم Google Play وApple App Store الرسمية
  • عناصر التحكم في المراجعة والتوقيع والتوزيع لنظامي Google وApple الأساسيين
  • إقران آمن للجهاز، ونقل HTTPS، والوصول إلى واجهة برمجة التطبيقات المصادق عليها
  • فقط الأذونات المطلوبة لميزات الهاتف المحمول التي تقوم بتمكينها
احصل على تطبيق SMSMobileAPI الرسمي على Google Play تحميل التطبيق الرسمي للزجاجة SMSMobileAPI على جهاز التفريغ App Store
تعتمد الإمكانيات على الأذونات والوصول إلى الخلفية التي يسمح بها Android أو iOS.

WEBHOOK V2 لواجهة API هذه

اشترك فقط في أحداث الأجهزة المحمولة التي يحتاجها سير عملك.

5 نوعًا من الأحداث

يمكن لوجهة واحدة استقبال كل شيء، أو يمكنك فصل أنظمة الإنتاج والتحليلات والتنبيهات التشغيلية. كل حدث له اسم دقيق حتى يتعامل تطبيقك معه بشكل متوقّع.

whatsapp.submitted

تم تقديم WhatsApp.

تم إنشاء مهمة لإرسال WhatsApp.

whatsapp.sent

WhatsApp تم إرساله.

بيئة WhatsApp المتصلة أكدت أن الرسالة أُرسلت.

whatsapp.failed

WhatsApp فشل.

عملية إرسال WhatsApp فشلت.

whatsapp.received

WhatsApp تم استلامه.

تم استرجاع رسالة WhatsApp بعد أن طلب الحساب المزامنة.

whatsapp.voice.transcribed

تم تحويل الرسالة الصوتية إلى نص.

تم تحويل رسالة WhatsApp الصوتية المؤهلة التي تم استرجاعها إلى نص قابل للاستخدام.

المصادقة

حافظ على أوراق اعتمادك على خادمك

استخدموا (أبيكي) للتكامل المباشر وتتوفر وثائق تفويض العملاء من طراز OAuth2 للطلبات المقدمة من جانب الخادم؛ وطلب رمزا وإرساله كإذن: Bearer ACCESS TOKEN.

إدارة التاريخ

تاريخ واضح بأمان: استعراض أولي، حذف، متابعة التقدم

هذه النقط النهائية تُوضّح تاريخ الخادم المختار لك API مفتاح، وليس رسائل على الهواتف أو الخدمات الخارجية. ولا توفر هذه البلدان فترة من الحساب. النشاط الجديد يمكن أن يظهر بعد الإنزال

اقرأ request_id دليل إعادة التأهيل
حماية التكامل

وبحسب التخلف، تظل السجلات المرتبطة أو المعالجة مرئية. فقط استخدام include_linked=1 إذا قبلت أن الإدماج أو التجهيزات الجارية قد تتوقف عن العمل

كيف request_id الأشغال

  1. تمهيد العد action=previewلا request_id ويلزم عدم حذف أي سجلات.
  2. جيل فريد request_id لحذف جديد، على سبيل المثال UUIDأنقذه قبل إرساله action=delete-
  3. للمراكز أو الإجازات أو HTTP 202، إعادة استخدام نفس API مفتاح، نقطة نهاية التاريخ، request_id و include_linked قيمة لا تولد هوية جديدة تلقائياً بعد خطأ
  4. عندما completed=trueلقد انتهت العملية ويعود استخدام بطاقة هويتها بنفس النتيجة بدلا من حذف السجلات التي وصلت حديثا. استخدم هوية جديدة فقط لتنظيف جديد متعمد

request_id يحدد عملية حذفك، وليس فرد SMSالشكل المسموح به: ١٦-١٢٨ ASCII رسائل، أرقام، فيتامينات أو تأكيدات ألف UUID مُولّد بالبريدوتو..

يُنفذ الحذف على دفعات. إذا كانت الاستجابة HTTP 202 ومعها continue_required=true، فأعد طلب action=delete بعد 3 ثوانٍ. لا تعمل مهمة cron في الخلفية. يقرأ action=status التقدم فقط ولا يتابع الحذف، حتى لو كانت الاستجابة HTTP 200.

أمثلة للحذف والوضع

يستعاض عن العينة request_id مع قيمتك الفريدة قبل أن تبدأ وتُغيّر الطلبات الواردة أدناه تاريخ الحساب الحقيقي؛ وهي ليست استعراضات مسبقة.

POST · API المفتاح
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
POST ; OAuth2
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
GET :: الوضع
curl -G "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

GET أيضاً تقبل action=preview أو action=delete- POST يوصى بما يلي: يمكن أن تتسرب البارامترات الأوروبية إلى تاريخ المروج وسجلات الخواديم. لا تضع أبداً انحرافاً في حلقة عامة أو صورة أو مفترقة

للاستعداد POSTأرسل كل المعالم في هيئة أو JSON اعترض، لا يوجد في سلسلة الاستفسارات وتُرفض المعايير غير المعروفة؛ ولا تدعم المواصفات المتحركة أو المرشّحات.

التوثيق بالنسبة لنقاط نهاية التاريخ

الاستخدام apikey أو Authorization: Bearer منفذ SMSMobileAPI OAuth2لا ترسلوا مركباً جديداً أو API مفتاح كـ Bearer مُتَحدّد. تم رفض المكسورين المفصولين

عندما يتم تحديد النطاقات history:read يسمح بالفحص الأولي/الوضع history:delete كما يسمح بالحذف. القيود المفروضة على كل من المكسورين OAuth زبونة تتقدم وتحتفظ المكسورات غير المزودة بنطاقات بالحسابات الموجودة.

OAuth2 يختارون المُصدر الفريد API مفتاح إذا كان هناك عدة مفاتيح رئيسية، تقدم أيضاً apikey لاختيار واحد من ممتلكات الحساب. مفاتيح الثانوية لا تسمح أبداً بالدخول إلى التاريخ الرئيسي

اقرأ الرد قبل مواصلة

count_delete هو العدد التراكمي الذي أزالته هذه العملية. selected_at_start (أ) الاختيار الأولي؛ protected_at_start يحسب السجلات المستبعدة. الاستخدام preview.linked_or_processing حتى عندما يُحسب include_linked=1-

JSON ; HTTP 202
{
    "result": {
        "error": 0,
        "history": "whatsapp-sent",
        "action": "delete",
        "request_id": "6d54ac58-41f1-4fbc-9a39-6e6c86089451",
        "status": "processing",
        "completed": false,
        "count_delete": 100,
        "total_before": 250,
        "selected_at_start": 200,
        "protected_at_start": 50,
        "include_linked": 0,
        "continue_required": true,
        "message": "Repeat GET or POST with the same request_id and include_linked to continue. Status requests do not run deletion."
    }
}
  • 200 مع completed=true: أنهيت ولا يثبت أن هناك 200 من الردود المسبقة أو الحالة لا تكتمل وحدها.
  • 400 INVALID_REQUEST_ID: تحقق من الشكل 404 REQUEST_NOT_FOUNDلا توجد عملية لهذا الهوية API مفتاح وتاريخ
  • 401: وثائق تفويض غير صحيحة أو منتهية الصلاحية. 403: عدم كفاية نطاق OAuth أو حساب غير مأذون به.
  • 409 HISTORY_BUSY: تطهير آخر يجري؛ مواصلة تشغيله من العميل الأصلي. 409 INCLUDE_LINKED_CONFLICT: اعيدوا الأصل include_linked قيمة
  • 409 OAUTH_ACCOUNT_AMBIGUOUS: توفير API مفتاح هذا الحساب
  • 503 أو انقطاع الشبكات: قد تكتمل بالفعل بعض الخفافيش. التكوين الشيكى، ثم العودة مع الأصلي request_id- لا تخلق عملية بديلة تلقائيا.
POST ; GET

أرسلWhatsAppرسالة

#
نهاية الفقرةhttps://api.smsmobileapi.com/sendsms

يرسل نصاً من طراز WhatsApp أو يدعم وسائط الإعلام من خلال البيئة المرتبطة بها.

متى تستخدمه

استخدمه لفرادى المتلقين أو لفريق اتصال من أجهزة المتابعة

حدود

الاسميكتبالاحتياجاتوصف
apikey خيط مطلوب مفتاحك (زكى 8ك زى) و قم بحذفه من استخدام مركب بيرة
recipients الهاتف مطلوب رمز البلد زائداً رقم، بدون + أو 00.
message خيط مطلوب هيئة النصوص؛ وهناك خطوط متعددة مدعومة.
waonly نعم مطلوب يجب أن يكون نعم الطلبWhatsApp-فقط توصيل
url_media تدق العجلات الاختياري Public PDF, document, archive or JPG/PNG URL.
url_media_shorted نعم الاختياري Use a shortened download URL with PDF preview mode.
pdf_with_image نعم الاختياري أضف صورة من أجل قوات الدفاع الشعبي
encrypt_message نعم الاختياري يتطلب تطهير جانبي من جانب المتلقي
contactGroup (غويد) الاختياري أرسل كل إتصال في مجموعة من أجهزة الإرسال

مثال

حليقة
curl -X POST "https://api.smsmobileapi.com/sendsms?waonly=yes" \
  -d "apikey=YOUR_API_KEY" \
  -d "recipients=191728660" \
  --data-urlencode "message=Your order is ready."

مثال على الإجابة

JSON
{
  "result": {
    "error": 0,
    "sent": "1",
    "id": "MESSAGE_GUID",
    "send_with_whatsapp": "1"
  }
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل
من الجيد معرفة
  • ويجب أن تكون وسائل الإعلام المدعومة موارد عامة من طراز HTTPS.
  • WhatsApp formatting: *bold*, italic , ~strikethrough~ and triple-backtick monospace.
POST ; GET

يُستاء من أيّ موافقةWhatsAppرسالة

#
نهاية الفقرةhttps://api.smsmobileapi.com/resendwa/

Retries a WhatsApp message that currently has an mistake status.

متى تستخدمه

استخدمه بعد تشخيص فشلWhatsAppدخول سجل.

حدود

الاسميكتبالاحتياجاتوصف
apikey خيط مطلوب مفتاح API الخاص بك.
guid خيط مطلوب رجل الرسالة الفاشلة

مثال

حليقة
curl "https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID"

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل
من الجيد معرفة
  • ولا يحق سوى للرسائل الفاشلة أن تُعادل.
يحصل

تنشيط عمليات الاسترجاع

#
نهاية الفقرةhttps://api.smsmobileapi.com/getwa/active/

نشط أو عطّل أو ضحكات من طراز WhatsApp

متى تستخدمه

ننشط في جمع البيانات أولاً ثم، قبل إسترجاع الرسائل، يجب أن تطلبي تزامناً من خلال / نباتي/التزامن/.

حدود

الاسميكتبالاحتياجاتوصف
apikey خيط مطلوب مفتاح API الخاص بك.
statut | 1 | x الاختياري 1 Acts, 0 deactivates, x or omission toggles the current state.

مثال

حليقة
curl "https://api.smsmobileapi.com/getwa/active/?apikey=YOUR_API_KEY&statut=1"

مثال على الإجابة

JSON
{
  "success": true,
  "read_message_active": 1,
  "status_note": "Activated"
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل
من الجيد معرفة
  • وتوقفت عملية الاسترجاع في الحدود بسبب عدم التمكن من الخصوصية.
  • ولا يسترد النشاط وحده الرسائل: فلا يزال طلب التزامن إلزاميا قبل استخدام/الغيتا في الأنشطة التي تم تلقيها حديثا.
يحصل

طلب التزامن من جانب WhatsApp

#
نهاية الفقرةhttps://api.smsmobileapi.com/getwa/synchronisation/

Mandatory security step before retrieving received WhatsApp messages. It opens a time-limited synchronization window.

متى تستخدمه

يجب أن تنادي هذه النقطة قبل أن تهدأ عندما تحتاجSMSMobileAPIلفحصWhatsAppمن أجل رسائل حديثة التلقّي انتظروا التعافي، ثم اتصلوا بي

حدود

الاسميكتبالاحتياجاتوصف
apikey خيط مطلوب مفتاح API الخاص بك.

مثال

حليقة
curl "https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY"

مثال على الإجابة

JSON
{
  "error": "0",
  "messages": "synchronized",
  "expire_at": "2026-03-11 12:27:00",
  "expire_at_unix": "1773232020"
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل
من الجيد معرفة
  • التتزامن هو لتلقى الرسائل فقط. لا تتصلي به قبل إرساله
  • وتنتهي عملية العودة إلى الرد في / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / أطلب نافذة متزامنة أخرى عندما تحتاج إلى جمع رسائل جديدة
  • ويُلزم طلب التزامن لحماية التبادل بين WhatsApp و SMSMobileAPI.
يحصل

Retrieve WhatsApp

#
نهاية الفقرةhttps://api.smsmobileapi.com/getwa

Returns received WhatsApp messages that were recovered during a requested synchronization window.

متى تستخدمه

شرط مسبق إلزامي: تفعيل عملية الاسترجاع في مواقع محددة، الاتصال: https://api.smsmobileapi.com/getwa/synchronisation/ first, wait for recovery, then call this endpoint. لا تبدأ (غيتوا) نفسها في التزامنة

حدود

الاسميكتبالاحتياجاتوصف
apikey خيط مطلوب مفتاح API الخاص بك.
before مصباح واحد الاختياري سجلات العودة قبل هذا العصر.
date YYYY-MMM-DD الاختياري سجلات العودة لموعد واحد
message_type النص السمعي الاختياري رسائل نصية أو رسائل صوتية تحولت إلى نص؛ غفل عن كل من الرسائل.

مثال

حليقة
curl "https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY&message_type=text"

مثال على الإجابة

JSON
{
  "date": "2026-03-11",
  "hour": "12:27:00",
  "timestamp": "1773232020",
  "number": "19176728660",
  "contact": "SMSMobileAPI",
  "message": "When will I receive my order?",
  "guid": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c"
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل
يحصل

تحقق من رقم WhatsApp

#
نهاية الفقرةhttps://api.smsmobileapi.com/whatsapp/checknumber/

يفحص ما إذا كان هناك رقم هاتف متاح على WhatsApp.

متى تستخدمه

استخدمه قبل إرساله لتقليل الفشل الذي يمكن تجنبه

حدود

الاسميكتبالاحتياجاتوصف
apikey خيط مطلوب مفتاح API الخاص بك.
recipients الهاتف مطلوب رمز البلد زائداً رقم، بدون + أو 00.

مثال

حليقة
curl "https://api.smsmobileapi.com/whatsapp/checknumber/?apikey=YOUR_API_KEY&recipients=19176728660"

مثال على الإجابة

JSON
{
  "contact_found_on_whatsapp": "yes",
  "recipients": "19176728660"
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل
بريد

إنشاء موقع على موقع OAuth2

#
نهاية الفقرةhttps://api.smsmobileapi.com/oauth2/token

يتبادل أوراق اعتماد العملاء لسيارة بيرة

متى تستخدمه

استخدامه في عمليات التكامل بين الخواديم والحواسيب حيث تُفضَّل وثائق التفويض القصيرة الأجل.

حدود

الاسميكتبالاحتياجاتوصف
grant_type خيط مطلوب لابد أن يكون عميلاً له
client_id خيط مطلوب هوية العميل من لوحة التحكم
client_secret خيط مطلوب سر العميل من لوحة التحكم

مثال

حليقة
curl -X POST "https://api.smsmobileapi.com/oauth2/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل
من الجيد معرفة
  • أبقي العميل سرّاً على خادمك لا تُدرجه أبداً في نظام متحرك أو مُصفّف.
POST ; GET

مسح سجل رسائل WhatsApp المرسلة

#
نهاية الفقرةhttps://api.smsmobileapi.com/delete-history-whatsapp-sent/

سجلات حواسيب الخدمة المرسلة WhatsApp رسائل لا تحذف الرسائل من WhatsApp المحادثات.

متى تستخدمه

استخدمي العرض الأول، وتحققي من التهم، ثم طلبي حذفها صراحة. هذا يُوضّحُ التاريخَ المختارَ بالكاملَ ل API مفتاح، بدون موعد، هاتف أو مرشحات رسائل

حدود

الاسميكتبالاحتياجاتوصف
apikey خيط الاختياري مطلوبة بدون OAuth2مع OAuth2اختيار اختياري API مفتاح الحساب نفسه
action ما قبل الاستعراض تحذف | الحالة الاختياري preview يحسب السجلات دون حذف؛ delete يبدأ الحذف أو يتابعه؛ status يعرض التقدم فقط. القيمة الافتراضية في API هي delete، وفي أداة الاختبار هذه هي preview.
include_linked 0 | 1 الاختياري الافتراض صفر: الاحتفاظ بسجلات متصلة أو تجهيز. وضع 1 لضمها، مع خطر كسر التكامل. أبق هذه القيمة دون تغيير عندما تستمر في الحذف
request_id خيط الاختياري مطلوب مع delete وstatus، واختياري مع preview. استخدم من 16 إلى 128 حرف ASCII أو رقم أو شرطة (-) أو شرطة سفلية (_). أنشئ معرّفًا فريدًا لكل عملية حذف جديدة واحتفظ به في جميع المحاولات المتكررة. هذا ليس معرّف رسالة ولا مفتاح API.

مثال

حليقة
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=preview" -d "include_linked=0"
أمثلة للحذف والوضع

يستعاض عن العينة request_id مع قيمتك الفريدة قبل أن تبدأ وتُغيّر الطلبات الواردة أدناه تاريخ الحساب الحقيقي؛ وهي ليست استعراضات مسبقة.

POST · API المفتاح
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
POST ; OAuth2
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
GET :: الوضع
curl -G "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

مثال على الإجابة

JSON
{
    "result": {
        "error": 0,
        "history": "whatsapp-sent",
        "action": "preview",
        "total": 120,
        "simple": 100,
        "linked_or_processing": 20,
        "selected": 100,
        "include_linked": 0,
        "operation_in_progress": false,
        "active_include_linked": null
    }
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل
من الجيد معرفة
  • المثال الوارد أعلاه هو استعراض مسبق، وليس حذف. فالعدادات توضيحية؛ والاختيار النهائي يتم تحديده عند بدء حذفها.
  • include_linked=1 قد يُعطل GHL، Zapierأو آليات أو وصلات غير مصففة أو تتبع تسليم. لا يتعدى على حساب الملكية أو فحص سلامة التخزين
POST ; GET

مسح سجل رسائل WhatsApp المستلمة

#
نهاية الفقرةhttps://api.smsmobileapi.com/delete-history-whatsapp-received/

سجلات الخادم المستلمة WhatsApp رسائل لا يفصل WhatsApp أو حذف المحادثات.

متى تستخدمه

استخدمي العرض الأول، وتحققي من التهم، ثم طلبي حذفها صراحة. هذا يُوضّحُ التاريخَ المختارَ بالكاملَ ل API مفتاح، بدون موعد، هاتف أو مرشحات رسائل

حدود

الاسميكتبالاحتياجاتوصف
apikey خيط الاختياري مطلوبة بدون OAuth2مع OAuth2اختيار اختياري API مفتاح الحساب نفسه
action ما قبل الاستعراض تحذف | الحالة الاختياري preview يحسب السجلات دون حذف؛ delete يبدأ الحذف أو يتابعه؛ status يعرض التقدم فقط. القيمة الافتراضية في API هي delete، وفي أداة الاختبار هذه هي preview.
include_linked 0 | 1 الاختياري الافتراض صفر: الاحتفاظ بسجلات متصلة أو تجهيز. وضع 1 لضمها، مع خطر كسر التكامل. أبق هذه القيمة دون تغيير عندما تستمر في الحذف
request_id خيط الاختياري مطلوب مع delete وstatus، واختياري مع preview. استخدم من 16 إلى 128 حرف ASCII أو رقم أو شرطة (-) أو شرطة سفلية (_). أنشئ معرّفًا فريدًا لكل عملية حذف جديدة واحتفظ به في جميع المحاولات المتكررة. هذا ليس معرّف رسالة ولا مفتاح API.

مثال

حليقة
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-received/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=preview" -d "include_linked=0"
أمثلة للحذف والوضع

يستعاض عن العينة request_id مع قيمتك الفريدة قبل أن تبدأ وتُغيّر الطلبات الواردة أدناه تاريخ الحساب الحقيقي؛ وهي ليست استعراضات مسبقة.

POST · API المفتاح
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-received/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
POST ; OAuth2
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-received/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
GET :: الوضع
curl -G "https://api.smsmobileapi.com/delete-history-whatsapp-received/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

مثال على الإجابة

JSON
{
    "result": {
        "error": 0,
        "history": "whatsapp-received",
        "action": "preview",
        "total": 120,
        "simple": 100,
        "linked_or_processing": 20,
        "selected": 100,
        "include_linked": 0,
        "operation_in_progress": false,
        "active_include_linked": null
    }
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل
من الجيد معرفة
  • المثال الوارد أعلاه هو استعراض مسبق، وليس حذف. فالعدادات توضيحية؛ والاختيار النهائي يتم تحديده عند بدء حذفها.
  • include_linked=1 قد يُعطل GHL، Zapierأو آليات أو وصلات غير مصففة أو تتبع تسليم. لا يتعدى على حساب الملكية أو فحص سلامة التخزين

استكشاف الأخطاء وإصلاحها

السطو والمستودعات الآمنة

اقرأي حالة HTTP وميدان خطأ JSON قبل إعادة التجريب. لا تُعيد التثبت من صحة الطلب أو تُثبت فشله دون تصحيح الطلب أولاً.

HTTPالمدونةماذا تفعل؟
400missing_parameterالبارامترات المطلوبة فارغة أو غير موجودة. تحقق من طاولة البارامترات في نقطة النهاية
403invalid_apikeyومفتاح API غير معروف أو منتهية أو غير مأذون به بالنسبة للميمة المطلوبة.
429too_many_requestsالطلبات تصل بسرعة انتظر، ثمّ يَعْزلُ بالتراجعِ الهائلِ.
500server_errorولم تستطع الدائرة إكمال الطلب. الحفاظ على الاستجابة ودعم الاتصال إذا استمر.
قاعدة إعادة التأهيلRetry only transient 429 and 5x responses. ابدأ بعد ثانية واحدة ثم تراجع إلى 2 و 4 و 8 ثواني

هل تحتاج إلى مساعدة؟

أحضري سياق الطلب ليس أسرارك

Share the endpoint, timestamp, HTTP status and sanitized response. لا تشمل أبداً مفاتيح API، أو مداخل أو محتوى الرسائل الخاصة.

الاتصال بشركة API