The Box connector lets ZeroTwo reach your Box content through your own Box account. You connect it from Customize, then mention it in a chat or use it in Work mode. A connected Box account can also show up as a source in Spaces.
What ZeroTwo can do with Box
In the connector list Box is described as "Search and reference your documents in Box and work safely with Box content flows from ZeroTwo." ZeroTwo's built-in Box entry names three tools: searching folders by name, listing a folder's contents by folder ID and getting a file's content. After you connect, the Tools card on Box's page shows the tools it loaded for your account. Select it to see them grouped as Write and Read.
Connect Box
- Select Customize in the left rail, then Connectors.
- Find Box and select Connect.
- In the window headed "Use Box in ZeroTwo", select Connect.
- Sign in to Box and approve access. ZeroTwo asks Box for the
root_readwritescope, a read and write scope.
On the web this takes you to Box's page and back. In the desktop app, Box's page opens in your default browser. Once connected, Box is listed under Installed in the Customize sidebar while Connectors is open.
You can also start from Spaces: choose New, then Connect a plugin, and select the plus button beside Box in the "Connect your files" dialog.
Use Box in a conversation
In Chat mode ZeroTwo attaches Box tools only when your latest message mentions Box. Type @Box in your message, for example "@Box find the planning folder". In Work mode ZeroTwo does not need a mention to reach your connected connectors.
Browse Box in Spaces
A connected Box account can appear as a source named "Box" in the Space sidebar. This works on the web, in the desktop app and in the Android app. Open it to browse your folders. On the web and in the desktop app, a file's three-dot menu offers Chat about this, Download, Rename, Move to..., Copy to… and Hide. Items are greyed out when Box does not allow that action for the item.
- Delete is not available for Box items. Box lets an organization turn its trash off, and ZeroTwo cannot tell whether yours is on, so it does not offer the action.
- Uploads and downloads are limited to 50 MiB per file.
To hide the source without disconnecting, open Space settings and turn off Show Box in Space.
Choose when ZeroTwo asks first
Open Box from Installed and select the Permission card. Pick Always ask, Allow read-only tools, Allow low-risk tools (the default) or Allow all tools. When a tool needs your approval, ZeroTwo pauses and offers Allow once, Allow for this run and Deny. Connector approvals follow this setting even when Work or Code runs with Full access. See Control when ZeroTwo asks before using a connected app.
Reconnect or disconnect
If Box stops working, its page shows the error, by default "Your session has expired. Reconnect to re-authorize.", and the account reads "Reconnect to continue using this account". Select Reconnect. To remove Box, select Uninstall at the top of its page and confirm; ZeroTwo deletes the connection and the tokens it saved. When you opened Box from a plugin that bundles several apps, the button reads Disconnect. See Connect, reconnect and disconnect app accounts.