User onboarding guide
- 1 Example Scenarios
- 2 How to Connect Users to your Rogerthat Service
Example Scenario – QR Code in Magazine Ad
A user is browsing through a magazine and spots an interesting ad on a specific type of motorbike. He takes his smartphone and scans the QR (“quick response”) code that is included in the ad. In case he does not yet have Rogerthat Messenger installed on his mobile, he is redirected to Appstore or Android Market and can install it with a single click.
Rogerthat Messenger app opens with a picture and details about the vendor of the scanned article. A button is shown “Connect to service”. The user clicks the button.
A few seconds later the user receives a message (see screenshots).
He clicks the “Yes. Please call me” button. A few minutes later a gentle salesperson calls him and explains all the technical details about the 1198 and makes an appointment for a test drive.
A user is logged in to his favourite auction site on his laptop. He is “following” a few auctioned articles. He needs to go on the road for a long drive.
On the auction site, a button is showing “Follow & Bid using Rogerthat Messenger”. The user clicks the button. He is redirected to https://rogerth.at where he signs up and/or logs in. The user is immediately connected to the Rogerthat service of his auctioning site. The user installs Rogerthat on his mobile, and he sees the auctioning service in his Service List.
He gets in his car.
He regularly gets a message that someone has placed a bid on one of the articles he is following. He sees the price go up, and sees the “time left” go down. At any time he can react on the Rogerthat message and place a bid himself.
Example Scenario – Service invites people using Rogerthat
A restaurant near an office centre gets a list of email addresses of all people working in the office centre. It sends a Rogerthat invitation to all those people with a 10% discount voucher embedded in the invitation.
People who do not have Rogerthat installed, will be redirected to https://rogerth.at and be able to sign up / log in.
People who already have Rogerthat installed, will receive this message in their Rogerthat app.
They can accept the invitation, which connects them to the Rogerthat services of the restaurant.
Every morning at 9am the restaurant sends a message to all connected users with a form to order a sandwich. On their first order they get the 10% discount.
The restaurant now has a personal communication channel to some customers. By pushing a message to them every morning, they increase their chances to get orders, since it becomes really easy for customers to order a sandwich.
How to Connect Users to your Rogerthat Service
As described in the examples, there are various ways to let your Rogerthat Service connect or interact with your users.
- User scans a Rogerthat QR Code of your service
- On your web site
- On printed media, stickers, TV ads, … you create or distribute
- Posted on social networks
- User clicks a Rogerthat Web Connect button
- Embedded in your site
- Posted on social media
- Your service invites users directly using their Rogerthat account or email address
- Users invite your service using your Rogerthat service account address
Metadata can be added to an interaction QR code, Web Connect, or regular invitation message. This can be used to
- Allow services to create many different QR codes, e.g. one per product they sell. They can print stickers or print it in magazines. Refer to the motorbike use scenario.
- Allow services to add user identification information to the QR code or web connect button, such that they can link the identity of a user in their system to the one in the Rogerthat system. Refer to the scenario about the Web Connect button
Distribute QR Codes of Your Service on Your Site or on Printed Media
We provide a default QR Code for each service. We call this the Rogerthat Passport. To get the Rogerthat passport of your service:
- Go to the Service Control Panel
- Click Edit Profile
- Click on your the thumbnail view of your Rogerthat passport
Regular users also have a Rogerthat passport. They can find it in a separate tab in the Rogerthat mobile app, or in the same way as service users do it through the menu on https://rogerth.at
Apart from the default QR Code, services can create QR Codes containing a tag to indicate that the user wants a specific action to start.
When a user scans a Rogerthat passport using a barcode reader on his mobile device, the following happens:
- If the user does not yet have the Rogerthat mobile app, he will automatically be redirected to the App Store or Android Market app, from where he can easily install Rogerthat Messenger
- If the user already has the Rogerthat mobile app installed, he will be redirected to it and get details on the service action. With a single button click he can get connected to the service and launch the poke action.
Service have the option to add metadata to a QR code. Contact us for more information.
Rogerthat Web Connect Button
Another way to connect Rogerthat users to your web service is to embed the Rogerthat Connect Button in your web site. This requires including the following HTML in your web page.
The code will render a button on your web page.
When a visitor clicks that button the following will happen
- If the user has visited web-based Rogerthat before, he will get a service connect request
- If the user did not use web-based Rogerthat in that browser, he will be redirected to Rogerthat, be prompted to sign up or log in, and automatically get connected to your service
If you embed this Rogerthat Web Connect button in the authenticated part of your site, your web service can add metadata in the tag attribute in the HTML snippet. Once the user logs in to Rogerthat through your embedded Rogerthat Web Connect button, Rogerthat will send an invitation request to your service from the user’s genuine Rogerthat account. The invitation request will contain the content of the tag you embedded in the button HTML. This way you can link an identity in Rogerthat (= an email address) to an identity in your web service.
Your Rogerthat Service Invites Users Directly
Your service can use the Rogerthat API to invite people using their email address. The API call friend.invite has to be used.
- If a Rogerthat user is registered on that email address, he will receive a Rogerthat invitation message which he can accept or decline
- If no Rogerthat user is registered on that email address, Rogerthat will send an email to that address in which the recipient receives a link to sign up to Rogerthat. He can sign up with the aforementioned email address or with another one, e.g. in case he is already a Rogerthat user, or in case he wants to join Rogerthat using a different email address. Once he is signed up, he will automatically get connected to your service. Your service will receive all metadata that was included in the tag of the Rogerthat friend.invite API call.
Distribute Your Service Email Address
If your customers know your Rogerthat service email address, they can connect to a service by entering this service email address on their mobile Rogerthat app or in Rogerthat for Web.
Connect using an SMS text message
If your service only has the cellphone number of a person, and no email address, your service can use Rogerthat to create a secret invitation URL that is sent to that person using an SMS text message. When the user clicks this link in the incoming SMS message, he will be redirected to the Rogerthat app (or to the Appstore or Android Market). Your service will receive the messaging.poke call, from which it can create the link between the user account, his cellphone number, and his Rogerthat account.