chatfuel-lab/wizard / content/modules/channels/skill
skill
UnverifiedChatfuel Channels
The channels a bot is connected to, and the links that connect or refresh one.
Before writing code read
../chatfuel-core/SKILL.md: required inputs (base URL, token, botID), the mandatory CORS proxy, and the working rules.
Files
| File | What's inside |
|---|---|
references/guide.md | The page model: the hand-off, the two reads with two permission needs, the per-platform state machine, the return leg |
playbooks/customize.md | Every knob: the platform order and titles, the refresh throttle, the redirect rule, the error sentences, the date format |
playbooks/embed.md | Mounting inside a host app: no views, no params, the role gate, the toast provider |
../chatfuel-core/references/platform-links.md | The API rules for the links: one per slot, one-shot, 24 hours, the URL as credential, the redirect rule, disconnecting a channel, the refusal codes |
../chatfuel-core/examples/operations.graphql | BotChannels, BotPlatformLinks, BotDisconnectContactScope and the four link mutations — this module ships no operations of its own |
../chatfuel-core/references/gotchas.md | Read before writing any operation |
Rules
- Validate every operation with
../chatfuel-core/scripts/validate-operations.mjsagainst../chatfuel-core/references/schema.graphqlbefore running it live. - Read the channels; ask the role separately.
contactScopesneeds only access to the bot, and the three writes need Configure: Edit. Never put the active-link maps in the same document as the channels: they are non-null and need the permission, so one document asking for both answers nothing at all to a role that may read but not manage. - Connect is a hand-off the app performs, not a link it shows. Mint the link when somebody presses the button, put this page's own address in both redirects, and leave for it in the same tab. A user connecting their own channel should never be handed a URL to pass along.
- The redirects must be
https://with a host or the create is refused, so a deployment on plain http mints the link without them and the person comes back with Back. - Creating replaces. A second create on the same (platform, kind) kills the first link silently. That is harmless here — the link is spent in the same gesture — and it is why nothing keeps one around.
- WhatsApp, Instagram, TikTok and Facebook take links; the web widget does not.
PlatformOperationLinkPlatformhas four values. A Facebook link deals in one page: Connect only while the bot has no page (a second page is refused on Chatfuel's side), Refresh access only while it has exactly one (the link binds to whichever page the server finds first). - A disconnect takes the bound access refresh link with it.
botDisconnectContactScopeanswersBot; read the scopes and both link maps off that payload rather than keeping the old maps. The web widget cannot be disconnected at all, and that refusal arrives nested; a scope the bot no longer has answersInternalServerErrorrather than naming the miss, so re-read instead of reading the code. - A redirect must be
https://with a host, or the server answersPlatformOperationLinkInvalidRedirectURL; check it client-side first and say the same thing.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |