Accounts, Teams & Permissions
Every bot belongs to a team. Signing up creates a single-seat personal team for you, which is all a solo user needs. Invite people from the dashboard’s Team page; an invitation always joins as a member, and an owner can promote them.
| Member | Admin | Owner | |
|---|---|---|---|
| See the team’s bots, status, metrics, deployments and logs | ✓ | ✓ | ✓ |
| See environment variables (secret values are never shown) | ✓ | ✓ | ✓ |
| Create a bot | ✓ | ✓ | |
| Deploy, roll back, start, stop, restart | ✓ | ✓ | |
| Change or delete environment variables | ✓ | ✓ | |
| Connect WhatsApp, connect integrations, use Studio | ✓ | ✓ | |
| Create and revoke deploy tokens | ✓ | ✓ | |
| Delete or transfer a bot | ✓ | ✓ | |
| Invite people, remove members, view the activity log | ✓ | ✓ | |
| Remove another admin or owner, change roles, delete the team | ✓ |
A member is a viewer. Deploying runs your code with the bot’s secrets in its environment, so deploying is as powerful as reading them, which is why it needs admin. A team always keeps at least one owner. Access is per team, not per bot: everyone in a team sees all of its bots.
Deploy tokens
Section titled “Deploy tokens”A deploy token is for CI. It belongs to one bot and can do exactly one thing: upload a deployment to it. It cannot read or change environment variables, read logs, or create other tokens. Tokens expire (90 days by default, at most 365), and you can regenerate one without changing where it is stored.
A token is tied to the admin who created it. If that person leaves the team or is demoted to member, the tokens they created stop working, so create a replacement from another admin account first when that person is leaving.
Your own sign-in
Section titled “Your own sign-in”pywa login gives the CLI your full user session, with the same role you have in each team. Use a
deploy token, not your login, in CI.
Studio
Section titled “Studio”Studio works with a team’s WhatsApp account only for owners and admins. A member who signs in sees a message saying so, and can still use Studio without an account.