Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Remove old docs on button actions #80

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Remove old docs on button actions #80

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 8 additions & 54 deletions chat/send_message.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -120,26 +120,12 @@ x-access-token: {{access_token}}

### Button

| Field Name | Field Type | Description |
|------------|----------------------------|-------------------------------------------------|
| action | [Action](/widgets/actions) | اکشنی که پس از کلیک کاربر بر روی دکمه رخ می‌دهد |
| icon_name | String | نام آیکون نمایش داده‌شده بر روی دکمه |
| caption | String | متنی که بر روی دکمه نمایش داده می‌شود |
| Field Name | Field Type | Description |
|------------|------------------|-------------------------------------------------|
| action | [Action][Action] | اکشنی که پس از کلیک کاربر بر روی دکمه رخ می‌دهد |
| icon_name | String | نام آیکون نمایش داده‌شده بر روی دکمه |
| caption | String | متنی که بر روی دکمه نمایش داده می‌شود |

در درخواست بالا، کاربران با [زدن روی دکمهٔ پیام][بازشدن برنامه]، در قالب webview یا pop-up به برنامهٔ شما وارد می‌شوند، در صورتی که نیاز به باز کردن صفحهٔ خود به صورت مستقیم در مرورگر دارید، می‌توانید ویژگی‌های دکمه را به شکل زیر تغییر دهید.

```
{
"sender_btn": {
"action": "DIRECT_LINK",
"data": {
"icon_name": "نام آیکون مورد نظر برای این دکمه",
"direct_link": "آدرس صفحهٔ مورد نظر برای باز شدن هنگام کلیک",
"caption": "متن دکمهٔ زیر پیام برای طرف فرستنده"
}
}
}
```

### خطاها

Expand All @@ -163,46 +149,14 @@ HTTP/1.1 412

## کلیک کاربر روی دکمهٔ درج شده زیر پیام

در صورتی که کاربر روی دکمه‌ای که زیر پیام اضافه کرده‌اید کلیک کند، ابتدا دیوار یک درخواست به آدرسی که در ابتدا تنظیم کرده‌اید می‌زند. [توضیحات بیشتر](/management#session-initialization-url/)

به همراه این درخواست موارد زیر ارسال خواهند شد و سپس کاربر به آدرسی که در دکمهٔ مورد نظر درج شده‌است هدایت می‌شود.

نمونهٔ محتوای ارسالی درخواست از سمت دیوار

```JSON
{
"extra_data": {
"provider_data": {"your_custom_key":"اطلاعاتی که در درخواست ارسال پیام در مرحلهٔ قبل فرستادید"}
},
"callback_url": "آدرسی که کاربر پس از انجام فرایند در سرویس شما باید به آن هدایت شود",
"post_token": "توکن آگهی",
"user_id": "شناسهٔ کسی که روی لینک کلیک کرده یا فرایند را شروع کرده",
"peer_id": "شناسهٔ طرف مقابل چت",
"supplier": {
"id": "شناسهٔ کاربر فروشنده (صاحب آگهی)"
},
"demand": {
"id": "شناسهٔ کاربر خریدار"
},
"conversation_id": "شناسه مکالمه"
}

```

در پاسخ به این درخواست، می‌بایست آدرسی را به شکل زیر برگردانید. کاربر به أدرسی که در قسمت `url` پاسخ شماست هدایت می‌شود و با برنامهٔ تحت وب شما تعامل می‌کند.

```JSON
{
"status": "200",
"message": "success",
"url": "https://yourdomain.com/some/where/to/start"
}
```
پس از کلیک کاربر بر روی دکمه‌های پیام، با توجه به [اکشنی][Action] که بر روی دکمه تعریف شده است،
کاربر به سمت برنامه‌ی شما هدایت می‌شود.

<br>

[احراز باز]: /oauth
[API key]: /management/api-keys.md
[Action]: /widgets/actions
[پنل کنار]: /management
[ارسال پیام در یک چت]: #ارسال-پیام-در-یک-چت
[ارسال پیام در چت‌های آگهی]: #ارسال-پیام-در-چتهای-یک-آگهی
Expand Down