Collect more responses with interactive WhatsApp surveys and 250+ industry-ready templates
Customize, connect, and send branded surveys right inside your customer's WhatsApp chat. Star ratings, tappable answers, and follow-up questions, answered in one tap, no extra app or form.
Survey templates built for every industry
Texting just grew up. Meet WhatsApp Business Platform.
WhatsApp Business Platform takes surveys beyond plain texting. Instead of a plain link to a survey form, you ask branded, interactive questions, star ratings, tappable answers, and recommend scales, right inside the WhatsApp chat your customer already uses. They answer in one tap, so far more people actually respond. No survey app or link to open.
- · Plain text, no branding, easy to ignore
- · Shady-looking link to a separate form
- · Extra taps to open, most never finish
- · You can't tell who really sent it
Thanks for shopping with us! Tap a rating below, it takes one second and helps us improve.
- · Verified, branded sender
- · Images, carousels & buttons
- · Two-way, app-like conversations
- · Read receipts & rich analytics
A complete survey flow, start to finish
One WhatsApp thread asks the question, collects a one-tap answer, branches to the right follow-up, and says thanks: a conversation, not a form to fill out.
A branded rich card asks the first question with tappable answers.
Star ratings and reply chips turn questions into instant, structured responses.
Each answer triggers the right next question, right in the thread.
Hand off to staff the moment a guest needs a person.
One survey channel. Endless use cases.
From post-event feedback to five-star stays, WhatsApp Surveys gives every team a head start. Browse a few of the survey journeys you can launch today.
A searchable library of 250+ designed surveys
Browse by industry, survey type, tone, provider, and use case. Preview a survey template, make it yours, and send, all in one streamlined workflow built for feedback teams.
Thanks for joining us, {{first_name}}! On a scale of 1–5, how likely are you to recommend Summit to a colleague? Tap a number — that's the whole survey.
Post-Event Net Promoter
We hope the Ocean Suite treated you well! Tap a star rating below — and if anything fell short, tell us and a manager will make it right today.
Post-Stay Satisfaction
You just finished setup, {{first_name}}. How easy was it to get going? Your answer helps us smooth out the rough edges for everyone.
Onboarding Check-In
Your support changes lives. What matters most to you about our work right now? Pick one — it shapes where we focus next quarter.
Donor Pulse
Your order landed a week ago — how's it holding up? Tap a rating, and if you love it we'll help you post a review in two taps.
Post-Purchase Review
Now that we've wrapped, {{first_name}}, how satisfied are you with the outcome? Three quick taps and an optional note — that's it.
Engagement Wrap-Up
Thanks for seeing Dr. Patel today. How would you rate your visit? Your feedback is confidential and helps us care for patients better.
Visit Feedback
Order #{{order_id}} was delivered, {{first_name}}. How easy was the delivery and tracking experience? One tap tells us a lot.
Delivery Experience
We've got room for one big feature this quarter, {{first_name}}. Which should we ship first? Tap to vote — results update live.
Feature Vote
Sorry to see you cancel. What was the main reason? It's anonymous, takes one tap, and genuinely shapes what we fix next.
Churn-Reason Survey
Two dishes, one spot on the menu, {{first_name}}. Which should we run this weekend? Voters get 10% off when they come in.
Weekend Quick Poll
Three months in, {{first_name}} — how likely are you to recommend Peak to a friend? Tap a score, and tell us one thing we could do better.
Member Satisfaction
250+ ready-made survey templates
A searchable library covering every survey you can imagine.
Industry-specific survey packs
Curated bundles built for your vertical, out of the box.
Drag-and-edit customization
Swap questions, scales, and media without touching code.
Rich questions & actions
Star ratings, recommend scales, answer buttons, and reply chips built in.
Provider-ready exports
Export clean payloads for your messaging provider.
Response-ready copy
Clear, on-brand questions written to get answered.
Team-friendly workflow
Share, duplicate, and ship together in one place.
Fast launch
Go from idea to live survey in minutes, not weeks.
Build once. Send through any provider.
WhatsApp Surveys is provider-flexible. Design your survey one time, then connect it to the backend that sends it to your customers. Switch or add providers whenever you need to.
Survey-sending features by provider
A high-level look at the WhatsApp Business Messaging capabilities that matter for sending surveys. Summarized from each provider's public docs; verify specifics on their WhatsApp page.
| Feature | Sureshot | Signalmash | |||
|---|---|---|---|---|---|
| Rich question cards | |||||
| Carousel questions | |||||
| Tappable answers & reply chips | |||||
| Media (images / video / files) | |||||
| Branded & verified survey sender | |||||
| Two-way responses | ? | ||||
| Read receipts & typing | |||||
| Delivery & response analytics | |||||
| Global reach |
Marketing-native WhatsApp for B2C teams, with consent & compliance built in.
Standout: TCPA-compliant consent management, pre-flight message scanning & unified analytics.
Sureshot WhatsApp pageBoutique CPaaS with a no-code messaging studio, focused on US senders.
Standout: Drag-and-drop messaging studio with hands-on sender registration.
Signalmash WhatsApp pageProgrammable messaging at global scale: WhatsApp in one API alongside SMS and MMS.
Standout: Content Template Builder for reusable, interactive message templates.
Twilio WhatsApp pageWhatsApp through the unified Vonage Messages API for developers.
Standout: One Messages API spanning WhatsApp, SMS, and MMS.
Vonage WhatsApp pageUS-focused enterprise messaging with sender-registration expertise.
Standout: Enterprise messaging APIs with hands-on onboarding and registration support.
Bandwidth WhatsApp pageSkip the approval maze. Launch in days, not weeks.
Getting your branded WhatsApp survey sender live means clearing Meta business and sender verification, Meta template review, and each provider's own content rules: a slow, opaque process where a single missed detail sends you back to the start. WhatsApp Surveys streamlines it using patterns from senders that are already approved.
Why WhatsApp survey senders get stuck
Business & sender verification
Before a single survey sends, your business and WhatsApp Business sender must be verified with Meta, typically through your provider. Incomplete business details, display name, or profile information bounce the application back to the start.
Varies by businessMeta template review
Every business-initiated survey message uses a template that Meta reviews and categorizes as Utility or Marketing. A template that's unclear or written for the wrong category gets rejected or reclassified.
Per templateProvider-specific requirements
Twilio, Vonage, Bandwidth and others each have their own submission formats, content policies, and opt-in proof. Miss a detail and you're back in the queue for another round.
Different per providerApprovals built on what already works
Instead of guessing what Meta's reviewers want, you start from survey templates shaped by senders that have already cleared review. The branding, opt-in language, and message structure are already aligned with what gets approved, so you submit with confidence and spend far less time in rejection loops.
- Modeled on similar, already-approved survey senders
- Fewer rejections and resubmissions
- Submission formatted correctly per provider
- Hands-on support to resolve reviewer flags
- 1
Start from a pre-vetted survey template
Your survey is built on a structure modeled after similar surveys that have already been approved: content, branding, and opt-in patterns reviewers expect.
- 2
Submit against a guided checklist
We map your assets to each gatekeeper's requirements up front, so brand verification, sample questions, and use-case justification are complete before you submit.
- 3
Clear Meta's review
Submissions go in the right format for each provider and market, reducing the rejection-and-resubmit loops that cause most of the delay.
- 4
Go live with support
If a reviewer flags something, we help you resolve it directly with the provider, so you reach live status without losing weeks to back-and-forth.
Approval timelines and requirements are set by Meta and your messaging provider and vary by business, use case, and region. WhatsApp Surveys can't guarantee approval, but a pre-vetted, correctly-formatted submission is the single biggest lever for getting through review faster.
See what Meta actually approved, not just that it did
Utility and Marketing aren't a label you pick when you build a survey, they're a rule Meta enforces, and getting it wrong doesn't bounce your submission, it quietly breaks delivery weeks later.
A survey and a status update look alike
A delivery confirmation and a delivery feedback survey can share almost the same words, but WhatsApp treats them completely differently. “Your order is out for delivery” is Utility. “How was your delivery?” is Marketing, even naming the same order, because it's the business asking for something rather than delivering something the customer needs.
Same order, different categoryMeta can re-file your category
Submit a survey as Utility and Meta's own review can still approve it as Marketing. Most survey tools show only “Approved,” so the re-filing is invisible until sends start failing.
Even when Utility is requestedA blocked category fails silently
Marketing-category templates are currently blocked from delivering to US numbers outright. If your survey was quietly re-filed as Marketing, every send to a US respondent disappears with no obvious reason why.
US delivery, blockedThe real category, on every survey
Every survey shows the category Meta actually approved, color-coded, right next to the approval status. If a Utility submission comes back re-filed as Marketing, you see it immediately instead of finding out from a run of failed sends.
- Meta's real, final category shown on every survey
- A clear warning the moment a re-filing happens
- Utility submissions are pinned so Meta can't silently swap the category
- Delivery status and rejection reason in one place
“Your order #4471 is out for delivery, arriving by 3pm.” A message the customer needs, tied to something they already started.
“How was your delivery experience?” Naming the same order doesn't change what it is: a survey request that serves the business, not the customer.
Category rules and the current US Marketing block are set by Meta and can change. WhatsApp Surveys can't guarantee a category holds, but showing you the real one the moment it's decided is what turns a silent failure into something you can fix.
Go from survey templates to intelligent feedback
Pro turns your survey library into a personalized, AI-powered feedback engine with real-time response analytics, no full engineering team required.
Upload CSV, personalize every survey
Map customer variables in seconds.
Personalize surveys with names, dates, booking details, recent purchases, event info, and any custom field you bring.
AI that reads every response
Themes, summarizes, and follows up, 24/7.
AI reads open-ended answers, tags them by theme, summarizes the sentiment, and auto-sends a smart follow-up question to close the loop, grounded in your knowledge base.
Survey flows
Multi-step surveys that ask, branch, and follow up.
Chain survey templates into automated journeys: reminders, re-asks, post-purchase pulses, and onboarding check-ins. Each step can wait, branch on the customer's answer, or let AI ask the right follow-up. Start from 200+ ready-made survey flows across every industry.
Build smarter survey flows, branching journeys, triggers, and AI response analysis, without needing a full engineering team.
AI that reads responses from your knowledge base
Connect your FAQs, policies, listings, and docs. The AI reads every survey response, themes and summarizes open-ended answers, auto-asks the right follow-up question grounded in your content, and hands off to a human when needed.
FAQs, policies, listings, menus, and docs: your content grounds every follow-up question.
Open-ended answers are tagged by theme and summarized, so patterns surface without manual reading.
The AI closes the loop with a smart, on-brand follow-up question grounded in your knowledge base.
When a response needs a person, it escalates to your team instantly.
Explore AI Ambassador, purpose-built AI experiences for events, vacation rentals, hotels, and nonprofits.
Now your surveys are agent-native
Beyond a human dashboard: an authenticated gateway lets autonomous AI agents discover, author, clone, send, and analyze WhatsApp surveys programmatically — exposed as an MCP server, a CLI, and an embeddable client.
MCP server
wa-surveys-mcpProDrop the library into any MCP-capable agent
CLI
wa-surveysProJSON in, JSON out — pipe it anywhere
Typed client
GatewayClientEmbed the gateway in your own code
Least-privilege keys, the same provider-approval gate as the human app, and packaged workflows from find-and-clone-survey to survey-in-a-box.
See how WhatsApp Surveys works
Watch a quick walkthrough: choose a survey, customize it, connect your provider, upload variables, and send the survey, start to finish in minutes.
Simple plans that scale with your surveys
Start free, upgrade when you're ready to send. Every plan is built to help feedback teams move faster.
Free
Explore the library and test survey ideas.
- Full access to 500 survey questions
- 10 free survey sends to test
- Survey previews & customization
- Basic response analytics
Best for testing survey ideas
Pro
Everything you need to launch real surveys.
- 300 survey questions / month
- Full access to 500 survey questions
- CSV variable uploads
- AI response analysis: theming & summaries
- Real-time response analytics & dashboards
- Survey flows with answer-based branching
- Agent toolkit: MCP server, CLI & gateway keys
- Provider integrations
- Direct survey-sender submission to all providers, with support to resolve any issues
Best for growing teams & agencies
Enterprise
Scale surveys across brands, teams, and regions.
- Everything in Pro, plus:
- Custom survey libraries
- Advanced provider setup
- Dedicated onboarding
- Team permissions
- Custom AI workflows & agent skill chains
- Priority support
Best for large brands & high-volume teams
Questions, answered
New to WhatsApp surveys? Search 30+ answers, or browse from the basics through exactly how WhatsApp Surveys gets you live.
WhatsApp basics
New to WhatsApp surveys? Start here.What is a WhatsApp survey?
A WhatsApp survey is a short feedback survey a business sends to customers as a WhatsApp message, so people answer right in the chat with a tap instead of opening a link to a web form. Questions can use tappable answer buttons, rating scales, and suggested replies, plus an open-ended question the customer simply types back. Because the whole survey happens in one conversation thread, it fits the way people already message every day.
What is the WhatsApp Business Platform?
The WhatsApp Business Platform is Meta's API for businesses that need to message customers on WhatsApp at scale, as opposed to the WhatsApp Business app a small shop runs from one phone. It is what lets a brand send approved message templates, interactive messages with buttons, and automated conversations to opted-in customers. Most teams reach it through a messaging provider such as Twilio, or directly through Meta, and WhatsApp Surveys connects to both.
Do my customers need anything special to answer a WhatsApp survey?
They only need WhatsApp itself. The survey arrives as a normal WhatsApp message on Android or iPhone, and customers answer in that same chat, with no extra app, account, survey link, or form to load. If someone doesn't use WhatsApp, they won't receive the survey, so it works best for audiences who already message you there.
Is it free for the people receiving my survey?
Yes. Recipients don't pay anything to receive or answer a WhatsApp message beyond their normal mobile data or Wi-Fi. The sending business pays: Meta charges per message (rates vary by country and message category), and your messaging provider may add its own fee.
How is a WhatsApp survey different from an email or SMS survey?
A WhatsApp survey is answered inside the conversation, while email and SMS surveys usually send people to a link and a separate web form. On WhatsApp, customers tap an answer button or type a reply in the same thread, and the message comes from your business's WhatsApp account rather than an unfamiliar number or address. Removing the link-and-form step is the main reason in-chat surveys are easier to complete.
Security & privacy
Consent, compliance, and read receipts.Do I need permission to send people WhatsApp surveys?
Yes. WhatsApp requires that people opt in before a business messages them, and every survey should make clear who it's from and how to stop: replying STOP unsubscribes them, with HELP pointing to support. You can't survey purchased lists. WhatsApp Surveys templates include opt-in and STOP handling so consent is built in rather than bolted on.
Does using WhatsApp change my obligations under rules like GDPR or TCPA?
No. The channel doesn't change your legal obligations, it inherits them. The same rules that govern customer messaging and personal data still apply: get clear opt-in consent, identify yourself, honor opt-outs immediately, and handle responses under your privacy policy. This isn't legal advice, so confirm the specifics for your markets with counsel.
Can a business see whether I read its WhatsApp message?
Often, yes. WhatsApp reports whether a business message was sent, delivered, and read, though read status only appears when the recipient has read receipts turned on. Survey senders use these statuses to see where a send stalled, alongside the actual answers customers tap or type.
WhatsApp for business
Templates, approval, and pricing.How do I start sending WhatsApp surveys as a business?
You need a WhatsApp Business sender, a messaging provider, and approved survey templates. In practice: set up a WhatsApp Business account and phone number through a provider such as Twilio or Meta, connect it to WhatsApp Surveys, pick and customize a survey template, and submit it for Meta's template approval. Once the template is approved, you can send it to opted-in customers.
Why do WhatsApp survey templates need approval?
Meta requires approval for any message a business starts, so a survey you send first must be an approved message template. During review Meta also assigns the template a category, Utility or Marketing, which affects whether and where it can be delivered. Once a customer replies, the conversation can continue within WhatsApp's customer service window.
What's the difference between Utility and Marketing WhatsApp templates?
Utility templates are tied to a specific transaction or account event, like an order update or a survey anchored to a purchase the customer just made, while Marketing templates are anything promotional or general-interest. Meta enforces the category, can re-file a template during review, and Marketing templates are currently blocked from delivering to US numbers, so a re-filed survey can quietly stop arriving. WhatsApp Surveys shows Meta's real, final category on every survey and flags any change. Our post "Utility vs Marketing: why your WhatsApp survey can get blocked without warning" covers it in depth.
How much does it cost to send WhatsApp messages?
Meta charges the business per message, and the rate depends on the recipient's country and the message category (for example Utility versus Marketing), so there isn't one universal price. Your messaging provider may add its own per-message fee on top. Those sending charges are billed by the provider you connect, separate from your WhatsApp Surveys plan.
Do I need a direct relationship with Meta to send WhatsApp surveys?
No. Most teams work through a messaging provider, such as Twilio, that handles the WhatsApp Business Platform connection and template submission for them, though you can also connect to Meta directly. You bring your brand and your surveys; the provider handles delivery.
What kinds of survey questions can I actually ask over WhatsApp?
A lot more than a plain text can. You can ask a tappable star rating, a 1-to-5 recommend scale, a Customer Satisfaction or Customer Effort question with suggested-reply chips, multiple-choice questions as tappable answer buttons, or a swipeable carousel of choices. You can branch on the answer (a low score opens a "what went wrong?" follow-up; a high score asks for a review) and end with an open-ended question the customer simply types back. Underneath it's still a conversation, so the whole survey happens in one thread, one tap at a time.
Can customers reply to my WhatsApp surveys, and can I automate the follow-ups?
Yes on both counts. WhatsApp is genuinely two-way, so customers answer in the same thread, and suggested-reply chips and answer buttons make responding as easy as a tap. You can automate the survey with flows that branch on how someone answers, a low rating triggers a "sorry to hear that, what happened?" follow-up while a high rating asks for a public review, and with WhatsApp Surveys Pro you can layer in an AI assistant, grounded in your own knowledge base, that reads open-ended replies, asks a smart clarifying question, and routes urgent complaints to a human. That keeps your feedback loop running around the clock without anyone watching the inbox.
Can I track responses and analyze results on WhatsApp surveys?
Yes. Because WhatsApp is a two-way channel, you get live response analytics: delivery and read statuses (read only when the recipient has read receipts on), every star rating and answer-button tap, and the open-ended replies customers type back, all rolling up in real time rather than waiting for a survey to close. You can watch your Net Promoter Score or Customer Satisfaction score move as responses land, segment by question, and read open-ended answers as they come in.
Will WhatsApp actually improve my survey response rates?
It's designed to, by removing the friction that holds email and SMS surveys back. A message from your own business account is recognizable; a tappable star rating or answer button lets customers respond in a single tap instead of clicking a link, loading a form, and switching apps; and because the survey lives in the inbox, people finish it in the same thread it arrived in. Your exact numbers will depend on your audience and timing, but the mechanics, more trust and one-tap answering instead of a link to a separate page, are squarely pointed at hearing back from far more of your customers.
Using WhatsApp Surveys
How the product works.Do I need to be technical to use WhatsApp Surveys?
No, it's built for marketing, customer-experience, and ops teams, not developers. Every survey template is drag-and-edit: swap the questions, scales, answer buttons, suggested replies, colors, and images in a visual editor without touching code. When you're ready to send, you connect your provider once and reuse it for every survey. Pro layers on CSV personalization (map fields like first name, order number, or visit date in a few clicks), multi-step branching survey flows, and AI that reads and follows up on open-ended replies, all configurable by anyone on the team. Developers can go deeper via your provider's API if you want to, but nothing here requires it.
How many survey templates are included?
250+ professionally designed, ready-to-send survey templates spanning 80+ survey categories across 13 industries (retail, hospitality, healthcare, events, real estate, finance, automotive, and more) plus 200+ ready-made multi-step survey flows. You'll find Net Promoter Score, Customer Satisfaction, and Customer Effort surveys, post-purchase and post-visit feedback, event and onboarding check-ins, and more, each shipping with the right question types (star ratings, 1-to-5 scales, answer buttons, open-ended prompts) and on-brand styling already in place, so you start from something proven rather than a blank canvas. Full access to the entire library is included on every plan, including Free; Pro and Enterprise add personalization, AI follow-ups, branching flows, deeper analytics, and higher send volumes on top.
Which providers can I connect?
We're provider-flexible, so you're never locked in. Twilio and Meta are active now, with Vonage and Bandwidth coming soon, and you can always bring your own WhatsApp gateway and we'll help you wire it up. The key idea is build once, connect anywhere: you design and personalize your survey a single time, then point it at whichever backend fits your stack. Switch providers or add new ones whenever you need to, without rebuilding a thing.
Can I personalize surveys for each recipient?
Yes. On Pro you can upload a CSV and map fields like first name, order number, appointment date, or the product they bought into any survey in a few clicks, so every recipient gets a survey that reads like it was written for them ("How was your stay at the Harbor Suite, {{first_name}}?"). Personalization works hand in hand with branching flows and AI follow-ups, which means you can tailor not just the opening question but the whole conversation based on who they are and how they answer. It's the difference between a generic blast and a survey that feels one-to-one, at scale.
Can the AI actually read and follow up on open-ended responses?
Yes. With Pro, an LLM grounded in your own knowledge base (FAQs, policies, listings, hours, pricing, and docs) can read what customers type back, ask a smart clarifying question in your brand voice, and act on it, around the clock. It handles real back-and-forth: thanking happy respondents and nudging them toward a public review, asking an unhappy respondent what specifically went wrong, summarizing themes across open-ended answers, and routing urgent complaints to a human the moment a response needs one. Pair it with branching survey flows to ask the right next question based on how someone rated you, so your feedback loop keeps running even outside business hours.
Can I bring my own WhatsApp provider or number?
Yes. Bring-your-own-gateway is a core part of the design, so if you already have a WhatsApp provider or sender set up, you can connect it and keep your existing numbers and relationships. If you don't, you can start with one of our active integrations like Twilio or Meta. Either way you build and personalize your surveys once and route them through whatever backend you choose, which keeps you in control and avoids lock-in.
What does WhatsApp Surveys cost?
There's a Free plan that includes full access to the 250+ survey template library plus a handful of free WhatsApp sends to test, so you can run a real survey before paying anything. Pro adds CSV personalization, AI follow-ups, branching survey flows, provider integrations, deeper response analytics, and a monthly send allowance, with Enterprise for higher volumes and custom needs. Note that the per-message sending charges come from whichever provider you connect, separate from your plan, so you keep full visibility into those rates.
When is the best time to send a survey?
Right after the moment you're asking about, while it's still fresh. Trigger a post-purchase survey when the order is delivered, a post-visit survey within an hour or two of checkout, a support survey the moment a ticket closes, and an onboarding check-in a week or two in. Because WhatsApp lands in the inbox people actually watch, a well-timed one-tap question gets answered far more often than a survey email sent the next day. Keep it short, lead with a single rating, and only branch into deeper questions for people who tap through, you'll get more honest, more complete responses than a long form ever collects.
Are WhatsApp survey responses anonymous?
That's up to you, and it's worth deciding deliberately. Because you send to your own opted-in contacts, you generally know who you're surveying, which is great for closing the loop on a specific bad experience or following up one-to-one. When you want candid feedback at the program level (employee pulse checks, sensitive topics), you can present and report responses in aggregate so individuals aren't singled out, and make clear in the opening message how the answers will be used. Either way, every survey respects opt-in and STOP, and you should only collect what you actually need.
How long does it take to get a WhatsApp survey approved?
It depends on Meta's review, not on us. Every business-initiated WhatsApp survey has to be an approved message template, and Meta reviews each template and assigns it a category; your WhatsApp Business account and provider have their own setup and opt-in requirements too. A submission that's missing details or reads as promotional is the most common cause of a rejection or an unexpected Marketing category. WhatsApp Surveys streamlines it: templates are written to be transaction-anchored with opt-in and STOP handling built in, submissions pin the Utility category, and every survey shows the category Meta actually approved. We can't guarantee approval (that decision is Meta's), but a correctly formatted submission is the biggest lever for getting live faster.
Agents & automation
Use WhatsApp Surveys from AI agents, MCP, and the CLI.Can AI agents use WhatsApp Surveys programmatically?
Yes. WhatsApp Surveys is agent-native. An authenticated gateway (/api/agent) lets an autonomous AI agent discover, author, clone, render, send, and pull results from WhatsApp surveys without anyone clicking through a dashboard. The same gateway is exposed three ways over one typed contract: a Model Context Protocol (MCP) server, a command-line tool, and an embeddable client. So whether you're building on Claude, an agent SDK, or your own service, the platform behaves like a first-class tool rather than a website you have to script a browser against.
Does WhatsApp Surveys have an MCP server?
Yes. The @wa-surveys/agent-toolkit ships an MCP server called wa-surveys-mcp (hand-rolled, zero runtime dependencies, JSON-RPC over stdio). Register it once with any MCP host — for Claude it's a single `claude mcp add` command pointing at npx -y -p @wa-surveys/agent-toolkit wa-surveys-mcp with your agent key (the toolkit talks to the hosted gateway by default) — and your agent gains ten native tools: capabilities, search_surveys, get_survey, render_survey, create_survey, clone_survey, submit_survey, send_survey, get_results, and get_usage. The MCP server is available on the Pro plan.
Is there an API or CLI for WhatsApp Surveys?
Yes to both. Under the hood everything runs over the /api/agent HTTP gateway, and the agent toolkit wraps it as a JSON-in/JSON-out CLI (the `wa-surveys` command) so you can search, render, clone, create, send, and read results from a shell, CI, or an agent loop — pipe it straight into jq. There's also a typed GatewayClient you can embed in your own code. The packaged MCP server and CLI are Pro-plan features; the gateway and typed client are available to embed in your own service.
How do AI agents authenticate, and is sending safe?
Agents authenticate with scoped API keys (prefixed wak_), minted by an org admin and shown only once before being stored as a hash. Each key carries a least-privilege set of scopes — surveys:read, surveys:write, surveys:submit, marketplace:clone, surveys:send, results:read, usage:read — so a key can only do what it was minted for, and it's revocable at any time. The agent gateway is a separate rail from the human app: neither token works on the other's surface. Sending is hardened too — destinations are validated as E.164 numbers, the gateway is rate-limited, and an agent send must clear the exact same provider-approval gate as a human send, so there's no back door to ship an unapproved survey.
Are there ready-made agent workflows (skills)?
Yes. Four packaged skill chains string the tools into repeatable jobs: find-and-clone-survey (shop the marketplace and clone the best-fit survey), author-and-publish (turn a brief into a validated survey and submit it for approval), survey-in-a-box (clone, validate, send, and report the response funnel), and response-analyst (read results and open-ended replies and summarize the themes). Each declares the least-privilege scopes it needs, so you can mint a key that matches exactly one workflow. A per-call crypto payment rail (x402, USDC on Base) for cloning and sending without an account is fully designed and coming soon.
Be first to send next-gen WhatsApp surveys
Request early access and we'll get you set up with survey templates, your provider, and AI-ready survey flows, so you can start collecting responses the moment you're in.
- First access to 250+ survey templates
- Onboarding help from our team
- Provider setup guidance
- Early-adopter pricing