# Group Tenancy (add-on) This is a bot add-on: 1\. Get this addon: * Buy in web [Bot Store](https://www.mysmartbots.com/store/item/49/module/) * Then [attach to your bot](/doc/3c944dc6-8689-465d-b088-06739e08cfc7) 2\. Configure in left menu: ![](https://nyc3.digitaloceanspaces.com/smartbots-docs/uploads/20adbcf8-a916-46eb-b77b-ad6944665550/447746c5-cde2-4777-90e3-39ed809a862b/Docs-addon-menu.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=DO801JV4MUMY3YAEJCWC%2F20261113%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20261113T140000Z&X-Amz-Expires=86400&X-Amz-Signature=c3af3633b9d9432cc5bfafa4139f705d6e2a1c554646309578df8fc519bff838&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =182x67") Group Tenancy 3\. Get more help: * read **docs** * contact [support](http://docs.mysmartbots.com/en/contacts.html) ## Overview **Group Tenancy** is an add-on for [Personal Bots](/doc/e59a06a3-4c30-4082-b5ba-523fef7ae733). It allows you to rent out the group membership for a specific time. ![](https://nyc3.digitaloceanspaces.com/smartbots-docs/uploads/20adbcf8-a916-46eb-b77b-ad6944665550/168758e6-5e76-4f79-b9db-597687fd5410/Group-tenancy-flow.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=DO801JV4MUMY3YAEJCWC%2F20261113%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20261113T140000Z&X-Amz-Expires=86400&X-Amz-Signature=417d271a119138f7fc3d49a8621714530285ddf5ecea469be09db08c77dd7aab&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =871x262") Major features: * Set the rent time and price (e.g. "L$99 for 7 days" * Set the retention period (e.g. "wait 1 day before ejection") * Works with **closed membership groups** * Automatically invite tenant to the **required role** * **Automatically eject** expired tenants * Set up greeting/notification IMs * View current tenants or the whole group members * View payments history ### Web interface ![](https://nyc3.digitaloceanspaces.com/smartbots-docs/uploads/20adbcf8-a916-46eb-b77b-ad6944665550/a8e3988a-1f32-459a-8a64-14194483578b/GT_Summary_page.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=DO801JV4MUMY3YAEJCWC%2F20261113%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20261113T140000Z&X-Amz-Expires=86400&X-Amz-Signature=35b1f39d37c3763b3d913ff443dcd6151ed323224ea4d96540a033332781c0c1&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =600x373") ## How does it work 1. Add your group to add-on (see [Configuration](./Group%20Tenancy%20(add-on)/Group%20Tenancy%20Configuration.md)) 2. Get and rez a Payment Terminal 3. Resident pays your Terminal and gets a group invitation ![](https://nyc3.digitaloceanspaces.com/smartbots-docs/uploads/20adbcf8-a916-46eb-b77b-ad6944665550/bbfafcbd-3a9a-4ef8-ab72-973c20569eb9/GT_Group_Invitation.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=DO801JV4MUMY3YAEJCWC%2F20261113%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20261113T140000Z&X-Amz-Expires=86400&X-Amz-Signature=17c8b0c2ce4e608a5541ee3c580608d97caee508eec289a333b4ab3f6f7dcb2a&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =600x270") 4. Once membership term expires, tenant gets ejected from the group ## Notification IMs Bot sends IMs to the tenant: * once the payment is made, the **greeting IM** is being sent * when membership is about to expire, bot sends a **reminder IM** * '*system notification IMs* can be sent to you and your managers See [Group_Tenancy_Configuration](/doc/22d7104e-7539-4c9b-87bf-7318c5a6d5e0) for more info. ## Payments history All payments are being stored. You can view the payment history for all your groups. ![](https://nyc3.digitaloceanspaces.com/smartbots-docs/uploads/20adbcf8-a916-46eb-b77b-ad6944665550/4c9e006f-af1e-47ee-9059-5de8837ef279/GT_Payments.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=DO801JV4MUMY3YAEJCWC%2F20261113%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20261113T140000Z&X-Amz-Expires=86400&X-Amz-Signature=f9a04ccb4ca75fd6eff3016880a494eff0fa863945a951981d8b488d087f50ad&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =600x341") ## Monitor active/expired members If you process some payments manually, paid members can be added from web interface. Invitation can be re-sent if necessary, or be manually ejected. ![](https://nyc3.digitaloceanspaces.com/smartbots-docs/uploads/20adbcf8-a916-46eb-b77b-ad6944665550/43818595-e3ee-4cf0-a2cb-e7220f6f4706/GT_Paid_members.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=DO801JV4MUMY3YAEJCWC%2F20261113%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20261113T140000Z&X-Amz-Expires=86400&X-Amz-Signature=4e73366fdd058ef80c0dd80854e5d2853179c11f1b16fed1f5168d2def67a394&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =600x349") You can monitor the whole group members: paid, unpaid, about to expire, not joined yet. ![](https://nyc3.digitaloceanspaces.com/smartbots-docs/uploads/20adbcf8-a916-46eb-b77b-ad6944665550/a57b64b5-778a-4420-bbdf-fd4b3f812963/GT_All_members.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=DO801JV4MUMY3YAEJCWC%2F20261113%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20261113T140000Z&X-Amz-Expires=86400&X-Amz-Signature=dc7560304c8633d0905e71e79a765bf0014b8cd803ea50b5666efec4d06dd03f&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =600x438") ## Payment Terminal The Payment Terminal is available for free. It allows your members to pay & prolong their membership. ![](https://nyc3.digitaloceanspaces.com/smartbots-docs/uploads/20adbcf8-a916-46eb-b77b-ad6944665550/3c8dc9b8-1b73-4ccd-94ef-d805b55a9929/GT_Payment_terminal.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=DO801JV4MUMY3YAEJCWC%2F20261113%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20261113T140000Z&X-Amz-Expires=86400&X-Amz-Signature=27058f7ca0a7bff32ecd8ad9034e6bbc8ed77fa883da53eadaddb9655634916f&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =600x693") ## How to purchase See the [Purchasing Add-Ons](/doc/3c944dc6-8689-465d-b088-06739e08cfc7) page for step-by-step add-on activation instructions. ## Additional information 1. This add-on can be used only with a [Personal Bot](/doc/e59a06a3-4c30-4082-b5ba-523fef7ae733). 2. You can refund your add-on purchase within 3 days. --- **Documents** - [Group Tenancy Configuration](https://www.mysmartbots.com/docs/s/main/doc/group-tenancy-configuration-gGlFDgqdKN) - [Adding partners](https://www.mysmartbots.com/docs/s/main/doc/adding-partners-yDytGmpTni)