رفض المكالمة

رفض مكالمة واردة لمثيل معين.

POST

https://api.wawp.net/v2/calls/reject?access_token=123456789&callId=call_123456789&from=123456789%40c.us&instance_id=123456789

تسجيل الدخول مطلوب

سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.

تسجيل الدخول

اختبار /v2/calls/reject

يدعم

POST

لا توجد معاملات استعلام مطلوبة

هذه النهاية الطرفية لا تتوقع بيانات في الرابط.

أحداث الويب هوك

استمع إلى خطافات call.* للتعامل مع المكالمات الواردة في الوقت الفعلي.

المكالمات الصادرة

لا تدعم واجهة برمجة تطبيقات واتساب المكالمات الصادرة برمجياً. استخدم الروابط بدلاً من ذلك.

توصيات

استجب لأحداث المكالمات الواردة بسرعة لتجنب انتهاء المهلة.
استخدم نقطة النهاية "رفض" للمكالمات غير المرغوب فيها مع رسالة مهذبة.
سجل محاولات الاتصال للتحليلات والدعم.

الرفض الاستراتيجي: سلطة إنهاء المكالمات برمجياً

في إدارة بيئات الأعمال الرقمية عالية الكثافة، تعد القدرة على قول "لا" بنفس أهمية القدرة على الاستجابة. واجهة رفض المكالمة هي أداتك الأساسية لـ فرض الحدود الاستراتيجية وتوجيه المحادثات. فهي تسمح لأنظمتك بإنهاء إشارة صوتية أو مرئية واردة بناءً على منطق العمل في الوقت الفعلي، مما يضمن تركيز مواردك البشرية والتقنية على التفاعلات ذات الأولوية القصوى.

🏗️ الفلسفة المعمارية: إنهاء الإشارة مقابل الصمت السلبي

من منظور تقني، يعد رفض المكالمة أمراً إشارياً (Signaling Command) يوجه بنية Meta التحتية لإرسال حزمة "مشغول" أو "تم رفض المكالمة" إلى المتصل.

الأهداف المعمارية الرئيسية:

الرفض النشط مقابل التجاهل: إذا قام مثيلك بمجرد تجاهل المكالمة، فسيستمر هاتف المتصل في الرنين لمدة 30-45 ثانية، مما يعطي انطباعاً بعدم الاستجابة أو الفشل التقني. الرفض عبر الواجهة يوفر إشارة فورية وحاسمة، وهو "لياقة احترافية" تتيح للمتصل البحث فوراً عن وسيلة بديلة للحل.
إدارة المقاطعة: المكالمات أحداث تستهلك موارد الصوت والشبكة بكثافة. يضمن الرفض البرمجي تحرير هذه الموارد بأسرع وقت، مما يحافظ على استقرار الأرقام للقيام بمهام أخرى متزامنة مثل البث الجماعي.

🚀 حالات الاستخدام الاستراتيجي: فرض الحدود التشغيلية

تعد الاتصالات الصوتية في الوقت الفعلي مكلفة. يتيح لك الرفض البرمجي إدارة هذه التكلفة مع الحفاظ على صورة علامة تجارية متميزة.

1. محيط مكالمات الـ VIP فقط

قد تختار مؤسستك تقديم الدعم الصوتي فقط للعملاء ذوي القيمة العالية. عند وصول مكالمة، يتحقق النظام من الـ CRM؛ وإذا كان المتصل من "الفئة العادية"، يرفض النظام المكالمة فوراً ويبدأ إعادة توجيه نصية: "نرى أنك تحاول الاتصال. الدعم الصوتي المباشر ميزة في خطتنا المميزة. يرجى متابعة طلبك هنا نصياً أو ترقية حسابك". هذا يحول المكالمة المرفوضة إلى فرصة لزيادة المبيعات (Upsell).

2. فرض "ساعات النشاط" العالمية

