Connectors

A connector is an external account the agent can use on your behalf. It is connected once per person and used by all your agents.

How it works

• The account connects; each agent is granted access. The key is stored encrypted under (your user, provider). As with databases, an agent only uses the connectors you give it in its page → Connectors (a new agent starts with none). On team channels it reads and writes; on customer channels it only reads, unless you allow it.
• It acts as whoever invokes it. In Teams, if @handle sends an email from a channel, it sends it with the account of the person who mentioned it, not with a shared account. On a public channel (WhatsApp) personal connectors are not available.
• Disconnecting revokes. Removing a connector deletes the key and revokes the grant at the provider.

Where they are connected

• Studio: the Connectors chip in the chat (/c), and each agent's page shows which ones it has. Credential-based ones (Mercado Pago, Skydropx) are pasted in Settings → Credentials.
• Teams: the workspace's Settings → Integrations, for what the agent uses inside the workspace (GitHub, Calendly, Deník…).
• Mobile app: Settings → Integrations with the same list, through the connectors API.

Catalog

Google Drive

The agent only sees the files you pick. When connecting, Google asks for access to "the files you use with this app" (drive.file) and then Google's picker opens so you choose your price list, inventory or catalog. Nothing else in your Drive is within its reach.

• What it reads: Google Sheets (every tab), Google Docs and CSV or text files. PDF and .xlsx not yet.
• Tools: drive_archivos (what you picked), drive_leer, hoja_agregar_fila and hoja_actualizar.
• Writing to a sheet works from team channels (your chat, Teams, scheduled). To let a customer (Messenger, WhatsApp) write, for example their order, tick "Can write from customer channels" in the agent's page → Connectors.
• Add or remove files: Connectors → Google Drive → Files. Which files each agent sees is chosen in its page → Connectors.
• Disconnecting revokes the grant in your Google account.

Odoo and other credential-based connectors

Non-OAuth connectors are set up with their credentials (instance URL, user, key). The URL goes through a network guard: only public hosts, no private IPs and no localhost, so a connector can't be used to reach your internal network from the agent's machine.

API

For your own clients (the mobile app uses these):

They require an OAuth2 bearer; see Authentication.

# catalog with each connector's statecurl https://www.ghosty.studio/api/v2/me/connectors -H "Authorization: Bearer $TOKEN"
# start authorization for one (open the returned url in the browser)curl -X POST https://www.ghosty.studio/api/v2/me/connectors/easybits/start -H "Authorization: Bearer $TOKEN"
# disconnect (revokes at the provider)curl -X DELETE https://www.ghosty.studio/api/v2/me/connectors/easybits -H "Authorization: Bearer $TOKEN"