Getting started with Envoy

Note

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.

Note

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

Note

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.

Note

We add “?source=envoy” to the URLs you choose to link out to so that you can keep track of users coming from gifts.

Note

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
• Logo is this image: • Primary colour is this dark pink: • Mode is ‘dark’	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. 👋