کارت پرواز را به Google Wallet اضافه کنید

می‌توانید از «پیام‌های Google» با RCS و Google Wallet برای طراحی یک جریان ورود یکپارچه استفاده کنید: کاربر اعلام حضور خود را کامل می‌کند، کارت پرواز خود را دریافت می‌کند و آن را مستقیماً از برنامه پیام‌ها به Google Wallet اضافه می‌کند. هنگامی که در کیف پول آنها قرار می گیرند، در صورت تغییر جزئیات پرواز، مجوز به طور خودکار به روز می شود. کاربران دسترسی سریع به کارت پرواز به‌روز را مستقیماً در تلفن خود دارند.

این سند مراحل فنی برای پیاده‌سازی کارت پرواز در Google Wallet را توضیح می‌دهد. همچنین دارای یک مکالمه نمونه با نکات طراحی برای یک تجربه بررسی روان و کارآمد با RBM است.

پیاده سازی فنی

برای پیاده سازی کارت پرواز در جریان Google Wallet، با Google Wallet API و RBM API کار خواهید کرد.

پیش نیازها

برای شروع کار با Google Wallet API، این مراحل لازم را دنبال کنید:

  1. برای یک حساب صادرکننده Wallet ثبت نام کنید تا بتوانید مجوزهای Google Wallet را ایجاد و توزیع کنید.
  2. اگر قبلاً ندارید، یک پروژه Google Cloud Platform (GCP) ایجاد کنید.
  3. Google Wallet API را فعال کنید.
  4. یک حساب و کلید سرویس ایجاد کنید تا بتوانید با Google Wallet API تماس بگیرید.
  5. حساب سرویس را در Google Pay و Wallet Console مجاز کنید.
  6. برای ایجاد کلاس Boarding جدید از الگوی کارت پرواز استفاده کنید.

Google Wallet API

برای ایجاد کارت پرواز و ایجاد URL Add to Google Wallet برای RBM، این مراحل را دنبال کنید:

  1. احراز هویت و مجوزهای لازم را انجام دهید.
  2. یک شی Passes ایجاد کنید.
  3. یک نشانه وب JSON (JWT) امضا شده دریافت کنید. حداکثر طول JWT کدگذاری شده 2048 کاراکتر است.
  4. از JWT برای ایجاد URL Add to Google Wallet استفاده کنید.

RBM API

برای ارسال پیشنهاد افزودن به Google Wallet از RBM، یک اقدام URL باز ارسال کنید. در payload پیام، موارد زیر را انجام دهید:

  1. برای text ، «افزودن به Google Wallet» را وارد کنید.
  2. برای url ، URL افزودن به Google Wallet را وارد کنید.

نماد Google Wallet به طور خودکار روی برچسب پیشنهاد نشان داده می شود.

نماد Google Wallet در پیشنهاد افزودن به Google Wallet

طراحی مکالمه

این نمونه از قدرت منحصر به فرد مکالمه استفاده می کند تا کاربران را از طریق جریان ورود کامل راهنمایی کند. این نشان می‌دهد که چگونه می‌توانید از گفتگوی طبیعی و ویژگی‌های غنی، مانند پیشنهادات با یک ضربه و کارت‌های غنی، برای کمک به کاربران برای رسیدن به اهداف خود استفاده کنید. در این مورد اهداف آنها عبارتند از: (1) سفارشی کردن تجربه پرواز من، (2) دریافت کارت پرواز من، و (3) افزودن آن به Google Wallet برای دسترسی آسان در فرودگاه.

در زیر مروری بر این گفتگو است. با نکات طراحی و تجزیه گام به گام جریان دنبال می شود. برای پیاده سازی طرح مشابه برای نماینده خود، نمونه کدهای زیر مراحل را ببینید.

نمودار گفتگو

مشاوره طراحی

هنگام طراحی جریان ورود خود به این اصول توجه داشته باشید:

  • اولین پیام شما مهمترین است. به طور خلاصه هدف مکالمه را بیان کنید تا کاربر دلیلی برای مشارکت داشته باشد.
  • هر پیام باید بخش کوچکی از اطلاعات را ارائه دهد و کاربر را وادار به پاسخگویی کند. پاسخ‌های پیشنهادی و اقدامات پیشنهادی، برداشتن گام بعدی را آسان می‌کند.
  • نماینده شما باید پاسخگو باشد نه رباتیک. از زبانی استفاده کنید که لحن صدای برند شما را منعکس کند. نماینده برند ایده آل شما چگونه با مشتری چت می کند؟
  • مردم دوست دارند احساس خاص بودن کنند. می‌توانید با پیشنهاد صندلی یا وعده‌های غذایی بر اساس سابقه پرواز کاربر، تجربه ورود را شخصی کنید.
  • کارت‌ها و چرخ فلک‌های غنی، مکالمه را پویاتر می‌کنند. از آنها برای اشتراک گذاری تصاویر و جزئیات استفاده کنید که به کاربر کمک می کند تا از بین گزینه ها انتخاب کند.
  • یک مکالمه خوب به خوبی به پایان می رسد. قبل از ارسال کارت پرواز، جزئیات ورود کاربر را تأیید کنید. با ارسال دوستانه، یک تماس انسانی اضافه کنید.

