To use Hellō in your app, you will need to register your app, and add a Hellō button.
If you are writing your own application, integrating Hellō is straight forward and does not require any frameworks or third party libraries.
If you are configuring a platform to use Hellō, you will need to copy and paste values between the Hellō console and the platforms administrative console.
In the future we will have plug-ins for popular platforms that will simplify using Hellō. If you are interested in writing a plug-in, please reach out firstname.lastname@example.org.
1. App Registration
To use Hellō, register your application at console.hello.dev. You can start developing with just the Client ID and the defaults, which includes the Development Redirect URIs
2. Hellō Buttons
To add a Hellō Button to your page:
2.1 Include a link to the Hellō stylesheet in the
<head> of your document for button styling.
<head> ... <link href="https://cdn.hello.coop/css/hello-button.css" rel="stylesheet"> </head>
2.2 Include the HTML for the Hellō Button in your page:
If you don't want to use the Hellō stylesheet, the Hellō button is either charcoal (#303030) on white, or white on charcoal. Note that the Hellō logo
ō is an
o with a macron. You can use the
ō character if you have
<meta charset="UTF-8"> in your page
<head> element (best practice for HTML documents). For reference, the UTF-8 encoding is
0xC5 0x8D and the HTML markup is
3. Select Claims
You request claims from Hellō by including a scope for that claim in your request. Any claims you request from Hellō are required claims, IE the user will need to provide a value. Hellō only supports verified email and phone claims. Unverified email and phone are not supported. Hellō Claims provides a full list of supported scopes and associated claims.
Hellō will always return the
sub claim, a globally unique identifier in the form of a GUID, that you can use to identify the user across any apps under your publisher. The
sub claim is unique to your publisher for a given user. Other publishers will receive a different
sub claim for the user.
Note that it is best practice to only request the claims you require. For example, you may only need a preferred name to address the user initially, and a verified email address when they would like a notification. Hellō makes it easy to do incremental consent and request additional claims once you need them.