Integrate Whatsapp

What Is This?

Overview

Integrate WhatsApp is a skill provided through the Kapso platform that enables developers to connect WhatsApp messaging capabilities directly into their products. Using the Kapso CLI and API layer, teams can onboard customers through setup links, detect active connections, receive real-time events through webhooks, and send messages including templates and media files. The skill covers the full integration lifecycle from initial customer onboarding through ongoing message management.

Beyond basic messaging, this skill also covers WhatsApp Flows, which are structured interactive experiences that allow businesses to collect information, guide users through processes, and deliver dynamic content within the WhatsApp interface. Kapso provides tools to create, update, publish, and manage these flows along with their data endpoints and encryption requirements.

This skill is sourced from the gokapso/agent-skills repository and is designed to work within the Kapso ecosystem. Developers authenticate through the Kapso CLI, confirm project access, and then use the available commands and API methods to build a complete WhatsApp integration without managing the underlying Meta Business API complexity directly.

Who Should Use This

• Backend developers building customer communication pipelines who need a reliable WhatsApp integration layer
• Product engineers adding messaging features to SaaS platforms that require onboarding flows and real-time event handling
• Technical leads evaluating WhatsApp Business API solutions who want a managed approach with CLI tooling
• Developers building automated notification systems that send templated or media-rich messages at scale
• Teams implementing WhatsApp Flows for lead capture, surveys, or guided onboarding experiences within the chat interface
• Startup engineers who need end-to-end WhatsApp connectivity without managing Meta API credentials and webhook infrastructure from scratch

Why Use It?

Problems It Solves

• Eliminates the complexity of setting up and maintaining direct Meta Business API connections, which require extensive configuration and approval processes
• Removes the need to build custom webhook infrastructure for receiving and processing WhatsApp events reliably
• Simplifies customer onboarding by providing setup links that handle the connection process without manual credential exchange
• Reduces the effort required to manage WhatsApp Flows, including the encryption and data endpoint requirements that are otherwise difficult to implement correctly
• Prevents message delivery failures by abstracting template management and media handling behind a consistent API surface

Core Highlights

• Customer onboarding through generated setup links that connect WhatsApp accounts to your product
• Connection detection to confirm when a customer's WhatsApp is active and ready to receive messages
• Webhook-based event delivery for incoming messages, status updates, and flow interactions
• Support for sending plain text messages, approved templates, and media attachments
• WhatsApp Flows management including create, update, and publish operations
• Data endpoint configuration and encryption handling for secure flow interactions
• CLI-first workflow with kapso login and kapso status for project management
• Full end-to-end integration coverage from setup through ongoing message operations

How to Use It?

Basic Usage

Start by installing and authenticating the Kapso CLI, then confirm project access before beginning any integration work.

kapso login
kapso status

Once authenticated, generate a customer onboarding link to connect their WhatsApp account to your product.

kapso whatsapp onboard --customer-id=cust_123 --redirect-url=https://yourapp.com/success

To send a message to a connected customer, use the send command with the recipient's phone number and message content.

kapso whatsapp send --to=+14155552671 --message="Your order has been confirmed."

Specific Scenarios

Sending a Template Message: When sending transactional notifications, use pre-approved templates to ensure delivery compliance.

kapso whatsapp send-template --to=+14155552671 --template=order_confirmation --params='{"order_id":"ORD-9981"}'

Publishing a WhatsApp Flow: After creating and testing a flow, publish it to make it available to customers.

kapso whatsapp flows publish --flow-id=flow_abc456

Real-World Examples

A SaaS platform uses Kapso to send onboarding setup links to new customers via email. Once connected, the platform detects the active WhatsApp connection and begins sending weekly report templates automatically.

An e-commerce company integrates WhatsApp Flows to collect delivery preferences during checkout. The flow data is received through a configured data endpoint, processed server-side, and stored in the order management system.

Important Notes

Requirements

• Kapso CLI installed and authenticated using kapso login
• Active Kapso project with confirmed access via kapso status
• A Meta Business account with WhatsApp Business API access approved
• A publicly accessible HTTPS endpoint for receiving webhook events