‏منصة Messenger‏

روابط m.me

يعرض هذا المستند كيفية إنشاء روابط m.me للتجربة التي توفرها في Messenger.

m.me هي خدمة عنوان URL توفرها Meta حيث تعيد توجيه الأشخاص إلى شخص محدد أو صفحة أو محادثة في Messenger. يمكنك استخدامها على موقعك على الويب والنشرات الإخبارية عبر البريد الإلكتروني والمزيد.

طريقة العمل

يكون تنسيق رابط m.me كما يلي حيث PAGE-NAME هي صفحة فيسبوك المرتبطة بتطبيق المراسلة.

http://m.me/PAGE-NAME

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

يمكنك إضافة المعلمة text لتضمين رسالة مخصصة أيضًا.

http://m.me/PAGE-NAME?text=Hello%20and%20Welcome

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

عندما ينقر شخص ما على زر "بدء الاستخدام" لبدء محادثة مع نشاطك التجاري، يتم إرسال إشعار webhook بحدث messaging_postbacks إلى خادم أحداث webhooks. كجزء من إشعار webhook هذا، سيحتوي الكائن postback على كائن referral يتضمن المعلمة ref.

عندما ينقر شخص ما على رابط m.me وتكون هناك محادثة قائمة بالفعل بين النشاط التجاري والشخص، سينقله الرابط إلى المحادثة القائمة. وسيؤدي هذا الإجراء إلى إعادة تعيين نافذة المراسلة القياسية التي تبلغ 24 ساعة، مما يتيح لتطبيق المراسلة الرد على الشخص وسيتم إرسال إشعار webhook بحدث messaging_referrals إلى خادم أحداث webhooks. كجزء من إشعار webhook هذا، سيتم تضمين معلمة ref من رابط m.me.

معلمات الإحالة

يمكن أن يحتوي رابط m.me على المعلمة ref بحيث عندما ينقر شخص ما على الرابط، تزود نشاطك التجاري بمزيد من المعلومات حول المحادثة مثل رابط على موقع الويب مقابل رابط في متجر. يمكن أن توجه هذه الأنواع من الروابط أيضًا الشخص إلى محتوى أو ميزات معينة متوفرة ضمن تجربة Messenger.

http://m.me/PAGE-NAME?ref=REF-PARAMETER-INFORMATION

رموز QR

يمكن تضمين روابط m.me التي تحتوي على المعلمات ref في رموز QR. يمكن مسح رموز QR المتوافقة باستخدام كاميرا الهاتف الأصلية. عند مسحها ضوئيًا، سيتم فتح تطبيق Messenger والمحادثة القائمة مع نشاطك التجاري.

مثال على رمز QR

يتم تشفير الرابط http://m.me/OriginalCoastClothing?ref=summer_coupon في مثال رمز QR والذي سيعمل على تشغيل مثال حول قسيمة خصم على Messenger.

إشعار Webhook

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

بدء محادثة

عندما ينقر شخص ما على زر "بدء الاستخدام" لبدء محادثة مع النشاط التجاري، سنرسل المعلمة ref كجزء من إشعار webhook لحدث messaging_postbacks.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "postback":{
    "payload":"POSTBACK-PAYLOAD-YOU-CONFIGURED",
    "referral": {
      "ref": "REF-PARAMETER-INFORMATION",
      "source": "SHORTLINK",
      "type": "OPEN_THREAD",
    }
  }
}

المتابعة في محادثة قائمة بالفعل

إذا كانت هناك محادثة قائمة بالفعل بين نشاطك التجاري والشخص الذي نقر على رابط m.me، فسيتم إرسال إشعار webhook بحدث messaging_referrals.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "referral": {
    "ref": "REF-PARAMETER-INFORMATION",
    "source": "SHORTLINK",
    "type": "OPEN_THREAD",
  }
}

قبل البدء

يفترض هذا الدليل أنك قد قرأت نظرة عامة على منصة Messenger ونفذت المكونات اللازمة لإرسال الرسائل والإشعارات وتلقيها.

ستحتاج إلى ما يلي:

  • إمكانية الوصول المتقدم للتطبيق المرتبط بصفحة فيسبوك للنشاط التجاري
  • زر "بدء الاستخدام" لتجربة Messenger التي توفرها للمحادثات الجديدة
  • يجب تسجيل اشترك التطبيق المرتبط بصفحة فيسبوك لنشاطك التجاري في حقلي webhooks للحدث messaging_postbacks والحدث messaging_referrals

