Waappa API Guide

WhatsApp MCP

WhatsApp MCP is useful when an AI assistant needs controlled WhatsApp actions instead of unrestricted backend access. Waappa can act as the WhatsApp tool layer for assistants that need to send approved replies, check session status, trigger workflows, notify teams, and hand off conversations to humans.

Why MCP matters for WhatsApp

MCP gives AI assistants a structured way to call tools. Instead of asking a model to know every API detail, you expose specific WhatsApp actions with clear permissions, inputs, logging, and safety rules.

  • Send an approved WhatsApp reply
  • Check session status before sending
  • Send alerts to internal groups
  • Trigger CRM or support workflows
  • Fetch context before replying
  • Require human approval for sensitive actions

Waappa as the WhatsApp tool layer

Waappa provides the WhatsApp session and messaging layer. Your MCP server or assistant backend can call Waappa APIs while keeping tool permissions narrow and auditable.

  • Session-scoped API keys
  • REST endpoints for actions
  • Webhooks for incoming events
  • Message and event logs
  • n8n and backend workflow compatibility
  • Group and media workflows where supported

Assistant workflow examples

A WhatsApp MCP setup can power customer support assistants, sales assistants, monitoring responders, operations bots, reminder agents, and internal helpdesk tools.

  • AI support assistant replies to FAQs
  • Sales agent qualifies leads and alerts owner
  • Monitoring assistant sends incident updates
  • Reminder agent follows up on due tasks
  • CRM assistant logs messages and next steps
  • Human handoff for low-confidence replies

Guardrails for assistant tools

Do not give AI assistants unrestricted messaging power by default. Limit tools by session, recipient type, message type, approval requirement, and rate limits.

  • Restrict tools by session
  • Log every assistant action
  • Use approval for sensitive sends
  • Add delay and rate limits
  • Avoid cold bulk outreach
  • Respect opt-outs and customer preferences

Pricing

Waappa uses session-based pricing for predictable WhatsApp automation costs.

Most popular

Starter

For testing, solo builders, and one WhatsApp account.

₹699/mo

+ GST

  • 1 connected WhatsApp account
  • Linked-device QR connection
  • REST API and webhooks
  • Text, media, document, contact, and location messages
  • No Waappa per-message fee
  • 3-day free trial

Growth

Best for small teams running support, sales, and automation flows.

₹1,999/mo

+ GST

  • 3 connected WhatsApp sessions
  • Approx ₹666 per session
  • SDKs, n8n nodes, MCP, and webhooks
  • Group and channel workflow support
  • Higher automation capacity
  • Best value for growing teams

Business

For teams that need more numbers, routing, and monitoring.

₹2,999/mo

+ GST

  • 5 connected WhatsApp sessions
  • Approx ₹600 per session
  • Business automation workflows
  • Sales, support, and monitoring use cases
  • Priority guidance for setup
  • Lower per-session cost

Partner

For agencies, SaaS builders, and resellers managing many clients.

₹1,999 platform/mo

+ GST

  • ₹1,999 platform fee
  • ₹599 per active session/month
  • Approx ₹20 per active session/day
  • Pay as you grow
  • Useful for client-by-client billing
  • Partner onboarding support

Official API vs Waappa

The official WhatsApp API and Waappa solve different problems. Use this comparison to choose the right fit.

Area
Waappa linked-device API
Official WhatsApp API
Connection model
Connect an existing WhatsApp account by QR/session linking.
Connect through Meta's WhatsApp Business Platform and approved business setup.
Best for
Developers, AI agents, n8n workflows, internal monitoring, groups, sales follow-ups, and flexible automations.
Verified business messaging, large brand campaigns, template-based notifications, and compliance-heavy use cases.
Existing WhatsApp use
Can use WhatsApp as-is with the connected account experience.
Usually requires official business setup, phone number onboarding, and approved messaging flows.
Groups
Useful for group automation, internal alerts, and operations workflows.
Official Cloud API is generally focused on business-to-user messaging, not broad group automation.
Message cost
No Waappa per-message fee. Pricing is based on connected sessions.
Platform/provider costs plus Meta message/template fees may apply.
Templates
More flexible for normal conversational workflows.
Template approval is central for business-initiated messages.
Risk profile
Bulk or spam-like usage can cause account blocks, reports, or disconnects.
More formal compliance model, but still subject to Meta policy and quality controls.
Developer flexibility
REST API, webhooks, SDKs, n8n, MCP, AI agent workflows, media, contacts, locations, groups, and monitoring flows.
Strong official APIs for approved business messaging, templates, webhooks, and enterprise messaging.

Bulk Messaging Safety

Linked-device WhatsApp automation is powerful, but aggressive bulk messaging can cause reports, blocks, or disconnections.

  • Use opt-in contacts and avoid cold spam.
  • Add delays between messages instead of blasting instantly.
  • Personalize messages and avoid sending identical text to large lists.
  • Respect replies, blocks, opt-outs, and customer preferences.
  • Use groups for relevant internal or community workflows, not unsolicited promotion.
  • Warm up new numbers slowly and monitor delivery, reports, and disconnections.

FAQ

Does Waappa support WhatsApp MCP workflows?

Waappa is positioned as the WhatsApp API/tool layer that an MCP server or AI assistant backend can use for controlled WhatsApp actions.

Why use MCP instead of direct API calls from an AI agent?

MCP helps define safer, narrower tools with clear inputs and permissions. Direct API calls are useful for normal backend code, while MCP is helpful for assistant-controlled actions.

Can MCP tools send WhatsApp group alerts?

Yes, if the connected Waappa session and workflow support the target group. Group alerts are useful for monitoring, operations, and internal handoff.

Can bulk messaging get blocked?

Yes. Any WhatsApp account can face blocks, reports, rate limits, or disconnection if it sends spam, cold bulk messages, repetitive content, or messages without consent. Waappa should be used with delays, opt-ins, human-like pacing, and real customer context.