kapso-whatsapp

Solid

How to interact with Kapso WhatsApp from the swarm — read inbound webhook payloads (text AND media), fetch message history, send free-form messages within the 24h session window (and template messages outside it), mark-as-read, show the typing indicator, send reactions, download media, verify webhook signatures, and resolve contacts to swarm users. Canonical reference for ANY Kapso interaction beyond the thin `send-whatsapp-message` / `reply-whatsapp-message` MCP tools — for templates, media, reactions, typing, mark-as-read, signature verify, contact resolution, conversation history, drop to the REST recipes here. Use whenever a task references a WhatsApp message routed through Kapso, or when a workflow needs to reply on WhatsApp.

AI & Automation 483 stars 53 forks Updated today MIT

Install

View on GitHub

Quality Score: 92/100

Stars 20%
89
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Kapso WhatsApp Kapso (https://kapso.ai) is a WhatsApp platform vendor that fronts the Meta Cloud API. A swarm provisions one or more WhatsApp phone numbers and wires each one to either a native inbound handler (PR #560) or a workflow that dispatches a task per inbound message. ## When to use MCP tools vs this skill's REST recipes PR #560 ships **thin MCP-tool wrappers for the common case only**: | Tool | Use for | |---|---| | `send-whatsapp-message` | Free-form text within the 24h session window. | | `reply-whatsapp-message` | Same as above but quote-threads to an inbound WAMID. | | `register-kapso-number` / `unregister-kapso-number` | Provisioning a phone number's webhook + KV mapping. | **For ANYTHING else, drop to the REST recipes in this skill** — these are the canonical reference, and the MCP tools deliberately do NOT duplicate them: - **Template messages** (outside 24h window) → §"Send a template" below. - **Media** (image / document / audio / video, including wide-image padding and PTT voice notes) → §"Sending media". - **Reactions** (👀 / ✅ / clear) → §"Send a reaction". - **Typing indicator + mark-as-read** → §"Mark as read + typing indicator". - **Signature verify (manual)** → §"Webhook signature verification". - **Contact resolution → swarm user** → §"Resolve a contact to a swarm user". - **Conversation history / message detail / templates list** → §"Read conversation context". If the MCP-tool send returns a 24h-window error (`sessionWindowExpired: true`),...

Details

Author
desplega-ai
Repository
desplega-ai/agent-swarm
Created
5 months ago
Last Updated
today
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category