Workplace
How to publish a bot on Workplace
Create a custom integration
- Go to the Workplace website and login to your account.
![WP 1.png 1894](https://files.readme.io/719a42d-WP_1.png)
- Go to Admin Panel (wrench and screwdriver icon).
- Select Integrations.
![WP 2.png 1891](https://files.readme.io/ff89696-WP_2.png)
- Scroll down and click the Create Custom Integration button.
- Enter the name and description and click the Create button.
![WP 3.png 1920](https://files.readme.io/0cee1bc-WP_3.png)
You are redirected to the Integration details page.
Create and get Access Token
- Go to Details in the sidebar.
- Click the Create Access Token button in the integration Details section.
- Copy the new token created for later use.
![WP 4.png 1887](https://files.readme.io/9183151-WP_4.png)
Enable permissions
- Go to Permissions in the sidebar.
- Enable the permissions mentioned below.
Permissions |
---|
Message any member |
Read all messages |
Read and action reported content |
Read group content |
Read Knowledge Library content |
Read user email |
Read user timeline |
Read org chart |
Read work profile |
Read group membership |
- Click Save.
![WP 5.png 1886](https://files.readme.io/b38c6c4-WP_5.png)
Get Callback URL and Verify Token
- Log in to the Gupshup website.
- Go to Dashboard tab > My Bots section.
- Select the button under the Publish column against the bot you wish to publish.
- A list of channels will appear. Click on the Publish button against Workplace.
- Scroll down and click Configure webhooks.
- Copy the Callback URL and Verfiy Token for later use.
![WP 6.png 1217](https://files.readme.io/5d22216-WP_6.png)
Configure webhooks
- Go to Webhooks in the sidebar on the Integration details page.
- Click the pencil icon against Page.
![WP 7.png 1889](https://files.readme.io/a123311-WP_7.png)
- Enter the Callback URL and Verify Token copied earlier in the respective fields.
- Select all event checkboxes given below and click Save.
![WP 8.png 1884](https://files.readme.io/76b114a-WP_8.png)
Get Bot Page ID
- Go to Home (Workplace logo icon).
- Go to the Bots section in the Home sidebar.
- Select the custom integration you created for the bot.
- Copy the ID given the end of the URL in the search bar of your browser for later use.
![WP 9.png 1920](https://files.readme.io/528d354-WP_9.png)
Submit your Page ID and Access Token
- Log in to the Gupshup website.
- Go to Dashboard tab > My Bots section.
- Select the button under the Publish column against the bot you wish to publish.
- A list of channels will appear. Click on the Publish button against Workplace.
- Scroll down and click Submit your Page ID and Access Token.
- Enter the Page ID and Access Token copied earlier into the respective fields.
- Enter the Persistent Menu JSON and Welcome Message if you wish.
- Click Submit.
![WP 10.png 746](https://files.readme.io/25c56a9-WP_10.png)
To configure a persistent menu for your bot, refer to Gupshup's persistent menu guide.
Updated over 2 years ago