Integrate the Helpscout Beacon into your React Native app.
Current version: 4.1.0 (released 2022-09-22)
Tested version: 2.0.2 (released 2020-09-16)
This library is compatible with and supported for React Native
0.60 and above:
$ yarn add react-native-helpscout-beacon
pod 'Beacon'to your
For React Native
0.59 and below linking will be necessary (not tested):
$ react-native link react-native-helpscout-beacon
Update Helpscout SDK
Can be updated in your main project directory by running
cd ios/ && pod update Beacon
Please create an issue in this repo in case it doesn't work as expected.
Has to be updated in this module's
android/build.gradle, i.e. the version in the following line has to be adapted
import HelpscoutBeacon from 'react-native-helpscout-beacon'; // init has to be called first HelpscoutBeacon.init('my_helpscout_id'); // Login into your helpscout account HelpscoutBeacon.login( 'email@example.com', 'John Smith', 'user_id_of_john_smith' ); // Open the helpscout beacon (using a cryptographic signature) HelpscoutBeacon.open('mySignature');
Not all methods of the SDKs are implemented so far.
Initialize the Helpscout beacon library - has to be called before any other Helpscout method.
Identify a helpscout user with
HelpscoutBeacon.identify('firstname.lastname@example.org', 'John Smith');
Logout user from the Helpscout Beacon.
Used to add an user attribute represented as a key / value pair. There is a limit of 30 attributes per user.
Opens the Helpscout Beacon with Help Center articles.
login methods will need to have been called before this will work.
May be used without arguments or with an optional
signature (secure mode).
Opens the Helpscout Beacon at a specific Help Center article. (Helpscout docs integration has to be enabled)
The suggestArticles method allows you to change the default list of suggested articles. Article IDs can be found in Help Scout by navigating to the article and copying the article ID from the URL. The URL is structured like this:
https://secure.helpscout.net/docs/[COLLECTION ID]/article/[ARTICLE ID]/.
Custom suggestions will only get loaded when the Beacon is opened. If the Beacon is not present, loading the custom suggestion data will get queued up for the next Beacon display.
- There is a limit of 5 article IDs. If the list is larger than 5 the additional articles will be ignored.
- The Helpscout docs integration has to be enabled for this method to work.
const articleIDList = ['id1', 'id2', 'id3']; HelpscoutBeacon.suggestArticles(articleIDList);
Reset any suggested articles set by
suggestArticles back to Helpscouts own default suggestions.
Display a specific page in the Helpscout beacon. On Android, these paths are supported:
iOS supports additional paths e.g. "/" which displays the initial state of the beacon. Find supported path values here.
Additional convenience methods
These methods are not part of the original SDKs but have proven to be useful.
Convenience method to identify the user via setting an attribute with key
HelpscoutBeacon.login( 'email@example.com', 'John Smith', 'user_id_of_john_smith' );
It is equivalent to
HelpscoutBeacon.identify('firstname.lastname@example.org', 'John Smith'); HelpscoutBeacon.addAttributeWithKey('userId', 'user_id_of_john_smith');
Convenience method to login via setting an attribute with key
userId and opening the Helpscout beacon (with optional signature).
HelpscoutBeacon.loginAndOpen( 'email@example.com', 'John Smith', 'user_id_of_john_smith', 'mySignature' );