البدء / مقدمة

مقدمة

صدى يضيف المكالمات الصوتية إلى تطبيقك: خادمك ينشئ المكالمات ويصدر رموز الانضمام عبر REST API صغير، والـ SDK في تطبيقك ينقل الصوت، والـ webhooks تخبر خادمك بما حدث.

⏱ 5 دقائق حُدّث في 21 أكتوبر 2026 عدّل هذه الصفحة

01ما هو صدى

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

لن تتعامل مع الصوت بنفسك أبداً. خادمك يخاطب https://sada.g4t.io/api/v1 بمفتاح سري، وتطبيق Flutter أو الويب يخاطب صدى برمز قصير العمر أصدره خادمك. المستخدمون وجهات الاتصال والصلاحيات تبقى في منتجك — صدى لا يعرف إلا user_ref تختاره أنت.

02كيف تجري المكالمة

كل مكالمة، فردية أو جماعية، تمرّ بالخطوات الأربع نفسها.

01

خادمك ينشئ المكالمة

POST /calls بالمفتاح السري. تحصل على call_id وتبدأ المكالمة بالرنين (أو جارية مباشرة إن كان ring معطّلاً).
02

خادمك يصدر رمزاً لكل مشارك

POST /calls/{call_id}/tokens بمعرّف المستخدم واسمه الظاهر. الرمز JWT صالح 5 دقائق ومرتبط بهذا المستخدم.
03

تطبيقك ينضم بالرمز

الـ SDK (‏@sada/web اليوم، وFlutter لاحقاً) يفتح الميكروفون ويتصل بأقرب منطقة ويطلق الأحداث: انضمام، مغادرة، جودة، انتهاء.
04

الـ webhooks تخبرك بالنتيجة

طلبات POST موقّعة إلى مسارك لأحداث call.started وparticipant.joined وparticipant.left وcall.ended وcall.missed، مع ثلاث محاولات.

جانب الخادم كله طلب واحد لإنشاء مكالمة…

curl -X POST https://sada.g4t.io/api/v1/calls \

-H "Authorization: Bearer sk_test_4vN8kR2pXa61Jd0s" \

-H "Content-Type: application/json" \

-d '{"type": "one_to_one", "ring": true, "metadata": {"order_id": "ord_42"}}'

03المفاهيم

ست كلمات ستقابلها في كل صفحة.

العنصر	الوصف
التطبيق	منتج واحد في مؤسستك (مثل «تطبيق سائق توصيل»). لكل تطبيق مفاتيحه وwebhooks وبيانات إشعاراته.
المفاتيح	مفتاح عام `pk_…` ومفتاح سري `sk_…` لكل تطبيق وبيئة. المفتاح السري يوثّق طلبات REST API ولا يغادر خادمك.
المكالمة	محادثة واحدة: `one_to_one` أو `group`، لها حالة ومنطقة و`metadata` اختيارية وخط زمني من الأحداث.
رمز الانضمام	JWT موقّع قصير العمر يصدره خادمك لمستخدم واحد للانضمام إلى مكالمة واحدة. هو كل ما يحتاجه تطبيقك.
المشارك	مستخدم داخل مكالمة، معرَّف بـ `user_ref` الخاص بك، مع أوقات الانضمام والمغادرة ومقاييس الجودة.
دقيقة المشارك	وحدة الفوترة: كل مشارك متصل يُحتسب بالدقيقة، مقرّبة للأعلى لكل مكالمة.

04المناطق

يمرّ الصوت عبر أقرب منطقة إلى مستخدميك: baghdad أو dubai أو istanbul. مرّر region عند إنشاء المكالمة، أو اتركه auto فتستخدم المكالمة المنطقة الرئيسية لمؤسستك.

اختر المنطقة التي يوجد فيها معظم مشاركي تلك المكالمة. مكالمة بين بغداد وأربيل مكانها baghdad، وخط دعم لعملاء الخليج مكانه dubai.

baghdad dubai istanbul auto

05التجريبي والفعلي

لكل تطبيق بيئتان. مفاتيح sk_test_… تنشئ مكالمات تجريبية: صوت حقيقي وwebhooks حقيقية ولا فوترة أبداً. مفاتيح sk_live_… تنشئ مكالمات فعلية تُحتسب من الباقة المجانية وتُفوتر بعدها.

بدّل لوحة التحكم بين تجريبي وفعلي من الشريط العلوي؛ سجل المكالمات والمفاتيح وتسليمات الـ webhook منفصلة لكل بيئة. المفاتيح الفعلية لا تعمل إلا بعد تفعيل الوضع الفعلي للتطبيق.

06إلى أين الآن

البدء السريع أول مكالمة في عشر دقائق، خادماً وتطبيقاً. حزمة Laravel Sada::calls()->create() وميدل وير للـ webhooks. SDK الويب صوت WebRTC في المتصفح بـ @sada/web.

✓ شكراً، وصلتنا ملاحظتك.

التالي ← البدء السريع