Skip to content

chatfuel-lab/wizard / content/modules/channels/skill

Chatfuel 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

FileWhat's inside
references/guide.mdThe page model: the hand-off, the two reads with two permission needs, the per-platform state machine, the return leg
playbooks/customize.mdEvery knob: the platform order and titles, the refresh throttle, the redirect rule, the error sentences, the date format
playbooks/embed.mdMounting inside a host app: no views, no params, the role gate, the toast provider
../chatfuel-core/references/platform-links.mdThe 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.graphqlBotChannels, BotPlatformLinks, BotDisconnectContactScope and the four link mutations — this module ships no operations of its own
../chatfuel-core/references/gotchas.mdRead before writing any operation

Rules

  • Validate every operation with ../chatfuel-core/scripts/validate-operations.mjs against ../chatfuel-core/references/schema.graphql before running it live.
  • Read the channels; ask the role separately. contactScopes needs 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. PlatformOperationLinkPlatform has 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. botDisconnectContactScope answers Bot; 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 answers InternalServerError rather than naming the miss, so re-read instead of reading the code.
  • A redirect must be https:// with a host, or the server answers PlatformOperationLinkInvalidRedirectURL; check it client-side first and say the same thing.
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: 467kUpdated Claude CodeCodexVerifiedInstall
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: 319kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 319kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 319kUpdated Claude CodeCodexVerifiedInstall