جریان ورود

  1. نماینده به کاربر اطلاع می دهد که ورود به پرواز او باز است.

    پیام تبریک با جزئیات ورود و پاسخ های پیشنهادی

    نمونه کد

    const suggestions = [
  {
    reply: {
      text: '⚡ Check in',
      postbackData: 'checkIn',
    },
  },
  {
    reply: {
      text: '⏰ Remind me later',
      postbackData: 'remindMe',
    },
  },
  {
    reply: {
      text: '✈️ View my flight details',
      postbackData: 'flightDetails',
    },
  },
  {
    reply: {
      text: '🔀 Change my flight',
      postbackData: 'flightChange',
    },
  },
];  

const params = {
  messageText: 'Check-in for your flight',
  messageDescription: '👏 Happy morning, Jo! Check-in is now open for your flight from London to Mumbai on ' + getFlightTime() + ' at 2:00PM. What would you like to do? ',
  msisdn: phoneNumber,
  suggestions: suggestions,
  imageUrl: getImageUrl('fly.png'),
  height: 'MEDIUM',
};  

rbmApiHelper.sendRichCard(params);

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

    پیشنهاد برای اعلام حضور ضربه زده می شود

  3. نماینده انتظارات را برای فرآیند ورود تعیین می کند.

    در پیام آمده است: خوب، عالی است. این فقط 3 مرحله ساده برای ورود است. این اولین قدم برای سوار کردن شما است

    نمونه کد

    const params = {
  messageText: "OK, great. It's just 3 simple steps to check in. Here's the first step to get you onboard:",
  msisdn: msisdn,
};  

let self = this;

rbmApiHelper.sendMessage(params, function (response, err) {
  self.sendPolicyImage(msisdn);
});

  4. نماینده از کاربر می خواهد که با خط مشی ایمنی موافقت کند.

    کارت غنی با اینفوگرافیک خط مشی ایمنی و پیشنهاداتی برای موافقت یا مخالفت. متن روی کارت می‌گوید: برای کمک به ما در اطمینان از پرواز ایمن، لطفاً خط‌مشی ایمنی ما را مرور کنید و به ما اطلاع دهید که موافق هستید.

    نمونه کد

    const suggestions = [
  {
    reply: {
      text: 'Yes, I agree',
      postbackData: 'policy_agree',
    },
  },
  {
    reply: {
      text: "No, I don't agree",
      postbackData: 'policy_nack',
    },
  },
];  

const params = {
  messageText: 'Baggage safety policy',
  messageDescription: 'To help us ensure a safe flight, please review our safety policy and let us know you agree',
  msisdn: msisdn,
  suggestions: suggestions,
  imageUrl: getImageUrl('policyImage.png'),
  height: 'MEDIUM',
  orientation: 'HORIZONTAL',
  thumbnailImageAlignment: 'LEFT',
};  

rbmApiHelper.sendRichCard(params);

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

    پیشنهاد موافقت مورد بررسی قرار می گیرد

  6. نماینده از کاربر تشکر می کند و مرحله بعدی را معرفی می کند.

    در پیام آمده است: ممنون، مسافر ایمن، مسافر شادی است! در اینجا مرحله بعدی است

    نمونه کد

    const params = {
  messageText: "Thank you - A safe passenger is a happy passenger! Here's the next step:",
  msisdn: msisdn,
};

let self = this;

rbmApiHelper.sendMessage(params, function (response, err) {
  self.sendPlan(msisdn);
});

  7. نماینده از کاربر می خواهد یک صندلی را انتخاب کند.

    کارت غنی با اینفوگرافیک نقشه صندلی. متن روی کارت می گوید: وقت آن است که بنشینید و راحت باشید! ما بر اساس آخرین پرواز شما چند صندلی را توصیه کرده‌ایم. صندلی مورد نظر خود را انتخاب کنید یا با تایپ شماره، صندلی مورد نظر خود را به ما اطلاع دهید. پیشنهادات زیر کارت چند گزینه صندلی را نشان می دهد

    نمونه کد

    const suggestions = [
  {
    reply: {
      text: 'View the seat map',
      postbackData: 'view_seat_map',
    },
  },
];

