الانتقال إلى المحتوى الرئيسي

​
احصل على sandbox API key

  1. سجّل في wave.sa وأكمِل التحقّق من الهويّة عبر Nafath.
  2. سجّل الدخول إلى لوحة التحكّم وافتح API Keys.
  3. انسخ الـ sandbox key الخاصّ بك — يبدأ بـ sk_sandbox_.
تعامَل مع الـ key الخاصّ بك كأنّه كلمة مرور. يُعرَض مرّة واحدة فقط عند الإنشاء؛ وإن فقدته، فاستخدم Revoke & Regenerate في لوحة التحكّم.

​
أجرِ callback

أرسِل رقم وجهة إلى POST /v1/callback: 
curl -X POST https://api.wave.sa/v1/callback \
  -H "Authorization: Bearer sk_sandbox_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+966500000000" }'

​
اقرأ الاستجابة

يُعيد الطلب الناجح 202 Accepted: 
{
  "call_id": "call_abc123",
  "status": "initiated",
  "sandbox": true,
  "vitalpbx_channel_id": "…",
  "created_at": "2026-06-17T10:00:00.000Z"
}
الـ status هو initiated — لقد أجرت Wave المكالمة. أمّا الحالات النهائيّة (answered/ended) فلا تُصدَر بعد. راجع دورة حياة المكالمة.

​
الخطوات التالية

وضع الـ Sandbox

نافذة التجربة، وقفل الوجهة، وأرقام الاختبار.

Webhooks

استقبل أحداث المكالمات على الـ endpoint الخاصّ بك.