در چت دیوار به طرفین چت بر اساس مواردی مثل شهر یا دسته‌ٔ آگهی خدماتی را پیشنهاد می‌دهیم که اگر برنامهٔ شما در آن گروه برنامه‌ها باشد به عنوان خدمت‌دهنده به کاربران معرفی می‌شود. مثلاً شما می‌توانید به عنوان خدمت‌دهنده در افزونه‌های ارسال کالا در چت به کاربران معرفی شوید تا با بازکردن برنامهٔ وب شما، درخواست خود را ثبت کنند.
 |
|---|
| مسیری که کاربر برای دریافت خدمات شما در چت طی می کند |
۱. در هر زمانی که چت دیوار بخواهد برنامهٔ شما را باز کند، درخواستی با جزییات زیر به آدرسی که در فیلد Session Initialization URL در پنل کنار وارد کرده‌اید ارسال می‌کند و در صورت دریافت پاسخ معتبر، کاربر را به آدرسی که در پاسخ وجود دارد هدایت می‌کند.
POST https://your.app.ir
Content-Type: application/json
authorization: {{ Divar Identification Key }}
{
"extra_data": {
"location": {
"latitude": "اگر برنامهٔ شما از مسیر دکمه‌هایی که چت دیوار زیر پیام‌های از نوع موقعیت مکانی درج می‌کند، باز شود، این اطلاعات هم در درخواست ارسالی از سمت دیوار خواهید داشت.",
"longitude": "51.34850978851319"
}
},
"callback_url": "آدرسی که کاربر پس از انجام فرایند در سرویس شما باید به آن هدایت شود",
"post_token": "توکن آگهی",
"user_id": "شناسهٔ کسی که روی لینک کلیک کرده یا فرایند را شروع کرده",
"peer_id": "شناسهٔ طرف مقابل چت",
"supplier": {
"id": "شناسهٔ کاربر فروشنده (صاحب آگهی)"
},
"demand": {
"id": "شناسهٔ کاربر خریدار"
},
}
- پارامتر
post_tokenشناسهٔ آگهی مورد نظر است. - پارامتر
user_idشناسهٔ کاربریست که با اپلیکیشن تعامل کرده. - پارامتر
peer_idشناسهٔ طرف دیگر چت است. - برای دریافت اجازه‌ها یا استفاده از امکانات مربوط به چت، هر سهٔ این پارامترها را ارائه کنید.
- پارامتر
callback_urlادرسی‌ست که باید کاربر را بعد از اتمام فرآیند به آن هدایت کنید. - مقدار
authorizationمعادل پارامترDivar Identification Key، که در سطح اپلیکیشن قابل تنظیم است، قرار داده خواهد شد. با خواندن این هدر و مقایسهٔ آن، می‌توانید منبع درخواست را احراز کرده مطمئن شوید درخواست از جانب دیوار ارسال شده است.
در پاسخ به این درخواست، می‌بایست آدرسی را به شکل زیر برگردانید. کاربر به أدرسی که در قسمت url پاسخ شماست هدایت می‌شود و با برنامهٔ تحت وب شما تعامل می‌کند.
{
"status": "200",
"message": "success",
"url": "https://yourdomain.com/some/where/to/start"
}پس از باز شدن برنامهٔ شما در اپ دیوار به صورت webview در اپلیکیشن‌های دیوار یا pop-up در وب دیوار، کاربر عملیات مورد نظر شما را در برنامهٔ شما طی می‌کند و خدمات مورد نظر را دریافت می‌کند. پس از اتمام کار برنامه می‌بایست کاربر را به دیوار برگرداند.
پیشنهاد می‌کنیم در زمان‌هایی که دانستن نتیجهٔ کار برای هر دو طرف چت لازم است، نتیجه را در چت اعلام کنید و دکمه‌ای برای پیگیری نیز در پیام درج کنید.
برای ارسال پیام در چت باید در برنامهٔ خود از طریق احراز باز اجازهٔ ارسال پیام در چت را از کاربر گرفته‌باشید.
همچنین ممکن است نیاز به دریافت دسترسی برای ارسال پیام در چت یا موارد دیگر از کاربر شوید که می‌توانید با استفاده از احراز باز در موردشان از کاربر اجازه بگیرید.
یکی دیگر از راه‌های تعامل در چت، خواندن در لحظه پیام‌های تمام مکالمات شکل گرفته بر روی یک آگهی و ارسال پیام از طرف آگهی گذار می‌باشد.
توجه شود که این فیچر نسخه آزمایشی بوده و ممکن است دچار تغییرات Backward Incompatible شود.
