> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.holaspirit.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Slack Integration # Seamless Slack Integration If your team is using Slack to communicate at work everyday, whether they’re in an office, remote, or both! Holaspirit helps stay on track while using Slack. ## Role Tagging [![](https://storage.crisp.chat/users/helpdesk/website/-/4/4/a/b/44ab4061aae46400/360ac281-158a-4782-90f4-fd4075_fp3iro.png)](https://downloads.intercomcdn.com/i/o/401745709/af02bda99bc6569d982925f7/image.png?expires=1742567400&signature=83b347989878d5c582e9ddc3738e9b1ebfb7926a409db8d2667cab597c9c98a0&req=cCAmEc17moFWFb4f3HP0gPmI5d2TX6Bo1Cxi1mMURplIruZmXyLb%2BZhVbyEv%0AgKoSsaADNrIkmI7yPw%3D%3D%0A) When communicating with coworkers, you can tag a role directly in Slack. It keeps you in the habit of making requests of a role rather than a person. It also makes it easier for the role-filler to consider their role when processing. Use the following shortcuts to tag a role, a member on Slack: * /holaspirit @rolename = retrieves data from role * /holaspirit @membername = retrieves data from member * @rolename [text] = notifies the members of the role A drop-down list of roles, ordered alphabetically, will appear. Pick the role you want to address. Write your message and submit it. People filling the tagged role will be notified about your message, the same as if you had used their individual names. **Keep track of Decisions, Projects, and OKRs** Day-to-day, people use Holaspirit to collaborate on proposals, meetings, projects and OKRs. With the integration, people can get instant notifications from the Holaspirit bot in Slack for the following events: * creation/update/deletion of a role/circle * creation/update/deletion of a policy * election of a user for a core role * assignation of a user to a role * creation/update of a project * creation/update of an OKR The result is that collaboration becomes easy. Your team knows what’s happening and how they can contribute. [![](https://storage.crisp.chat/users/helpdesk/website/-/b/4/5/9/b459af2e03c2e80/3fcd836a-cbde-4cf8-8d42-7969dc_149t1w2.png)](https://downloads.intercomcdn.com/i/o/275834085/cda9a545a0512f16529db825/image.png?expires=1742567400&signature=341942b8811cd481267998c5bff795be8e11e81b6da2cdaddda7aab2296edcab&req=diciHsp6nYlaFb4f3HP0gCAry1nHlTSiizs2OZpR8HBoJrkgY5PaFvfmGuNk%0Agk8XtRuLhvI3djTr4Q%3D%3D%0A) --- # Configuration Instructions 📌  **Note**: A Slack channel can be linked to more than one circle of Holaspirit. * As a Circle Admin, go to the circle you want to integrate Slack with * Click on the **3 dots in the top right corner** of the circle page and select **Settings** * Click the **Integrations** tab. Then select the **Activate** button ![](https://storage.crisp.chat/users/helpdesk/website/-/c/4/1/5/c415f7c7930b8000/screenshot-2025-06-18-at-16091_nzxgd9.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/c/4/1/5/c415f7c7930b8000/screenshot-2025-06-18-at-16032_1rn7qu4.png) ⚠️ **Important prerequisites:** * A paid Slack account (Standard, Plus, or Enterprise will work) * **Slack email addresses match Holaspirit email addresses**, or else the sync system will not be able to match role-fillers with individuals on Slack. If you're having trouble syncing individuals, double check that the emails match. * Only Slack workspace administrator can install this integration. * Usergroups permission has to be enabled for your Slack workspace. * Follow the prompts to enter your organization's Slack URL and select “Continue”. [![](https://storage.crisp.chat/users/helpdesk/website/-/5/c/d/c/5cdca33250131800/b6bd3460-83f6-45cd-82ca-7e8292_17eiitf.png)](https://downloads.intercomcdn.com/i/o/275822937/af8990dd59925a2dc8847be8/Capture+d%E2%80%99e%CC%81cran+2020-12-10+a%CC%80+10.48.17.png?expires=1742567400&signature=0b1e6c459972e14911b648a4d57277917e30c9f0a8a2a75a3736de5cf088e0f8&req=diciHst8lIJYFb4f3HP0gP2kv2jlD8bwgWnUaBkhvezRW5L%2B%2BhZdWu1zCJA7%0AfNdTZ%2B%2FVB4wsR9bhNA%3D%3D%0A) * Next, you will be presented with an access list. It requires to grant access for two different sections: * The first one to allow Holaspirit to send notifications (events) to Slack * The second one to allow Slack to retrieve information (e.g. Role/Member's information) from Holaspirit * Select the Slack channel Holaspirit will post to * Click **Allow** [![](https://storage.crisp.chat/users/helpdesk/website/-/5/7/d/a/57daf6e524d4a800/47f96539-cece-487e-9384-71e4f9_1f6ttqt.png)](https://downloads.intercomcdn.com/i/o/275824652/06e4af4ac977c3d0d714d6ab/Capture+d%E2%80%99e%CC%81cran+2020-12-10+a%CC%80+10.54.30.png?expires=1742567400&signature=57504b6a1ef6c54a3a073a13ccc32da49b3d1362e4ee83b281e5419d772c1638&req=diciHst6m4RdFb4f3HP0gOyHsVWUe1II69AA4gXUUuKM4NLF72wW%2B9NAIFSu%0AWC1A0NGulP4YO8Y0GQ%3D%3D%0A) * Holaspirit will confirm the app installation --- # Troubleshooting * Additional steps might be required on Slack app administration if app approval is turned on for your workspace. * [users_not_found] Unable to retrieve member from slack with email *****@****.** How to fix it : You need to invite this user on Slack with the exact same email as the one in Holaspirit * [paid_teams_only] Unable to create slack user group from role **** How to fix it : You need to subscribe to Slack to be able to have user groups (User groups are used to represent roles in Slack, if you keep the free version of Slack, you will be able to use everything except the user groups) Once you have corrected the cause of the error, you need to **deactivate and reactivate** the Slack integration again.