التقييدات

  • لا يمكن للتطبيقات التي تتمتع بالوصول القياسي الحصول على المعلومات سوى من الأشخاص الذين لديهم دور مطوّر أو مختبر أو مسؤول في تطبيق المراسلة

طلبات الاشتراك في الرسائل التسويقية

يسمح لك عنوان URL m.me/rn بإنشاء طلب الاشتراك في الإشعار المتكرر من خلال رابط m.me. يجب أن يتضمن تنسيق رابط m.me/rn موضوع الإشعار المتكرر. يمكنك تعيين معدل إرسال الإشعار المتكرر، وبخلاف ذلك سيتم تعيينه افتراضيًا على المعدل اليومي.

http://m.me/rn/PAGE-NAME?topic=TOPIC&cadence=MESSAGE-FREQUENCY

التقييدات

  • يلزم توفير الإصدار 383 من iOS حت تعمل روابط m.me/rn بشكل سليم. ستتم إعادة توجيه الشخص الذي قام بالنقر على الرابط إلى عنوان URL m.me الأساسي، عنوان URL http://m.me/PAGE-NAME

مثال على رابط الرسائل التسويقية

https://m.me/rn/OriginalCoastClothing?topic=weekly%20deals&cadence=weekly

تسجيل الموضوع

قبل أن تتمكن من استخدام عنوان URL m.me/rn بموضوع جديد، يجب أولاً تسجيل الموضوع الجديد.

إذا كنت تستخدم موضوعًا قمت باستخدامه في عنوان URL m.me/rn سابق واشترك الأشخاص لتلقي الإشعارات المتكررة، فلن تحتاج إلى تسجيل الموضوع مجددًا.

يمكنك تسجيل الموضوع الجديد من خلال اتباع الخطوات التالية:

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

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
          "title":"TITLE",
          "payload": "Registering a new topic: TOPIC-NAME",
          "notification_messages_frequency": MESSAGE-FREQUENCY,
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

عند نجاح العملية، يتلقى تطبيقك استجابة JSON التالية:

{ 
        "recipient": {
          "id":"PSID",
          "message_id":"MESSAGE-ID",
}

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

تتم إعادة توجيه الشخص الذي ينقر على رابط m.me/rn ضمن موضوع لم يتم تسجيله إلى عنوان URL الإشعار المتكرر الأساسي، عنوان URL http://m.me/rn/PAGE-NAME.

عند تسجيل موضوع ما، إذا أرسلت إلى نفسك طلب اشتراك ولكن لم تنقر على زر الاشتراك، فلن يتم تسجيل الموضوع.

عينة من الطلب

تم التنسيق لإمكانية القراءة.
curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

عند نجاح العملية، سيتلقى تطبيقك استجابة JSON التالية:

{ "success": true }

إشعار Webhook messaging_optins

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

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
    "title": "TITLE-FOR-NOTIFICATION-MESSAGE",
    "ref": "REF-PARAMETER-INFORMATION",
    "payload": "",
    "source":"SHORTLINK"
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
    "notification_messages_topic": "RECURRING-NOTIFICATION-TOPIC", 
    "notification_messages_frequency": "MESSAGE-FREQUENCY",
    "notification_messages_timezone": "TIMEZONE-ID",
    "token_expiry_timestamp": "TIMESTAMP",
    "user_token_status": "TOKEN-STATUS"
    }
}

مرجع m.me

اسم المعلمةالوصف

cadence

enum (تعداد) { daily, monthly, weekly }

معدل تكرار الرسالة لطلب الاشتراك في رابط m.me/rn. يتم التعيين افتراضيًا على القيمة daily.

ref

string (سلسلة)

سياق المحادثة، مثل رابط على موقع الويب مقابل الرابط في المتجر والذي يتم تسليمه في إشعار webhook messaging_referrals. يجب أن تكون هذه المعلمة بتشفير عنوان URL عند استخدامها في روابط m.me. لا يمكن أن يتجاوز طول هذه القيمة 2,083 حرفًا

text

string (سلسلة)

الرسالة المخصصة التي ترسلها عندما ينقر الشخص على رابط m.me لدخول محادثة.

topic

string (سلسل) 		مطلوب.

موضوع طلب الاشتراك في رابط m.me/rn، العروض الترويجية الأسبوعية أو الإصدارات القادمة. يجب أن تكون هذه المعلمة بتشفير عنوان URL عند استخدامها في روابط m.me. يتم استخدام حروف وأرقام ولا توجد حروف خاصة ويكون عنوان URL مشفرًا.

الخطوات التالية

راجع أيضًا