وظائف جديدة لروبوتات VK - أزرار الإجابة السريعة أو لوحة المفاتيح.

مهم! أحدث نسخة من المقال

أصبح فريقنا من "كتاب الروبوتات" مهتمين على الفور بهذا الابتكار وبدأوا في دراسة المسؤول واجهة برمجة التطبيقاتلأقول لك وأظهر لك تعليمات مفصلةحول إنشاء روبوت باستخدام لوحة المفاتيح. ستنتج هذه المقالة روبوتًا يمكنك رؤيته في مجموعتنا نصائح اللعبةفي فك. يمكنك أيضًا الانضمام إلى محادثة المجتمع على VK، حيث يمكنهم مساعدتك في حل مشكلتك.

1. إنشاء وتكوين المجتمع
2. إعداد الخادم
3. كيفية عمل Callback API ولوحة المفاتيح
4. العمل مع المكتبة
5. كود بوت كامل
6. دعنا نذهب!
7. التعليمات

إنشاء وتكوين المجتمع

بعد إنشاء مجتمع في VK، اتبع هذا المسار:
"إدارة المجتمع" ← "الرسائل" وتمكين محادثات المجتمع. الآن في القائمة الفرعية "إعدادات الروبوت"، قم بتمكين "ميزات الروبوت" والزر "ابدأ".

سنكتب باستخدام Callback api (نرسل كل إجراء في المجتمع بشكل منفصل إلى الخادم). ولذلك، ينبغي أيضا تكوينه. دعنا نذهب إلى
"إدارة المجتمع" ← "العمل مع واجهة برمجة التطبيقات". لكي يعمل الروبوت، يجب عليك تسجيل مفتاح الوصول. انقر فوق "إنشاء مفتاح" وحدد حقوق الوصول اللازمة؛ يحتاج هذا الروبوت فقط إلى حقوق الرسائل. نؤكد رقم الهاتف ونحفظ مفتاح الوصول في مكان ما. انتقل الآن إلى علامة التبويب Callback API. ضع اسم السيرفر الخاص بك ثم اختر أحدث نسخةواجهة برمجة التطبيقات (في الوقت الحالي هي 5.80، ومعها سيعمل الروبوت الموضح أدناه بنسبة 100٪). في علامة التبويب "أنواع الطلبات"، حدد الرسائل الواردة فقط.

إعداد الخادم

الآن سوف تحتاج إلى خادم لاستضافة الروبوت الخاص بك. يمكنك استخدام استضافة مجانيةعلى سبيل المثال 000webhost.

إذا كنت تستخدم استضافة رخيصة/مجانية، فمن المرجح أن يتم تعطيل cURL عليها (لن تتمكن من إرسال ملفات الوسائط باستخدام الروبوت، فقط النص)، ولا يمكن تمكينه. 000webhost جيد في هذا، يمكنك استخدامه. إذا كان لديك خادم خاص بك أو اشتريت خادمًا جيدًا، فأنت بحاجة إلى توصيل cURL حتى يعمل الروبوت في مثالنا بشكل كامل.

كيفية عمل Callback API ولوحة المفاتيح

سأعطيك جولة قصيرة حول كيفية عمل كل شيء. ترسل واجهة Callback API إلى الخادم الخاص بك أي حدث يحدث في المجموعة في شكل JSON. القائمة الكاملةيمكن عرض الأحداث في علامة التبويب "Callback API" ← "أنواع الأحداث". هذا هو الشكل الذي يبدو عليه طلب JSON عندما يرسل المستخدم رسالة في هذه الحالةضغط على الزر:

("type": "message_new"، "object":("date":1529668584،"from_id":89846036،"id":1522،"out":1،"peer_id":89846036،"text":"ذهبي" Fish"،conversation_message_id":305،"fwd_messages":،important":false،random_id":0،attachments":،payload":"(\"animals\":\"Goldfish\")" "is_hidden":خطأ)،"group_id":101461081)

هناك العديد من الحقول المثيرة للاهتمام التي يمكن معالجتها: معرف المستخدم، نص الرسالة (النص)، حمولة الزر (الحمولة).

