Menambahkan boarding pass ke Google Wallet

Anda dapat menggunakan Message dari Google dengan RCS dan Google Wallet untuk mendesain alur check-in yang lancar: pengguna menyelesaikan check-in, menerima boarding pass mereka, dan menambahkannya langsung ke Google Wallet dari aplikasi Message. Setelah berada di dompet, kartu akan otomatis diperbarui jika detail penerbangan berubah. Pengguna memiliki akses cepat ke boarding pass terbaru langsung di ponsel mereka.

Dokumen ini menjelaskan langkah-langkah teknis untuk menerapkan boarding pass ke alur Google Wallet. Panduan ini juga menampilkan contoh percakapan dengan tips desain untuk pengalaman check-in yang lancar dan efisien dengan RBM.

Implementasi teknis

Untuk menerapkan boarding pass ke alur Google Wallet, Anda akan bekerja dengan Google Wallet API dan RBM API.

Prasyarat

Untuk memulai Google Wallet API, ikuti langkah-langkah yang diperlukan ini:

  1. Daftar untuk akun penerbit Wallet agar Anda dapat membuat dan mendistribusikan kartu untuk Google Wallet.
  2. Buat project Google Cloud Platform (GCP) jika Anda belum memilikinya.
  3. Aktifkan Google Wallet API.
  4. Buat akun dan kunci layanan agar Anda dapat memanggil Google Wallet API.
  5. Otorisasi akun layanan di Konsol Google Pay dan Wallet.
  6. Gunakan template boarding pass untuk membuat kelas Boarding baru.

API Google Wallet

Untuk membuat boarding pass dan membuat URL Tambahkan ke Google Wallet untuk RBM, ikuti langkah-langkah ini:

  1. Lakukan autentikasi dan otorisasi yang diperlukan.
  2. Membuat Objek Kartu.
  3. Mendapatkan Token Web JSON (JWT) yang ditandatangani. Panjang maksimum JWT yang dienkode adalah 2048 karakter.
  4. Gunakan JWT untuk membuat URL Tambahkan ke Google Wallet.

API RBM

Untuk mengirim saran Tambahkan ke Google Wallet dari RBM, kirim Tindakan Buka URL. Di payload pesan, lakukan hal berikut:

  1. Untuk text, masukkan "Tambahkan ke Google Wallet".
  2. Untuk url, masukkan URL Tambahkan ke Google Wallet.

Ikon Google Wallet akan otomatis ditampilkan di label saran.

Ikon Google Wallet di saran Tambahkan ke Google Wallet

Desain percakapan

Contoh ini menggunakan kekuatan percakapan yang unik untuk memandu pengguna melalui alur check-in yang lengkap. Ini menunjukkan cara Anda dapat menggunakan dialog alami dan fitur lengkap, seperti saran sekali ketuk dan kartu informasi, untuk membantu pengguna mencapai sasaran mereka. Dalam hal ini, sasaran mereka adalah: (1) menyesuaikan pengalaman penerbangan saya, (2) menerima boarding pass saya, dan (3) menambahkannya ke Google Wallet agar mudah diakses di bandara.

Berikut adalah ringkasan percakapan. Diikuti dengan tips desain dan pengelompokan alur. Untuk menerapkan desain serupa untuk agen Anda, lihat contoh kode di bawah langkah-langkahnya.

Diagram percakapan

Saran desain

Perhatikan prinsip-prinsip ini saat mendesain alur check-in Anda:

  • Pesan pertama Anda adalah yang paling penting. Jelaskan tujuan percakapan secara singkat agar pengguna memiliki alasan untuk berinteraksi.
  • Setiap pesan harus memberikan informasi kecil dan meminta pengguna untuk merespons. Balasan yang disarankan dan tindakan yang disarankan memudahkan Anda untuk mengambil langkah berikutnya.
  • Agen Anda harus responsif, bukan robot. Gunakan bahasa yang mencerminkan nada suara merek Anda. Bagaimana chat dengan perwakilan merek ideal Anda dengan pelanggan?
  • Orang-orang suka merasa istimewa. Anda dapat mempersonalisasi pengalaman check-in dengan menyarankan kursi atau makanan berdasarkan histori penerbangan pengguna.
  • Kartu informasi dan carousel membuat percakapan lebih dinamis. Gunakan fitur ini untuk berbagi gambar dan detail yang akan membantu pengguna memilih di antara opsi-opsi yang ada.
  • Percakapan yang baik berakhir dengan baik. Konfirmasi detail check-in pengguna sebelum Anda mengirim boarding pass mereka. Tambahkan sentuhan manusia dengan pengiriman yang mudah dipahami.

