> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wave.sa/llms.txt
> Use this file to discover all available pages before exploring further.

# مقدّمة

> Wave منصّة اتصالات صوتيّة في المملكة العربيّة السعوديّة. ابدأ بـ Web Callback API.

Wave منصّة اتصالات صوتيّة في المملكة العربيّة السعوديّة. يغطّي هذا التوثيق Web Callback API — أجرِ مكالمة بنقرة واحدة من الـ backend الخاصّ بك: تطلب Wave رقمًا وتجسره مع وجهة، عبر شبكة هاتفيّة حقيقيّة.

<Info>
  ما هو موثّق اليوم: Web Callback في وضع الـ sandbox. أمّا WebRTC Calling SDK، ومراسلة WhatsApp، وتسجيلات المكالمات، ومفاتيح فئة الإنتاج فهي على خريطة الطريق وستُوثَّق عند إطلاقها.
</Info>

## ابدأ

<CardGroup cols={2}>
  <Card title="البدء السريع" icon="rocket" href="/ar/quickstart">
    احصل على sandbox key وأجرِ أوّل callback لك في أقلّ من 5 دقائق.
  </Card>

  <Card title="المصادقة" icon="key" href="/ar/authentication">
    كيف تعمل الـ API keys وكيفيّة إرسالها.
  </Card>

  <Card title="وضع الـ Sandbox" icon="flask" href="/ar/sandbox-mode">
    مؤقّت التجربة، وقفل الوجهة، وأرقام الاختبار.
  </Card>

  <Card title="مرجع الـ API" icon="code" href="/ar/api-reference/overview">
    كلّ endpoint، مع بيئة تجريبيّة تفاعليّة.
  </Card>
</CardGroup>

## كيف يعمل Web Callback

1. تستدعي `POST /v1/callback` مع رقم وجهة و sandbox key الخاصّ بك.
2. تُجري Wave المكالمة عبر الـ telephony backend الخاصّ بها وتُعيد `status: "initiated"`.
3. تظهر المكالمة في Call Logs الخاصّة بك؛ وتُخطِر الـ webhooks الـ endpoint الخاصّ بك بأحداث المكالمة.

<Note>
  في الـ sandbox، المكالمات حقيقيّة لكنّها مقيّدة — راجع وضع الـ Sandbox للاطّلاع على نافذة التجربة وقفل الوجهة.
</Note>