اربط نيو بالويب سايت بتاعك وبالسيستم بتاعك.

قريبشوبيفايمتجر أونلاين

1. 01

   سكريبت شات الويب سايت

   حطه في صفحاتك مرة واحدة. تطبيق نيو بيديك السكريبت بالظبط، وهو بيشتغل بس على الدومين اللي سجلته.

   الطلب · HTMLانسخ

   <script defer data-site="YOUR_SITE_ID" src="YOUR_WIDGET_URL"></script>

2. 02

   افتح سيشن للزائر

   شات بتصميمك إنت بيبدأ من هنا: توكن للزائر على الدومين اللي سجلته. التوكن بيفضل شغال 7 أيام.

   الطلب · curlانسخ

   curl -X POST "{NEO_API}/api/webchat/v1/sites/YOUR_SITE_ID/sessions" \
     -H "Content-Type: application/json" \
     -d '{ "origin": "https://YOUR_DOMAIN" }'

   الرد · 201انسخ

   { "schemaVersion": 1, "token": "VISITOR_TOKEN", "expiresAt": "…" }

3. 03

   ابعت رسالة الزائر

   ابعت بالتوكن بتاع الزائر. والأخطاء دايمًا بترجع بنفس الشكل. النسخة الأولى فيها 4 endpoints، وفريق نيو بيمشي معاك فيهم كلهم.

   الطلب · curlانسخ

   curl -X POST "{NEO_API}/api/webchat/v1/messages" \
     -H "Authorization: Bearer VISITOR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{ "id": "MESSAGE_UUID", "text": "Is the blue one in stock?" }'

   الرد · 202انسخ

   { "schemaVersion": 1, "accepted": true, "messageId": "…" }

   الخطأ · 401انسخ

   { "schemaVersion": 1, "error": "expired" }

4. 04

   أكشن واحد من الأول للآخر

   إنت بتحدد الأكشن وبتجربه مع فريق نيو. ولما عميل يسأل، نيو بيكلم السيستم بتاعك وبيرد من اللي رجع منه.

   الأكشنانسخ

   Name     Check an order
   Method   GET            GET, POST, PUT or PATCH. Never DELETE
   URL      https://YOUR_DOMAIN/api/orders/ORDER_ID
   Key      YOUR_API_KEY   stored encrypted, never shown again
   Rule     Allowed        or Ask me first, or Off
   Test     passed         a real test runs before it goes live

   الطلب · HTTPSانسخ

   GET https://YOUR_DOMAIN/api/orders/ORDER_ID

   الرد · 200انسخ

   { "status": "YOUR_ORDER_STATUS", "eta": "YOUR_DELIVERY_TIME" }

5. 05

   ابعت جوه محادثة واتساب

   الـ Engine API، من السيرفر بتاعك، بمفتاح من فريق نيو. لو عملت retry بنفس الـ Idempotency-Key، الرسالة مش هتتبعت مرتين. 120 طلب في الدقيقة لكل مفتاح.

   الطلب · curlانسخ

   curl -X POST "{NEO_API}/engine/v1/messages" \
     -H "Authorization: Bearer YOUR_ENGINE_KEY" \
     -H "Idempotency-Key: A_NEW_UUID_PER_SEND" \
     -H "Content-Type: application/json" \
     -d '{ "conversation_id": "CONVERSATION_ID", "text": "Your order is on its way." }'

   الرد · 201انسخ

   { "message": { "id": "…", "conversation_id": "…", "status": "…" } }

6. 06

   اقرا اللي حصل

   الأحداث بتيجي بالترتيب، لحد 200 في الصفحة. احتفظ بالـ next_cursor وابعته تاني عشان تكمّل من مكان ما وقفت.

   الطلب · curlانسخ

   curl "{NEO_API}/engine/v1/events?cursor=NEXT_CURSOR&limit=200" \
     -H "Authorization: Bearer YOUR_ENGINE_KEY"

   الرد · 200انسخ

   { "data": [ … ], "page": { "next_cursor": "…", "has_more": false } }