Alur check in

  1. Agen akan memberi tahu pengguna bahwa check in untuk penerbangan mereka dibuka.

    Pesan salam dengan detail check in dan balasan yang disarankan

    Contoh kode

    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. Pengguna mengetuk balasan yang disarankan untuk check in.

    Saran untuk check in diketuk

  3. Agen menetapkan ekspektasi untuk proses check in.

    Status pesan: Oke. Hanya 3 langkah mudah untuk check in. Berikut adalah langkah pertama untuk mengantarkan Anda

    Contoh kode

    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. Agen meminta pengguna menyetujui kebijakan keamanan.

    Kartu informasi dengan infografis kebijakan keamanan dan saran untuk menyetujui atau tidak setuju. Teks pada kartu bertuliskan: Untuk membantu kami memastikan penerbangan yang aman, tinjau kebijakan keamanan kami dan beri tahu kami bahwa Anda setuju.

    Contoh kode

    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. Pengguna mengetuk balasan yang disarankan untuk menyetujui.

    Saran untuk setuju diketuk

  6. Agen mengucapkan terima kasih kepada pengguna dan memperkenalkan langkah berikutnya.

    Status pesan: Terima kasih, penumpang yang aman adalah penumpang yang bahagia! Berikut adalah langkah selanjutnya

    Contoh kode

    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. Agen meminta pengguna memilih kursi.

    Kartu informasi dengan infografis peta tempat duduk. Teks di kartu bertuliskan: Saatnya duduk dan merasa nyaman! Kami telah merekomendasikan beberapa kursi berdasarkan penerbangan terakhir Anda. Pilih kursi yang Anda inginkan, atau beri tahu kami kursi pilihan Anda dengan mengetikkan nomornya. Saran di bawah kartu dapat menampilkan beberapa opsi tempat duduk

    Contoh kode

    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. Pengguna mengetuk balasan yang disarankan untuk kursi yang mereka pilih.

    Saran untuk kursi 18A diketuk

  9. Agen mengonfirmasi pilihan pengguna.

    Status pesan: Kursi 18A, Anda mendapatkannya.

    Contoh kode

    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. Agen meminta pengguna untuk memilih makanan yang sedang mereka terbangkan.

    Status pesan: Sekarang mari kita bicara makanan. Anda dapat melakukan praorder makanan dalam penerbangan. Apakah Anda akan puas dengan hidangan utama vegetarian atau hidangan ayam?

    Contoh kode

    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. Agen menampilkan opsi makanan.

    Carousel kartu informasi menampilkan dua kartu: satu dengan gambar salad dan satu lagi dengan gambar ayam panggang. Kedua kartu memiliki daftar bahan dan saran untuk memilih makanan tersebut

    Contoh kode

    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. Pengguna mengetuk balasan yang disarankan untuk makanan pilihan mereka.

    Saran untuk memilih vegetarian diketuk.

  13. Agen mengonfirmasi pilihan pengguna.

    Status pesan: Vegetarian.

    Contoh kode

    const params = {
      messageText: `Vegetarian it is 💚`,
      msisdn: msisdn,
    };  
    
    let self = this;  
    
    rbmApiHelper.sendMessage(params, function (response, err) {
      self.sendAskConfirmation(msisdn);  
    });
    

  14. Agen meringkas detail check in.

    Status pesan: Inilah yang telah kami catat: Anda telah memilih kursi 18A dan makanan vegetarian. Harap konfirmasi pilihan Anda. Saran akan muncul di bawah pesan untuk mengonfirmasi detailnya, mengubah makanan, atau mengubah kursi.

    Contoh kode

    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. Pengguna mengetuk balasan yang disarankan untuk mengonfirmasi detail check in.

    Saran untuk mengonfirmasi bahwa detail telah diketuk

  16. Agen mengumumkan bahwa check in selesai.

    Status pesan: Hore! Anda telah check in untuk penerbangan Anda. Ini adalah boarding pass Anda. Kami akan dengan senang hati menerima Anda.

    Contoh kode

    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. Agen mengirim boarding pass pengguna.

    Kartu informasi menampilkan gambar boarding pass yang berisi kode QR dan detail penerbangan. Teks pada kartu bertuliskan: Kami akan terus mengabari Anda! Anda akan mendapatkan notifikasi jika detail penerbangan berubah. Saran pada kartu bertuliskan Tambahkan ke Google Wallet

    Contoh kode

    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);
    }); 
    

    Dalam kartu informasi horizontal ini, gambar adalah boarding pass yang berfungsi penuh yang disediakan oleh maskapai penerbangan. Gambar harus menampilkan semua informasi boarding yang diperlukan, termasuk kode batang yang dapat dipindai. Pengguna cukup mengetuk gambar untuk melihat dan memindai boarding pass mereka dari aplikasi Message Google.

    Saran Tambahkan ke Google Wallet muncul di kartu informasi. Saran ini memicu tindakan Buka URL yang membuka aplikasi Google Wallet, tempat pengguna dapat dengan mudah menambahkan boarding pass ke dompet mereka. (Jika aplikasi tidak ada di perangkat pengguna, mereka akan diminta untuk menginstalnya.) Setelah kartu ditambahkan ke Google Wallet, pengguna akan otomatis menerima pengingat penerbangan dan pembaruan status jika detail penerbangan mereka berubah.

    Pengguna yang tidak menambahkan kartu ke Google Wallet juga harus terus mendapatkan informasi terbaru. Kirim pesan kepada pengguna tentang perubahan pada informasi boarding yang ditampilkan di kartu informasi.

  18. Pengguna mengetuk tindakan yang disarankan untuk menambahkan kartu ke Google Wallet.

    Ikon dan saran Google Wallet untuk Ditambahkan ke Google Wallet

  19. Aplikasi Google Wallet akan terbuka. Pengguna mengetuk tombol untuk menambahkan kartu ke dompet mereka.

    Aplikasi Wallet menampilkan boarding pass yang disederhanakan dan tombol yang bertuliskan Tambahkan.

  20. Pengguna mengetuk tombol untuk melihat kartu.

    Tanda centang ditampilkan di atas kartu. Tombol untuk Melihat di Google Wallet akan muncul.

  21. Boarding pass dengan kode QR ditampilkan.

    Boarding pass dengan semua detail penerbangan dan kode QR