const outerSuggestions = [
  {
    reply: {
      text: '17A',
      postbackData: 'seat_17A',
    },
  },
  {
    reply: {
      text: '17C',
      postbackData: 'seat_17C',
    },
  },
  {
    reply: {
      text: '18A',
      postbackData: 'seat_18A',
    },
  },
  {
    reply: {
      text: 'Show me more',
      postbackData: 'more',
    },
  },
];  

const params = {
  messageText: 'Choose your seat',
  messageDescription: "It's time to sit back and get comfy! 💺 We've recommended some seats based on your last flight. Choose the one you want, or let us know your preferred seat by typing the number.",
  msisdn: msisdn,
  imageUrl: getImageUrl('seatMap.png'),
  height: 'TALL',
  orientation: 'VERTICAL',
  outerSuggestions: outerSuggestions
};  

rbmApiHelper.sendRichCard(params);

  8. کاربر روی یک پاسخ پیشنهادی برای صندلی انتخابی خود ضربه می زند.

    پیشنهاد برای صندلی 18A شنود شده است

  9. نماینده انتخاب کاربر را تایید می کند.

    در پیام آمده است: صندلی 18A، متوجه شدید.

    نمونه کد

    this.seatmap[msisdn] = seat;  

const params = {
  messageText: `Seat ${seat}, you got it`,
  msisdn: msisdn,
};  

let self = this;  
  rbmApiHelper.sendMessage(params, function(res) {
    self.sendFoodOptions(msisdn);
});

  10. نماینده از کاربر می خواهد که وعده غذایی خود را در طول پرواز انتخاب کند.

    در پیام آمده است: حالا بیایید در مورد غذا صحبت کنیم. می توانید غذای خود را در طول پرواز از قبل سفارش دهید. آیا از یک غذای گیاهی خوشحال می شوید یا یک غذای مرغ؟

    نمونه کد

    const params = {
  messageText: `Now let's talk food 😋 You can pre-order your in-flight meal. Would you be happy with a vegetarian entree or a chicken entree?`,
  msisdn: msisdn,
};  

let self = this;  

rbmApiHelper.sendMessage(params, function(res) {
  self.sendFoodDetails(msisdn);
});

  11. نماینده گزینه های غذایی را نشان می دهد.

    چرخ فلک کارت غنی دو کارت را نشان می دهد: یکی با تصویر سالاد و دیگری با تصویر مرغ کباب. هر دو کارت دارای فهرست مواد اولیه و پیشنهادی برای انتخاب آن وعده غذایی هستند

    نمونه کد

    const cardContents = [
  {
    title: 'Panzanella salad (v)',
    description: 'Ingredients: bread, lettuce, onions, tomatoes, olive oil',
    suggestions: [
      {
        reply: {
          text: 'Choose vegetarian',
          postbackData: 'veggie',
        },
      },
    ],
    media: {
      height: 'MEDIUM',
      contentInfo: {
        fileUrl: getImageUrl('salad.jpg'),
      },
    },
  },
  {
    title: 'Grilled chicken with greens',
    description: 'Ingredients: chicken, potatoes, peppers, olive oil',
    suggestions: [
      {
        reply: {
          text: 'Choose chicken',
          postbackData: 'chicken',
        },
      },
    ],
    media: {
      height: 'MEDIUM',
      contentInfo: {
        fileUrl: getImageUrl('chicken.png'),
      },
    },
  },
];  

const params = {
  msisdn: msisdn,
  cardContents: cardContents,
};  

rbmApiHelper.sendCarouselCard(params);

  12. کاربر روی یک پاسخ پیشنهادی برای وعده غذایی انتخابی خود ضربه می زند.

    پیشنهاد برای انتخاب گیاهخواری مورد بررسی قرار گرفته است.

  13. نماینده انتخاب کاربر را تایید می کند.

    در پیام آمده است: گیاهخواری است.

    نمونه کد

    const params = {
  messageText: `Vegetarian it is 💚`,
  msisdn: msisdn,
};  

let self = this;  

rbmApiHelper.sendMessage(params, function (response, err) {
  self.sendAskConfirmation(msisdn);  
});

  14. نماینده جزئیات ورود را خلاصه می کند.

    پیام بیان می‌کند: آنچه را که یادداشت کرده‌ایم این است: شما صندلی 18A و یک غذای گیاهی را انتخاب کرده‌اید. لطفا انتخاب های خود را تایید کنید. پیشنهاداتی در زیر پیام برای تأیید جزئیات، تغییر وعده غذایی یا تغییر صندلی ظاهر می شود.

    نمونه کد

    let seat = this.seatmap[msisdn];  

