Skip to content

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 ​

  1. Open the team selector / Teams
  2. Create Team
  3. Set name, description, logo (optional)
  4. Configure initial settings
  5. Team is created

Settings layout ​

Settings combines personal and team sections in one navigator.

Personal ​

ItemPath / notes
ProfileYour user profile
WalletsYour personal wallet settings (/teams/settings/wallets) — not agent wallets
NotificationsUser notification prefs
VoiceDesktop only — Voice dictation controls
ClipboardDesktop only
APIAPI tokens
LogsClient logs

Team ​

ItemWhat you configure
GeneralName, tagline, description, logo, cover, timezone, locale, category, custom key/value settings, location, Wi‑Fi, preferred channel, delete team (non-personal)
AppsInstall native apps and integrations
MembersInvite, change roles, remove
BrandingBrand colors (background / foreground / label / accent) for public surfaces and Studio templates
Usage & BillingConsumption 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 ​

  1. Team settings → Members
  2. Invite
  3. Enter email
  4. Assign role
  5. 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.