Connect flow & rules
How you connect each OpenQuok channel in Add Channel — OAuth, credentials, self-host operator OAuth keys, and channel keys.
Connect your agent today
Draft from chat, review in your calendar, and publish only what you approve.
Connect rules
How you link each network to your workspace in Add Channel, and which channel key the API uses for that connection.
OpenQuok registers ten channels. Connect each one once per workspace account. See Connect a channel.
Instagram and LinkedIn each map to two channel keys in the table below (Business and Standalone, or personal profile and Page).
Every platform
How you connect it
How you connect it is what happens when you click the platform in Add Channel:
| Connect type | What you do |
|---|---|
| OAuth | OpenQuok sends you to the platform. You sign in and approve access there. You return to OpenQuok. Some networks then ask you to pick a Page, Instagram account, or YouTube channel. |
| Credentials in OpenQuok | You paste your own API key in a dialog. The self-host operator does not add platform OAuth keys for that channel. |
When you self-host OpenQuok, the operator (who runs the server) must register an OAuth app with each network and set that app’s client ID and secret in backend environment variables. Workspace members then connect their own accounts in Add Channel.
The last column marks which channels need that operator setup (Yes for OAuth networks, No when the user pastes a personal API key instead).
Tip
On OpenQuok Cloud, those OAuth apps are already configured — you only sign in to your account. For self-hosting, see Social integrations and Docker Compose → Social provider apps.
Note
Naming in the dashboard vs the API is in Platforms overview. Caption length, media, and editors are in Media rules. Fields in the composer Settings panel are in Per-channel settings.
| Display name | Channel key | How you connect it | Self-host: operator OAuth keys |
|---|---|---|---|
| Threads | threads | OAuth | Yes |
| Facebook Page | OAuth (+ Page picker) | Yes | |
| Instagram (Business) | instagram-business | OAuth (+ Page picker) | Yes |
| Instagram (Standalone) | instagram-standalone | OAuth | Yes |
| OAuth | Yes | ||
| LinkedIn Page | linkedin-page | OAuth (+ Page picker) | Yes |
| YouTube | youtube | OAuth (+ channel picker) | Yes |
| TikTok | tiktok | OAuth | Yes |
| X | x | OAuth | Yes |
| Dev.to | devto | Credentials in OpenQuok | No |
Connect in the dashboard only
Most channels use OAuth: you click the network in Add Channel, sign in on the platform site, and return to OpenQuok.
Dev.to is different. You paste a personal API key in Add Channel. There is no OAuth redirect for Dev.to.
Operator setup for each OAuth network is in Social integrations.