const suggestions = [
  {
    reply: {
      text: "Yes, I'm happy with that",
      postbackData: 'happy',
    },
  },
  {
    reply: {
      text: 'Change my seat',
      postbackData: 'change_seat',
    },
  },
  {
    reply: {
      text: 'Change my meal',
      postbackData: 'change_meal',
    },
  },
];

const params = {
  messageText: "Here's what we've noted down: You've opted for seat " + seat + " and a vegetarian meal. Please confirm your choices.",
  msisdn: msisdn,
  suggestions: suggestions
};  

rbmApiHelper.sendMessage(params);

  15. کاربر برای تأیید جزئیات اعلام حضور، روی یک پاسخ پیشنهادی ضربه می‌زند.

    پیشنهاد برای تأیید جزئیات ضربه زده می شود

  16. نماینده اعلام می کند که چک این کامل شده است.

    در پیام آمده است: هورا! شما اکنون برای پرواز خود ثبت نام کرده اید. کارت پرواز شما اینجاست. ما بسیار خوشحالیم که به زودی میزبان شما هستیم!

    نمونه کد

    const params = {
  messageText: "Hooray! You're now checked in for your flight ☑️ Here's your boarding pass. We're so happy to host you soon!",
  msisdn: msisdn,
};  

let self = this;  

rbmApiHelper.sendMessage(params, function (response, err) {
  self.sendWalletPass(msisdn);       
});

  17. نماینده کارت پرواز کاربر را ارسال می کند.

    کارت غنی تصویری از کارت پرواز با کد QR و جزئیات پرواز را نشان می‌دهد. متن روی کارت می گوید: ما شما را در جریان خواهیم گذاشت! اگر جزئیات پروازتان تغییر کرد، اعلانی دریافت خواهید کرد. پیشنهادی روی کارت می‌گوید افزودن به کیف پول Google

    نمونه کد

    this.walletHelper.createFlightPassUrl(this.seatmap[msisdn]).then((url) => {
  let suggestions = [
    {
      action: {
        text: 'Add to Google Wallet',
        postbackData: 'addToWallet',
        openUrlAction: {
          url: url
        },
      },
    },
  ];  

  const params = {
    messageText: 'HS123 LHR to BOM\nPassenger: Jo Flow',
    messageDescription: "We'll keep you up to date! You'll get a notification if your flight details change.",
    msisdn: msisdn,
    suggestions: suggestions,
    imageUrl: getImageUrl('boardingPass.png'),
    height: 'TALL',
    orientation: 'HORIZONTAL',
    thumbnailImageAlignment: 'LEFT',
  };  

  rbmApiHelper.sendRichCard(params);
});

    در این کارت غنی افقی ، تصویر یک کارت پرواز کاملاً کاربردی است که توسط شرکت هواپیمایی ارائه شده است. تصویر باید تمام اطلاعات لازم برای سوار شدن، از جمله بارکد قابل اسکن را نمایش دهد. کاربران می توانند به سادگی روی تصویر ضربه بزنند تا کارت پرواز خود را از برنامه پیام های Google مشاهده و اسکن کنند.

    یک پیشنهاد افزودن به Google Wallet در کارت غنی ظاهر می شود. این پیشنهاد یک عمل URL را باز می کند که برنامه Google Wallet را باز می کند، جایی که کاربر می تواند به راحتی کارت پرواز را به کیف پول خود اضافه کند. (اگر برنامه در دستگاه کاربر نباشد، از او خواسته می‌شود که آن را نصب کند.) پس از اضافه شدن مجوز به Google Wallet، در صورت تغییر جزئیات پرواز، کاربر به‌طور خودکار یک یادآوری پرواز و به‌روزرسانی وضعیت دریافت می‌کند.

    کاربرانی که پاس خود را به Google Wallet اضافه نمی کنند نیز باید به روز باشند. در مورد هرگونه تغییر در اطلاعات پرواز نشان داده شده در کارت غنی به کاربر پیام دهید.

  18. کاربر برای افزودن مجوز به Google Wallet روی یک اقدام پیشنهادی ضربه می‌زند.

    نماد Google Wallet و پیشنهاد افزودن به Google Wallet

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

    برنامه کیف پول یک کارت پرواز ساده و دکمه ای را نشان می دهد که می گوید افزودن.

  20. کاربر برای مشاهده پاس خود روی دکمه ای ضربه می زند.

    علامت تیک بالای پاس نمایش داده می شود. دکمه مشاهده در Google Wallet ظاهر می شود.

  21. کارت پرواز با کد QR نشان داده شده است.

    کارت پرواز با تمام جزئیات پرواز و کد QR