Configuring Apps
This guide explains what each field is for when configuring your app.
Apps are only visible on the 'Manage Apps' page to all users in your organisation if you Enable your app.
App Name
The name of your app. This is shown to users of your app on the manage apps page in the main app.
![Screenshot 2021-09-28 at 10.31.14.png 254](https://files.readme.io/d3323d6-Screenshot_2021-09-28_at_10.31.14.png)
Setting the name.
![Screenshot 2021-09-28 at 10.35.06.png 598](https://files.readme.io/9106064-Screenshot_2021-09-28_at_10.35.06.png)
How the name appears in the list of apps the user sees on the manage apps page.
Description
This explains to the user what the app does. This is visible when users view the page for your app on the manage apps page.
![Screenshot 2019-03-11 at 12.08.42.png 395](https://files.readme.io/a36db5f-Screenshot_2019-03-11_at_12.08.42.png)
Setting the description.
![Screenshot 2021-09-28 at 10.39.23.png 598](https://files.readme.io/cfb9af6-Screenshot_2021-09-28_at_10.39.23.png)
How the description appears on a user's management page for your app if the app does not require authentication.
![Screenshot 2021-09-28 at 10.42.23.png 598](https://files.readme.io/e5f4622-Screenshot_2021-09-28_at_10.42.23.png)
How the description appears on a user's management page for your app if the app requires authentication and the user has not yet connected their account.
What does the user get from this app in Feed?
This is only shown to users for apps that require authentication. It should summarise what feed events they will receive from the external service your app links to.
![Screenshot 2021-09-28 at 10.43.36.png 665](https://files.readme.io/da1fa5b-Screenshot_2021-09-28_at_10.43.36.png)
Setting the field.
![Screenshot 2021-09-28 at 10.44.20.png 598](https://files.readme.io/f22c254-Screenshot_2021-09-28_at_10.44.20.png)
How this field is displayed to users when viewing the app on the manage apps page.
Post Categories
Each post category has two fields, Category Id and Description. The Id is what is sent in the category
field when calling the Send Feed Event endpoint. The description is displayed to the user on the app management page next to a toggle. The toggle allows the user to choose whether or not they want to receive feed events in that category from that app.
![Screenshot 2019-03-11 at 12.24.58.png 849](https://files.readme.io/cbc1205-Screenshot_2019-03-11_at_12.24.58.png)
Setting the Id and description for a category.
![Screenshot 2021-09-28 at 10.45.33.png 599](https://files.readme.io/c6343e9-Screenshot_2021-09-28_at_10.45.33.png)
How the category appears to a user when viewing your app.
Technical Setup
Here you can set the Proxy URL and Proxy Secret for your app, to find out more about how these fields are used, please read Using the proxy endpoint.
![Screenshot 2019-03-11 at 13.08.10.png 846](https://files.readme.io/4859319-Screenshot_2019-03-11_at_13.08.10.png)
Tokens
To use the API, you need to generate a token for your app.
You can have up to two tokens active at one time allowing you to generate a second token then migrate your app's code to using it.
To use a token, simply copy it from the text box and send it in any requests to the API as an Authorization
header with the value Bearer <your token>
.
Updated about 3 years ago