دکمه ها

روش ساخت دکمه

شما می توانید به تعداد مورد نیاز دکمه برای کاربر تعریف کنید که پس از کلیک و یا tap بروی هر کدام از این دکمه ها توسط کاربر عملکردی که برای آن تعریف کرده اید انجام خواهد شد که این عمل می تواند شامل ارسال یک مقدار از سمت کاربر به سرور و یا باز کردن یک url در مرورگر کاربر و... باشد.

شما برای ساخت دکمه ها به متغییرهای additionalType و additionalData نیاز دارید که در ادامه هردو را توضیح میدهیم .

additionalType

نوع متغیر additionalType از جنس عدد (number) است که مدل دکمه ی شما در آن تعریف میشود . لیست زیر شامل تمام مدل های قرارگیری دکمه های شما است که میتواننید در ربات خود استفاده نمایید.

additionalType	مقدار
ADDITIONAL_TYPE_NONE	0
ADDITIONAL_TYPE_UNDER_KEYBOARD_BUTTON	1
ADDITIONAL_TYPE_UNDER_MESSAGE_BUTTON	2
ADDITIONAL_TYPE_BUTTON_CLICK_ACTION	3
ADDITIONAL_TYPE_STICKER	4
ADDITIONAL_TYPE_GIF	5
ADDITIONAL_TYPE_STREAM_TYPE	6
ADDITIONAL_TYPE_KEYBOARD_TYPE	7
ADDITIONAL_TYPE_FORM_BUILDER	8
ADDITIONAL_TYPE_WEBVIEW_SHOW	9

additionalData

نوع متغیر آرایه است که شامل بدنه ی دکمه ها می باشد .

بدنه ی دکمه ها object است که به موارد زیر برای تولید دکمه نیاز دارد :

پارامترها	نوع	توضیحات
actionType	number	نوع عملکرد دکمه را مشخص میکند . لیست کامل actionType در انتها آمده است
label	string	نام دکمه است که کاربر بر روی دکمه می بیند
value	string	مقادیر مورد نیاز که در دکمه ذخیره می شود که در صورت نداشتن عکس می توانید مقدار آن را خالی بگزارید
imageUrl	string	پس زمینه ی دکمه را در این جا قرار می دهید که در صورت نداشتن عکس می توانید مقدار آن را خالی بگزارید

لیست actionType

additionalType	مقدار	additionalType	مقدار
BUTTON_ACTION_JOIN_LINK	1	BUTTON_ACTION_FINANCIAL_MENU	13
BUTTON_ACTION_BOT_ACTION	2	BUTTON_ACTION_BILL_MENU	14
BUTTON_ACTION_USERNAME_LINK	3	BUTTON_ACTION_TRAFFIC_BILL_MENU	15
BUTTON_ACTION_WEB_LINK	4	BUTTON_ACTION_MOBILE_BILL_MENU	16
BUTTON_ACTION_WEBVIEW_LINK	5	BUTTON_ACTION_PHONE_BILL_MENU	17
BUTTON_ACTION_STREAM_PLAY	6	BUTTON_ACTION_TOPUP_MENU	18
BUTTON_ACTION_PAY_BY_WALLET	7	BUTTON_ACTION_WALLET_MENU	19
BUTTON_ACTION_PAY_DIRECT	8	BUTTON_ACTION_NEARBY_MENU	20
BUTTON_ACTION_REQUEST_PHONE	9	BUTTON_ACTION_CALL	21
BUTTON_ACTION_REQUEST_LOCATION	10	BUTTON_ACTION_STICKER_SHOP	22
BUTTON_ACTION_SHOW_ALERT	11	BUTTON_ACTION_IVAN	23
BUTTON_ACTION_PAGE	12	BUTTON_ACTION_IVANQR	24
BUTTON_ACTION_IVANDLIST	25	BUTTON_ACTION_IVANDSCORE	26
BUTTON_ACTION_CARD_TO_CARD	27

روش ارسال دکمه

برای ارسال دکمه ، شما باید این دو متغیر را درون پیام ارسالی خود به کاربر قرار دهید.

مثال

const additionalType = 2 ; //ADDITIONAL_TYPE_UNDER_MESSAGE_BUTTON;

const additionalData = [];

this.additionalData.push([

{

actionType: 9, // BUTTON_ACTION_REQUEST_PHONE

label: " 📞 ارسال شماره تماس",

value: "next",

imageUrl: "",

} ,

{

actionType: 2 , //BUTTON_ACTION_BOT_ACTION,

label: "➡️بازگشت",

value: "back",

imageUrl: "",

}

]);

const message = new ChatSendMessage ;

message.setMessage('برای پیگیری بهتر و ایجاد ارتباط با تیم پشتیبانی آیگپ لطفا شماره تماس خود را با زدن دکمه ی * ارسال شماره تماس * برای ما ارسال نمایید ');

message.setRoomId('userRoomId');

message.additionalData(additionalData);

message.additionalType(additionalType);

const data = message.serializeBinary();

const actionId = 201;

const headers = {

Authorization: "Bearer {{YOUR_BOT_TOKEN}}"

}

axios.post(`https://api.igap.net/botland/v1/api?actionId=${actionId}`, data , headers);