skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
gokapso/agent-skills92 installs

whatsapp-flows

Manage WhatsApp Flows via Kapso Platform API. List, create, update, publish flows, manage versions, attach data endpoints, and check encryption. Use when working with WhatsApp Flows, flow JSON, or data endpoints.

How do I install this agent skill?

npx skills add https://github.com/gokapso/agent-skills --skill whatsapp-flows
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is an administrative tool for managing WhatsApp Flows via the Kapso API. It is generally safe for use but contains a minor risk of indirect prompt injection when reading external responses and logs.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · No issues

What does this agent skill do?

WhatsApp Flow Management

When to use

Use this skill to manage WhatsApp Flows end-to-end: discover flows, edit flow JSON via versions, publish/test, attach data endpoints, and inspect responses/logs.

Setup

Env vars:

  • KAPSO_API_BASE_URL (host only, no /platform/v1)
  • KAPSO_API_KEY
  • META_GRAPH_VERSION (optional, default v24.0)

Run scripts with Node or Bun:

node scripts/list-flows.js

How to

Create and publish a flow

  1. Create flow: node scripts/create-flow.js --phone-number-id <id> --name <name>
  2. Read references/whatsapp-flows-spec.md for Flow JSON rules
  3. Update JSON: node scripts/update-flow-json.js --flow-id <id> --json-file <path>
  4. Publish: node scripts/publish-flow.js --flow-id <id>
  5. Test: node scripts/send-test-flow.js --phone-number-id <id> --flow-id <id> --to <phone>

Attach a data endpoint (dynamic flows)

  1. Set up encryption: node scripts/setup-encryption.js --flow-id <id>
  2. Create endpoint: node scripts/set-data-endpoint.js --flow-id <id> --code-file <path>
  3. Deploy: node scripts/deploy-data-endpoint.js --flow-id <id>
  4. Register: node scripts/register-data-endpoint.js --flow-id <id>

Debug flows

  • List responses: node scripts/list-flow-responses.js --flow-id <id>
  • Function logs: node scripts/list-function-logs.js --flow-id <id>
  • Function invocations: node scripts/list-function-invocations.js --flow-id <id>

Flow JSON rules

Static flows (no data endpoint):

  • Use version: "7.3"
  • routing_model and data_api_version are optional
  • See assets/sample-flow.json

Dynamic flows (with data endpoint):

  • Use version: "7.3" with data_api_version: "3.0"
  • routing_model is required - defines valid screen transitions
  • See assets/dynamic-flow.json

Read the full spec in references/whatsapp-flows-spec.md before editing.

Data endpoint rules

Handler signature:

async function handler(request, env) {
  const body = await request.json();
  // body.data_exchange.action: INIT | data_exchange | BACK
  // body.data_exchange.screen: current screen id
  // body.data_exchange.data: user inputs
  return Response.json({
    version: "3.0",
    screen: "NEXT_SCREEN_ID",
    data: { ... }
  });
}
  • Do not use export or module.exports
  • Completion uses screen: "SUCCESS" with extension_message_response.params
  • Do not include endpoint_uri or data_channel_uri (Kapso injects these)

Scripts

Platform API

ScriptPurpose
list-flows.jsList all flows
create-flow.jsCreate a new flow
get-flow.jsGet flow details
read-flow-json.jsRead flow JSON
update-flow-json.jsUpdate flow JSON (creates new version)
publish-flow.jsPublish a flow
get-data-endpoint.jsGet data endpoint config
set-data-endpoint.jsCreate/update data endpoint code
deploy-data-endpoint.jsDeploy data endpoint
register-data-endpoint.jsRegister data endpoint with Meta
get-encryption-status.jsCheck encryption status
setup-encryption.jsSet up flow encryption

Meta proxy

ScriptPurpose
send-test-flow.jsSend a test flow message
delete-flow.jsDelete a flow

Logs and responses

ScriptPurpose
list-flow-responses.jsList stored flow responses
list-function-logs.jsList function logs
list-function-invocations.jsList function invocations

Troubleshooting

  • Preview shows "flow_token is missing": Flow is dynamic without a data endpoint. Attach one and refresh.
  • Encryption setup errors: Enable encryption in Settings for the phone number/WABA.
  • OAuthException 139000 (Integrity): WABA must be verified in Meta security center.

References

Related skills

  • whatsapp-messaging - WhatsApp messaging and templates
  • kapso-automation - Workflow automation
  • kapso-api - Platform API and customers

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/gokapso/agent-skills/whatsapp-flows">View whatsapp-flows on skillZs</a>