در این مقاله با نحوه ارتباط گیری یک بات با لیمو از طریق bash آشنا می‌شویم.

لازم به ذکر است این روش بر روی سیستم‌های مبتنی بر Unix کاربردی است و در ویندوز کاربردی ندارد. ابتدا مطمئن شوید ابزار Curl بر روی سیستم شما نصب است. در صورتی که این ابزار نصب باشد شما می‌توانید با استفاده از قطعه کدی که برای اینکار نوشته شده ‌است پیام‌های خود را در لیمو ارسال کنید.

بنابراین ابتدا این قطعه کد را از گیت‌هاب دانلود نمایید. برای اینکار می‌توانید از ابزار گیت استفاده کنید.

git clone https://github.com/limoo-im/bash-sdk

پس از دانلود مخزن مربوطه، در پوشه آن فایلی تحت عنوان limoo-sdk.sh وجود دارد. در این فایل تنظیماتی وجود دارد که باید توسط شما تکمیل شود.

USERNAME=<USERNAME>					#Specified when creating the bot user
PASSWORD=<PASSWORD>					#Specified when creating the bot user

WORKSPACE_ID=<WORKSPACE_ID>			#The workspae UUID
CONVERSATION_ID=<CONVERSATION_ID>	#The Conversation UUID

USERNAME و ‌‌‌‌‌PASSWORD نام کاربری و پسورد باتی است که در لیمو وطیفه ارتباط گیری را دارد. این بات توسط لیمو بات در لیمو در دسترس شما قرار میگیرد.

برای ساخت بات توسط لیمو بات کافیست در لیمو به گفتگوی شخصی خود با لیمو بات رفته و در آنجا به شکل زیر بات مد نظر خود را بسازید.

/ساخت-بات نام-کاربری-بات نام-نمایشی بات

با اینکار لیموبات به شما رمزعبور بات را نیز می‌دهد که به همراه نام کاربری که خودتان انتخاب کردید در تنظیمات فایل بالا قرار می‌گیرد.

در ادامه دو پارامتر دیگر باید تنظیم شوند. این دو پارامتر یکی فضای کاری است که بات در آن قرار دارد و دومی مکالمه‌ای که قرار است بات در آن پیام‌ها را ارسال کند. بدست آوردن این دو پارامتر نیز به شکل زیر امکان پذیر است.

ابتدا به مکالمه‌ای که می‌خواهید پیام‌ها را دریافت کنید بروید. در ادامه اگر از مرورگر کروم استفاده می‌کنید با راست کلیک بر روی صفحه بر روی گزینه Inspect کلیک نمایید.

در پنجره‌ای که باز می‌شود بر روی گزینه ‌Network (کادر آبی) کلیک کرده، سپس تنظیمات را مانند آنچه در تصویر زیر مشاهده می‌کنید (کادر سبز) انجام دهید. در این صورت اگر پیامی در آن مکالمه ارسال کنید، چند مورد به مواردی که مرورگر درخواست می‌دهد اضافه می‌شود. این موارد در قسمت چپ (‌کادر قرمز)‌ قرار می‌گیرد.

در این مرحله لازم است یک پیام در همان مکالمه ارسال کنید. با ارسال پیام موارد زیر به درخواست‌ها اضافه می‌شود.

بنابراین بر روی مورد قرمز رنگ کلیک کنید. در این مرحله بر روی گزینه Headers (کادر سبز) کلیک کنید. دقت کنید جلوی گزینه Request URL (کادر آبی) باید آدرسی با فرمت زیر قرار گرفته باشد. در غیر اینصورت احتمالا باید دنبال آیتم دیگری در کادر قرمز رنگ بالا بگردید.

https://web.limoo.im/Limonad/api/v1/workspace/items/<WORKSPACE_ID>/conversation/items/<CONVERSATION_ID>/message/items

در اینصورت WORKSPACE_ID کلیدی است که بعد از workspace/items/ قرار می‌گیرد. (کادر قهوه‌ای) و CONVERSATION_ID کلیدی است که بعد از CONVERSATION/items قرار می‌گیرد. (کادر مشکی)

با یافتن این دو مورد، کافیست مقادیر آنها را در فایل limoo-sdk.sh قرار دهید.

با تکمیل شدن تنظیمات مربوطه می‌توانید آن را اجرا کنید. دقت کنید،‌ این فایل حتما در مد اجرایی قرار داشته باشد. برای اینکار هم می‌توانید دستور زیر را اجرا کنید.

chmod +x limoo-sdk.sh

در این مرحله کافیست آنرا اجرا کنید و متنی که می‌خواهید در لیمو ارسال شود را در جلوی آن قرار دهید. به عنوان فرض کنید می‌خواهید عبارت Hello World را ارسال کنید. بنابراین اجرای کد به صورت زیر خواهد شد.

./limoo-send.sh "An awesome message!"