يتم إرسال الرسائل إلى المستخدم باستخدام الطريقة إرسال الرسائل. إذا قمت بإرسال لوحة مفاتيح، فبعد كل المعلمات القياسية، تقوم بإضافة معلمة لوحة المفاتيح، التي تحتوي على json للأزرار، وهذا هو الشكل الذي تبدو عليه:

لوحة المفاتيح: ( "one_time": false، "buttons": [ [( "action": ( "type": "text"، "payload": "(\"button\": \"1\")"، " label": "أحمر"، "اللون": "سلبي" )، ( "action": ( "type": "text"، "load": "(\"button\": \"2\)" , " label": "أخضر")، "اللون": "إيجابي" )]

العمل مع المكتبة

لتشغيل الروبوت، نستخدم مكتبة مكتوبة ذاتيًا بلغة PHP. (إذا كان الرابط لا يعمل، فهذا هو الأرشيف) يمكنك العثور على وثائق المكتبة وتنزيل المكتبة نفسها. فيما يلي قائمة قصيرة بالوظائف الجاهزة لكتابة الروبوت، ابحث عن مزيد من التفاصيل على الرابط أعلاه. إذا كنت تريد أن تعرف عن التغييرات في المكتبة، فاكتب رسالة واحدة على الأقل إلى موقعنا بوت على VK، ومن خلاله سنقوم بإعلامك بالتغييرات.

$vk = new vk_api(vk_key, version_api) — تهيئة الروبوت. المعلمات: مفتاح المجتمع (vk_key)، إصدار API (version_api).

sendMessage(id, text) - وظيفة إرسال الرسائل إلى المستخدم. المعلمات: معرف المستخدم (معرف)، نص الرسالة (نص).

sendImage(id, patch) - وظيفة إرسال الصور. المعلمات: معرف المستخدم (المعرف)، المسار إلى الصورة (التصحيح).

sendButton(id, text, Buttons, one_time) - وظيفة إرسال رسالة تحتوي على أزرار. المعلمات: معرف المستخدم (المعرف)، نص الرسالة (لا يمكن أن يكون فارغًا) (نص)، مصفوفة بها أزرار (أزرار)، معلمة اختيارية لمرة واحدة، خطأ افتراضيًا، إذا تم التعيين على "صحيح"، ثم بعد الضغط على أي زر، ستختفي لوحة المفاتيح.

request(method, array_arguments) هي دالة عالمية للتعامل مع الأساليب. المعلمات: الطريقة - اسم الطريقة من واجهة برمجة التطبيقات الرسمية، array_arguments - مجموعة من المعلمات.

sendOK() — دالة بيتا. يُستخدم بدلاً من صدى "موافق"، فهو يساعد في الحالات التي يستغرق فيها تشغيل البرنامج النصي وقتًا طويلاً ويبدأ الروبوت في تكرار الرسائل عدة مرات.
هام: إذا كنت تستخدم هذه الوظيفة، فلن ترى مخرجات خطأ. عند التصحيح، استبدله بـ echo "ok"

كود بوت كامل في PHP

الآن دعنا ننتقل إلى الكود نفسه، حيث يتم التعليق على كل سطر تقريبًا.
هذا الكود مدعوم على PHP 5.6+
في كتلة CONFIG، حدد مفتاح الوصول إلى المجتمع ومفتاح تأكيد الخادم وإصدار واجهة برمجة التطبيقات (API) الذي اخترته.

"الأسماك"]، "ما هي الأنواع الموجودة؟"، "الأزرق"]؛ //رمز زر "السمكة" const BTN_BACK = [["command" => "start"], "<< Назад", "red"]; // Код кнопки "<< Назад" const BTN_SALMON = [["animals" =>"Pink_salmon"]، "سمك السلمون الوردي"، "أبيض"]؛ // رمز زر "السلمون الوردي" const BTN_GOLDFISH = [["animals" => "Goldfish"], "Goldfish", "blue"]; // رمز زر "السمكة الذهبية" const BTN_PLOTVA = [["animals" => "Plotva"], "Roach", "green"]; // رمز زر "Roach" $vk = new vk_api(VK_KEY, VERSION); // إنشاء مثيل لفئة للعمل مع واجهة برمجة التطبيقات، ويقبل مفتاح واجهة برمجة التطبيقات والإصدار $data = json_decode(file_get_contents("php://input")); // يستقبل ويفك تشفير JSON الذي جاء من VK if ($data->type == "confirmation") ( // إذا طلب vk خروج مفتاح (ACCESS_KEY)؛ // أكمل البرنامج النصي عن طريق إرسال المفتاح) $vk-> sendOK(); // أخبر vk أننا قبلنا رد الاتصال if (isset($data->type) و $data->type == "message_new") (// تحقق مما إذا كانت هذه الرسالة من المستخدم $id = $data->object - >from_id; // احصل على معرف المستخدم الذي كتب الرسالة $message = $data->object->text; ->peer_id; // احصل على معرف النظير للدردشة التي جاءت منها الرسالة else $peer_id = $id if (isset($data->object->payload))( // احصل على الحمولة $payload = json_decode($; data->object->payload, True )); else ( $payload = null; ) if (isset($payload["command"]) أو mb_strtolower($message) == "start") ( // إذا كانت البداية تم الضغط على الزر أو<< назад $vk->sendButton($peer_id, "هل تريد رؤية السمكة؟", []); // أرسل الزر إلى المستخدم ) else ( if ($payload != null) ( // في حالة وجود الحمولة التبديل ($payload["animals"]) ( // انظر إلى ما يوجد في حالة أزرار الحمولة "Fish": // إذا كان هذا هو Fish $vk->sendButton($peer_id, "هذه هي الأشياء التي تختارها"، [ // أرسل الأزرار إلى المستخدم، ]); case "Pink_salmon": // إذا كان هذا هو Pink Salmon $vk->sendMessage($peer_id, "احتفظ بسمك السلمون الوردي!"); // أرسل رسالة $vk->sendImage($peer_id, "img/pink_salmon.jpg"); Goldfish": //إذا كانت هذه سمكة ذهبية $vk->sendMessage( $peer_id, "سوف تلبي رغباتك..."); $vk->sendImage($peer_id, "img/goldfish.jpg");break ; case "Plotva": // إذا كان هذا هو Roach $vk->sendMessage( $peer_id, "أوه، يبدو أن الصورة مختلطة)"); $vk->sendImage($peer_id, "img/plotva. jpg"); استراحة;

الآن أنت تعرف كيفية عمل الكود ويمكنك تخصيصه بما يناسبك.

لنبدأ!

قم بتحميل البرنامج النصي والمكتبة إلى الخادم. انتقل الآن إلى علامة التبويب Callback API في الإعدادات، وأدخل المسار إلى البرنامج النصي الخاص بك في حقل العنوان وانقر فوق تأكيد. إذا فعلت كل شيء بشكل صحيح، فستظهر علامة اختيار خضراء بجوار العنوان.

التعليمات:

سؤال: لا شيء يعمل على الإطلاق!
الجواب: إذن فقد أخطأوا في مكان ما. أعد قراءة المقالة بعناية مرة أخرى وتحقق مما إذا كنت قد فعلت كل شيء. أي خطوة إلى اليسار يمكن أن تؤدي إلى خطأ.

سؤال: كل شيء يعمل بالنسبة لي، ولكن لا يتم إرسال الصور.
الإجابة: تحقق مما إذا كنت قد قمت بإضافة مجلد img بالصور. وأيضًا، ربما تستخدم خادمًا لا يدعم cURL.

سؤال: لقد غيرت الإصدار إلى 5.78 أو أي شيء آخر. لا شيء يعمل بالنسبة لي.
الإجابة: استخدم إصدارات API أخرى بخلاف 5.80 على مسؤوليتك الخاصة. على سبيل المثال، في الإصدار 5.78، تأتي أسماء المتغيرات المختلفة من VK (على سبيل المثال، بدلاً من الكائن->النص يوجد كائن->النص)، لذلك يتعطل البرنامج النصي. ابحث عن جميع تغييرات واجهة برمجة التطبيقات

يحظى موقع VKontakte بشعبية كبيرة، وهذا هو السبب في أنه لا يتم تسجيله فقط على الأشخاص العاديين، ولكن أيضًا نجوم الأعمال والمطربين والممثلين. إنهم وجوه مشهورة ومعروفة، ولا يحرمون من المعجبين في الواقع وفي الواقع الشبكة الاجتماعية. عدد أصدقائهم الحقيقيين على فكونتاكتي ليس كبيراً، لكن ماذا نفعل ببقية التطبيقات التي تقدم الصداقة؟! يحلم معظم مستخدمي الشبكة بالحصول على حالة النجم والعديد من الأصدقاء، وبالتالي يرغب الكثيرون في معرفة كيفية إنشاء اشتراك Vkontakte؟

هذه الخدمةمتاح للجميع ولا يتطلب أي تكاليف إضافية أو إجراءات خاصة مرهقة. هناك عدة طرق لإنشاء اشتراك في صفحتك.

الأشخاص الذين يتابعونك هم المشتركون في قناتك. يظهر رقمهم أسفل الصورة الرئيسية للصفحة مباشرةً. يبدو أن هؤلاء الأشخاص "يقرأونك" - حيث يتم عرض تغييراتك وأخبارك في خلاصتهم.

يظهر الأشخاص والصفحات التي تتابعها على الجانب الأيسر أسفل قائمة أصدقائك مباشرةً. يمكنك أيضًا عرض أخبارهم وتحديثاتهم على خلاصتك. في أي وقت، إذا لم يعجبك شيء ما، يمكنك إلغاء الاشتراك في أي نوع من المعلومات الواردة منهم.

كيفية إنشاء اشتراك فكونتاكتي عن طريق الحذف؟

من أجل القيام بهذا الإجراء، ما عليك سوى الانتقال إلى القسم مع أصدقائك وحذف هؤلاء الرفاق الذين تريد نقلهم إلى المشتركين. سوف يشترك الأصدقاء المحذوفون تلقائيًا في تحديثاتك. الطريقة شائعة ولكنها ليست فعالة جدًا. بعد كل شيء، من خلال محاولة الحصول على أكبر عدد ممكن من المشتركين، يمكنك إزالة شخص مهم بالنسبة لك من قائمة أصدقائك.

كيفية إنشاء اشتراك فكونتاكتي عند التقديم كصديق؟

يتلقى أي شخص، حتى ليس مستخدم الشبكة الاجتماعية الأكثر اجتماعية وشعبية، طلبات صداقة من أشخاص آخرين. للبعض في كثير من الأحيان، للآخرين في كثير من الأحيان. قد يكون هؤلاء رفاقًا، مجرد معارف وأشخاص مجهولين. يعتمد الأمر عليك فقط على من سيصبح صديقك. كيفية عمل اشتراك فكونتاكتي بهذه الطريقة؟ انها بسيطة للغاية! في المرة القادمة التي تتلقى فيها طلبًا من شخص لا يثير اهتمامك، سيكون لديك زرين أمامك: "قبول كصديق" و"الاحتفاظ كمشترك". اختر الخيار الثاني - وسيصبح الشخص مشتركًا لديك تلقائيًا.

كيفية إنشاء اشتراك فكونتاكتي باستخدام الإعدادات؟

هذا الخيار مناسب للأشخاص الذين لا يحبون إجراء عمليات معالجة غير ضرورية. انتقل إلى صفحتك في قائمة الإعدادات وانتقل إلى قسم "الخصوصية". من بين كل ما هو مقترح، ابحث عن العمود المسمى "من يمكنه إضافتي كصديق" وقم بتصحيح الوضع إلى "أصدقاء الأصدقاء". وبالتالي، لن يتمكن سوى الأشخاص الذين تعرفهم إلى حد ما على الأقل من تقديم الطلبات، وسيتم تصفية الباقي تلقائيًا إلى مشتركين.

يعتمد مكانك في عمليات بحث الأشخاص على عدد مستخدمي الشبكات الاجتماعية الذين يتابعونك. لا أحد في مأمن من التحول إلى مشتركين، لذلك هناك أيضا وظيفة مثل "إلغاء الاشتراك" من شخص ما.

كيفية إنشاء حدث "فكونتاكتي"؟

من أجل تنظيم اجتماع VKontakte أو اجتماع أو الذهاب إلى أي حدث، ما عليك سوى الانتقال إلى قسم "مجموعاتي"، الموجود على اليسار في قائمة المستخدم. سيتم فتح قائمة بمجموعاتك واجتماعاتك. يوجد في الزاوية اليمنى العليا نقش "إنشاء مجموعة/مجتمع"، لذا يجب عليك النقر عليه. في النافذة التي تظهر، سيتم عرض ثلاثة خيارات لتطوير الأحداث: إنشاء مجموعة أو صفحة عامة أو حدث. اختر الوظيفة الأخيرة وقم بإنشاء الحدث الذي تحتاجه.

لا توجد قيود صارمة على المجموعات التي تم إنشاؤهاولا توجد أحداث. ومع ذلك، إذا كان "المحتوى" الخاص بك يحتوي على معلومات من المعروف أنها تضر المستخدمين، فسيتم إغلاقه أو حذفه ببساطة. على أية حال، كل ما يحدث على شبكة التواصل الاجتماعي "فكونتاكتي" يجب ألا يتجاوز القانون.

من المهم جدًا، بالإضافة إلى التصميم المرئي، إضافة زر إجراء وجدول العمل وعناوين جميع المكاتب. بفضل هذا، سيتمكن الزوار من معرفة ذلك بسرعة المعلومات الضروريةحول الموقع وساعات العمل والاتصال بك على الفور.

سنخبرك في هذه المقالة ما هو زر إجراء فكونتاكتي وكيفية تكوينه وكيفية تحديد وضع التشغيل وإضافة عدة عناوين.

زر الإجراء هو زر للاتصال السريع. اتصل أو أرسل رسالة أو اشتري أو انتقل إلى الموقع.

لإعداد زر إجراء في VK، انتقل إلى إعدادات المجتمع الخاص بك وقم بالتمرير لأسفل. مقابل السطر "زر الإجراء" - انقر فوق "تمكين".

أدناه، في عنصر "نوع الإجراء"، حدد أحد الخيارات:

• الكتابة بالبريد
• إجراء مكالمة هاتفية؛
• اتصل بـ VK؛
• افتح الموقع
• فتح تطبيق المجتمع.
• افتح تطبيق الهاتف المحمول.

حدد العنصر المطلوب. على سبيل المثال، حدد "فتح موقع الويب".

بعد ذلك، تحتاج إلى تحديد عنوان الموقع واختيار اسم الزر. يوجد على الزر الخاص بنا نقش "مزيد من التفاصيل".

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

لإضافة أو تغيير عنوان الشركة، انتقل إلى "الإعدادات - العناوين". مقابل حقل "العناوين"، قم بتعيين "ممكّن". ووضع علامة اختيار في حقل "إظهار الخريطة" حتى يتم عرض خريطة بالعناوين في المجموعة ويمكنك معرفة مكانك.

أضف العناوين التي تقع فيها مكاتبك أو مكاتبك التمثيلية. المكتب الرئيسي، عند الإضافة، ضع علامة "هذا هو العنوان الرئيسي".

عندما يقوم مستخدم بعرض مجموعة، ستعرض القائمة العنوان الأقرب للمستخدم الآن. لإضافة أكثر من عنوان، في نفس علامة التبويب "العناوين"، انقر فوق "إضافة عنوان" أدناه.

يمكنك تحديد جدول العمل في VK لكل فرع على حدة. للقيام بذلك، سواء عند إضافة عنوان أو بعده، افتحه في الإعدادات وفي حقل "ساعات العمل" حدد "فتح خلال ساعات محددة".

ولكل يوم من أيام الأسبوع نحدد ساعات العمل. وأخيرا، انقر فوق "حفظ".

إذا كنت ترغب في حذف أحد العناوين، فيجب النقر فوق "تحرير" مقابله وفي الجزء السفلي من النافذة التي تظهر، ابحث عن "حذف" وانقر عليه.

خاتمة

عند إنشاء وتصميم مجتمع فكونتاكتي، استخدم جميع إمكانيات الصفحات للأعمال. وهذا سيجعل الترويج أكثر فعالية. وعلى وجه الخصوص، قم بإنشاء زر إجراء، وأضف جميع العناوين وساعات العمل.