Bouncer DocsCore Concepts
Understand organizations, instances, team members, and billing
Before diving into Bouncer, it helps to understand how the key concepts fit together.
Organizations
An organization is your workspace in Bouncer. Everything you do - connecting WhatsApp numbers, managing conversations, creating workflows - happens within an organization.
- Each organization has its own data, completely isolated from others
- You can belong to multiple organizations (e.g., one for each client or business unit)
- Billing is per organization - each workspace has its own subscription
Switching organizations
If you're part of multiple organizations, click your organization name in the header to switch between them. Your context changes immediately without logging out.
Instances
An instance is a connected WhatsApp number. Each instance represents one WhatsApp Business account linked to Bouncer.
- One organization can have multiple instances (e.g., sales line, support line)
- Each instance has its own conversations, but contacts can exist across instances
- Some features like attribution rules are configured per instance
Connection types
Bouncer supports two ways to connect WhatsApp:
| Type | Best for | Features |
|---|---|---|
| Bouncer Direct | Quick setup, personal numbers | QR code pairing, works like WhatsApp Web |
| Meta Cloud API | Production use, business accounts | Official API, coexistence mode, template messages |
Learn more in WhatsApp Connections.
Team members
Invite your team to collaborate within an organization. Each member has a role that determines what they can do.
Roles
| Role | Permissions |
|---|---|
| Owner | Full access, can delete organization, manage billing |
| Admin | Manage settings, members, instances, and all features |
| Member | Chat with customers, view contacts, use assigned features |
Inviting members
- Go to Settings → Team tab
- Click Invite Members
- Enter email addresses (one per line or comma-separated)
- Select a role
- Click Send Invitations
Invitees receive an email with a link to join. Pending invitations appear in the team list until accepted.
Removing members
Admins and owners can remove members from the team. Removed members lose access immediately but their conversation history and assignments remain.
Billing
Bouncer bills per organization. Each organization has its own subscription plan that determines available features and limits.
Subscription tiers
| Tier | Includes |
|---|---|
| Free | Basic chat, limited instances, core features |
| Starter | More instances, webhooks, basic automation |
| Professional | AI agents, workflows, advanced analytics |
| Enterprise | Custom limits, priority support, SLA |
What counts toward limits
- Instances - Number of connected WhatsApp numbers
- Team members - Users with access to the organization
- Messages - Monthly message volume (some tiers)
- AI credits - Usage of AI features like agents and summaries
Managing billing
Go to Billing in the sidebar to:
- View your current plan and usage
- Upgrade or downgrade your subscription
- Download invoices
- Update payment method
Per-organization billing
Each organization is billed separately. If you manage multiple organizations:
- Each has its own subscription
- Usage doesn't pool across organizations
- You can have different tiers for different workspaces
Data isolation
Bouncer uses strict multi-tenancy. Data from one organization is completely isolated from others:
- Contacts, conversations, and messages are organization-scoped
- Team members only see data from organizations they belong to
- API keys and webhooks are organization-specific
- Even if you're in multiple organizations, data never crosses boundaries
This means you can safely manage multiple clients or business units in separate organizations without data leakage concerns.