Getting started with Envoy
- Henrik Karlberg
- Michal Leszczynski
Useful links
Live App demo: here is a short video of how it looks on a mobile device (mid-July)
Product demo: our product demo video gives you a good view of what the most basic Envoy journey can look like.
Dummy app: Fideos - for “Fake Videos” - is a dummy app along with apparent source code. It shows you how to integrate Envoy in just 50 lines of code using our React Toolkit.
Technical documentation: here you'll find our function names and schema, as well as the data we require in a request payload.
Table of Contents
1. Before getting started
1.A. Understanding the two sides of the experience
1.B. Creating an Envoy account
At the moment signup is invite-only. We send you a link that will take you directly to your Dashboard once you’ve confirmed your email.
2. Enabling users to send gifts from your app
2.A. Generating a gift link
See API docs.
2.B. Designing a gifting journey
i. The quickest journey to build
ii. Standard journey
One of the first things you need to think about is where in your you’ll first introduce the gifting feature to your users. Here’s an example of a classic journey.
iii. Using our toolkit
These last two screens are covered by our Toolkit’s UI components. This means you won’t have to code these components from scratch.
Why use our Toolkit
1 - Our UI components
As shown above, you’re provided with customisable modal and sharing views.
2 - Advanced data insights
By embedding our toolkit into your front-end, we’re able to track 1) whenever the gift button is loaded and 2) whenever it is actually seen by the user. This gives us more detailed insights like conversion rates we share with you weekly.
3 - Seamless integration of user reward choice NOT LIVE YET
The available Toolkit frameworks we cover (end of June) are React, Swift, and soon React Native.
2.C. Presenting gift link to user
Messages get a better open rate when the gift link is shared with a little context.
3. Configuring the Envoy browser
This will determine the look and feel of the Envoy-powered browser potential users land on once they’ve clicked on a gift link.
This configuration is set from your dashboard, on dashboard.envoy.is , once you’ve created an account.
3.A. Customise to your brand
In the Customisation section of your dashboard, you customise the browser the recipient of the gift lands on.
There are only 3 components to customisation:
Uploading your logo. Any image format works. We recommend you make it wide, rather than tall, and that you use a transparent background.
Indicating your primary colour.
Choosing either light or dark mode. That’s usually obvious from your existing brand colours.
3.B. Setting offers
In the Offers section, you set the offer those who consume gift content will see.
Right now, all offers are of the ‘link-out' type: you get to choose the text that goes with a “Learn More” CTA.
We add "?source=envoy" to the URLs you choose to link out to so that you can keep track of users coming from gifts.
The first offer you set will be shown primarily:
it will always show in the browser, even on mobile
it will have a 'primary button' while other offers will have a tertiary one, focusing gift recipient attention on this offer
Here’s what the browser looks like when customised with the following elements:
Example configuration | Browser output | ||
|---|---|---|---|
Customisation | Offer | Mobile view | Desktop view |
| 3 times the same meditation app CTA: 'Want to feel this relaxed everyday'? | 
| 
|
Thank you for reading, please send us your feedback and feature requests over at info@envoy.is.