البداية السريعة
خمس خطوات من الصفر إلى أول رد من الوكيل — في السندبوكس، حيث لا تصل أي رسالة إلى قناة حقيقية.
١ · أنشئ تطبيق سندبوكس
من المكتب: الإعدادات ← المطوّرون ← تطبيق جديد. اختر «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 لحساب قناة مربوط بمنظمتك. الرمز والمسارات نفسها.
