← All Tools
🤖

WhatsApp Research Agent API

One API call. Full agentic market research. Describe your task in plain language — the agent discovers contacts on Google Maps, extracts questions via LLM, and runs the WhatsApp survey automatically.

API Docs $0.050 / contact · min $0.50

About this tool

The WhatsApp Research Agent is a fully agentic pipeline that turns a plain-language research request into a complete WhatsApp market survey — with zero manual setup.

You write the task like a human: "Research 10 auto body shops in Florianópolis/SC: what's the average repair turnaround time?" — the agent handles everything else: finding businesses on Google Maps, extracting phone numbers, validating Brazilian WhatsApp numbers, generating smart questions via GPT-4o-mini, and sending the survey via WhatsApp.

Perfect for: price discovery, supplier surveys, availability checks, competitor research — fully automated, no spreadsheets required.

How it works

  1. Send task — POST /whatsapp/research/agent with your natural language task
  2. Instant response — Returns research_id immediately (async execution begins)
  3. LLM extraction — GPT-4o-mini extracts city, niche, and 2-4 survey questions
  4. Contact discovery — Playwright searches Google Maps for businesses with phone numbers
  5. Phone validation — Filters valid Brazilian WhatsApp numbers (DDD + 9 digits)
  6. Survey launch — Calls /whatsapp/research/start with discovered contacts and extracted questions
  7. Poll status — GET /whatsapp/research/agent/:id to track progress
  8. Get report — GET /whatsapp/research/:inner_id/report for structured Q&A results

Quick Start

curl -X POST https://api.iteratools.com/whatsapp/research/agent \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "task": "Pesquisa 10 funilarias em Florianópolis/SC: qual o prazo médio de reparo?", "max_contacts": 10, "callback_url": "https://your-server.com/webhook" }'

Response — research started

{ "ok": true, "research_id": "res_agent_abc123def4", "status": "discovering", "estimated_minutes": 15 }

Check Agent Status

curl https://api.iteratools.com/whatsapp/research/agent/res_agent_abc123def4 \ -H "Authorization: Bearer YOUR_KEY"
{ "ok": true, "research_id": "res_agent_abc123def4", "inner_research_id": "res_xyz789abc012", "status": "in_progress", "city": "Florianópolis", "niche": "funilarias", "questions": [ "Qual o prazo médio para reparos de funilaria?", "Vocês atendem pessoa jurídica?", "Qual o valor médio de um reparo de parachoque?" ], "contacts_found": 8, "created_at": "2026-03-20T17:00:00Z", "updated_at": "2026-03-20T17:02:30Z" }

Request Parameters

Parameter Type Description
task string (required) Natural language research task describing what to research, where, and what questions to ask
max_contacts integer (default: 10) Maximum contacts to discover and survey (max: 50)
callback_url string (optional) HTTPS webhook URL to receive a POST notification when research is underway or fails

Agent Status Values

  • discovering — LLM is parsing the task (city, niche, questions)
  • searching — Playwright is searching Google Maps for contacts
  • researching — Contacts found, launching WhatsApp survey
  • in_progress — Survey running, use inner_research_id to track responses
  • error — Something went wrong; check the error field

Pricing

$0.050 USDC per contact discovered and surveyed. Minimum charge: $0.50 per job. Paid via x402 micropayment on Base network or Bearer API key.