Anti Sandboxللمطوّرين

البداية السريعة

خمس خطوات من الصفر إلى أول رد من الوكيل — في السندبوكس، حيث لا تصل أي رسالة إلى قناة حقيقية.

١ · أنشئ تطبيق سندبوكس

من المكتب: الإعدادات ← المطوّرون ← تطبيق جديد. اختر «sandbox» والنطاقات agent:run وconversations:read. سيظهر client_secret مرة واحدة فقط — احفظه في مخزن الأسرار.

٢ · خذ رمز وصول

curl -s -X POST "https://api.antisandbox.com/v1/oauth/token" \
  -H 'content-type: application/x-www-form-urlencoded' \
  -d 'grant_type=client_credentials' \
  -d 'client_id=asc_sandbox_…' \
  -d 'client_secret=ass_sandbox_…'

الرد: access_token صالح عشر دقائق. لا يوجد refresh token — اطلب رمزاً جديداً عند الحاجة.

٣ · أرسل رسالة عميل

curl -s -X POST "https://api.antisandbox.com/v1/inbound-events" \
  -H "authorization: Bearer $TOKEN" \
  -H 'content-type: application/json' \
  -H 'idempotency-key: quickstart-1' \
  -d '{
    "channel": "whatsapp",
    "external_message_id": "msg-1001",
    "external_thread_id": "966500000001",
    "sender": { "external_id": "966500000001", "display_name": "سارة" },
    "text": "كم رسوم الشحن؟"
  }'

202 يعني «حُفظت». الوكيل يجيب بعد ذلك من الطابور — لا نموذج داخل الطلب.

٤ · اقرأ الرد

curl -s "https://api.antisandbox.com/v1/conversations?limit=1" -H "authorization: Bearer $TOKEN"
curl -s "https://api.antisandbox.com/v1/conversations/<id>" -H "authorization: Bearer $TOKEN"

المحادثة تحمل الرسائل الواردة والصادرة؛ رد الوكيل يظهر بـ author: "agent".

٥ · استقبل الأحداث

سجّل webhook من شاشة التطبيق أو عبر POST /v1/webhook-endpoints، اضغط «أرسل حدث اختبار»، وتحقق من التوقيع كما في صفحة webhooks.

الانتقال للإنتاج: أنشئ تطبيقاً بيئته «live»، وأرسل الأحداث مع channel_account_id لحساب قناة مربوط بمنظمتك. الرمز والمسارات نفسها.