عبر ربط واجهة رفض المكالمات بـ "جدول زمني واعي بالمناطق الزمنية"، يمكن لنظامك تلقائياً رفض المكالمات التي تصل خارج ساعات العمل في منطقة معينة، وتزويد المتصل برد سياقي: "مكتبنا في لندن مغلق حالياً. سنعود للعمل في الساعة 09:00 بتوقيت جرينتش. يمكنك ترك رسالة صوتية أو استخدام بوت الأسئلة الشائعة".

🛡️ أفضل الممارسات التشغيلية: قواعد "الخروج اللبق"

تفويض المتابعة السياقية: يجب ألا يكون الرفض البرمجي حدثاً مستقلاً أبداً. الهدف هو نقل المستخدم من قناة متزامنة (عالية التكلفة) إلى قناة غير متزامنة (منخفضة التكلفة). يجب أن يرسل نظامك رسالة نصية في غضون 500 ملّي ثانية من الرفض، تقر بالمكالمة وتوفر الخطوة التالية.
المعالجة المثلى للتأخير: نافذة الرفض الاحترافي ضيقة. إذا استغرق نظامك أكثر من ثانية لمعالجة الويب هوك وإرسال أمر الرفض، فسيسمع المستخدم رنة أو رنتين، مما يخلق انطباعاً بوجود "خلل". تأكد من تحسين معالج الويب هوك لاتخاذ قرارات فائقة السرعة.

البارامترات

قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.

محتوى الطلب

يرسل كـ JSON

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`string`		The unique ID of the incoming call (from call.received webhook) مثال:
	`string`		The WhatsApp ID (JID) of the caller (from call.received webhook) مثال:

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/calls/reject";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789"
6}).toString();
7const body = {
8  "callId": "call_123456789",
9  "from": "123456789@c.us"
10};
11
12fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
13  method: "POST",
14  headers: { "Content-Type": "application/json" },
15  body: JSON.stringify(body)
16})
17  .then(async (response) => {
18    if (response.ok) {
19      const data = await response.json();
20      console.log("Success:", data);
21      return data;
22    }
23    
24    // Error Handling
25    if (response.status === 400) {
26      console.error("Error 400: طلب غير صالح - معاملات مطلوبة مفقودة");
27    }
28    if (response.status === 400) {
29      console.error("Error 400: طلب غير صالح (تنسيق XML)");
30    }
31    if (response.status === 400) {
32      console.error("Error 400: طلب غير صالح (نص عادي)");
33    }
34    if (response.status === 401) {
35      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
36    }
37    if (response.status === 401) {
38      console.error("Error 401: غير مصرح (تنسيق XML)");
39    }
40    if (response.status === 404) {
41      console.error("Error 404: غير موجود - الجلسة غير موجودة");
42    }
43    if (response.status === 404) {
44      console.error("Error 404: غير موجود (تنسيق XML)");
45    }
46    if (response.status === 500) {
47      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
48    }
49    if (response.status === 500) {
50      console.error("Error 500: خطأ في الخادم الداخلي (HTML)");
51    }
52    if (response.status === 502) {
53      console.error("Error 502: بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي");
54    }
55    if (response.status === 502) {
56      console.error("Error 502: بوابة غير صالحة (تنسيق XML)");
57    }
58
59    const errorText = await response.text();
60    console.error(`Error ${response.status}: ${errorText}`);
61  })
62  .catch((error) => console.error("Network Error:", error));

عينات تفاعليةUTF-8

Ln 62, Col 1javascript

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

ناجح - تم إكمال الطلب بنجاح

3 نسخ

النوع:

application/json

boolean *

string *

Example

{
"success": true,
"message": "Operation completed successfully"
}

طلب غير صالح - معاملات مطلوبة مفقودة

3 نسخ

غير مصرح - مفتاح الوصول غير صالح أو مفقود

2 نسخ

Command Palette

Search for a command to run...