Teams
Teams are collaborative workspaces where multiple users work together, share agents, and manage resources collectively.
Team features
- Shared agents — members use team agents
- Native apps — install Shop, Contacts, Forms, and more per team (Native apps)
- Resource sharing — wallets, integrations, configurations
- Centralized billing — team-wide subscriptions
- Usage limits — messages and feature quotas
- Permission management — roles and access
Creating teams
- Open the team selector / Teams
- Create Team
- Set name, description, logo (optional)
- Configure initial settings
- Team is created
Settings layout
Settings combines personal and team sections in one navigator.
Personal
| Item | Path / notes |
|---|---|
| Profile | Your user profile |
| Wallets | Your personal wallet settings (/teams/settings/wallets) — not agent wallets |
| Notifications | User notification prefs |
| Voice | Desktop only — Voice dictation controls |
| Clipboard | Desktop only |
| API | API tokens |
| Logs | Client logs |
Team
| Item | What you configure |
|---|---|
| General | Name, tagline, description, logo, cover, timezone, locale, category, custom key/value settings, location, Wi‑Fi, preferred channel, delete team (non-personal) |
| Apps | Install native apps and integrations |
| Members | Invite, change roles, remove |
| Branding | Brand colors (background / foreground / label / accent) for public surfaces and Studio templates |
| Usage & Billing | Consumption vs plan limits, subscription, payment methods, invoices |
Agent wallets live under Agent settings → Wallets (Wallets). Loyalty lives under the Contacts app (Contacts), not Team settings.
Google place data
Team General → Location uses a native Google place. JoAi stores the place's address, coordinates, rating, review count, and its latest Google reviews.
- The place details and the latest reviews refresh weekly.
- Selecting a place refreshes them immediately.
- Teams with appointment opening-hours sync enabled also refresh the place details daily.
- Admins can force a refresh with
php artisan team:sync-place <team-slug>.
Google reviews are shown on public business profiles (for example on city sites) together with a link to the full review list on Google Maps.
Native apps on a team
Install modules under Team settings → Apps. See the full matrix in Native apps.
Installed apps appear in the sidebar when they have a nav entry and unlock matching MCP tools for agents.
Member roles
- Owner — full control, can delete team and transfer ownership
- Admin — manage settings, members, and resources
- Member — use team resources and edit content
- Developer — build with team agents, wallets, secrets, and sites
Adding members
- Team settings → Members
- Invite
- Enter email
- Assign role
- Send invitation
Agent access
Agents belong to one team but can be granted access to other teams. Owners and admins manage this in Agent settings → Team access by selecting a team and a role (Member, Developer, or Admin). Agents can also request access from a conversation; the request becomes an approval card that a human must approve before access is granted. Agents can only receive access to teams where their owner can manage member roles. See Agents.
Changing roles
Owners and admins can change a member's role from the Members list — the role next to each member is a dropdown. Select a new role to apply it immediately; pending invitations can be adjusted the same way before they are accepted.
Owners can promote another member to Owner and can demote themselves. A team must always keep at least one owner, so the last remaining owner cannot be demoted until someone else is promoted first.
Only owners can grant or revoke Owner. Admins can manage the other roles, but not owners.
- Billing — plans, usage, Extra Usage
- Desktop — clipboard, hotkeys, voice
- Native apps
- Agents
- Integrations
- Wallets
- Contacts