Sendy — Product & Developer Documentation

The WhatsApp Engagement Advantage

While traditional email commands less than a 20% open rate and SMS messages are frequently blocked by carrier filters, WhatsApp delivers an industry-leading 98% open rate and a 45–60% click-through rate. Sendy connects your business directly to Meta Cloud API without intermediary markups, ensuring sub-second delivery receipts and zero account ban risks.

Official Meta Conversation Categories

• Marketing: Outbound promotions, offers, product drops, and re-engagement campaigns.
• Utility: Order receipts, payment confirmations, appointment reminders, and shipping updates.
• Authentication: Time-sensitive one-time passcodes (OTP) for customer login and verification.
• Service (Customer-Initiated): Inbound customer support inquiries (24-hour service window).
• Click-to-WhatsApp Ads (CTWA): 72-Hour FREE messaging window provided directly by Meta when users click your ad!

Phone Number Quality Rating & Daily Limits

Meta assigns a live Quality Score to each registered WhatsApp line: GREEN (High), YELLOW (Medium), or RED (Low). As your broadcast engagement remains high, Meta automatically upgrades your daily tier limit:

Mandatory Variable Sample Validation (`body_variables_sample`)

Meta's automated NLP compliance will instantly reject any template containing parameters like {{1}} or {{2}} if realistic sample values are omitted. As you type variables in Sendy Studio, sample input fields are automatically generated and previewed live on an interactive smartphone simulator before submission.

1-Click Bi-Directional Sync with Meta

Clicking "Sync with Meta" queries Meta Graph API directly, automatically syncing newly approved templates, status changes, and deletion events between Meta Business Manager and your Sendy workspace.

Eliminate guesswork by testing different messaging angles, discount offers, or media creative (static image vs dynamic video). The engine automatically shuffles the audience and distributes contacts evenly across Variant A (50%) and Variant B (50%) with zero bias.

💡 Real-World Example: D2C Footwear Weekend Flash Sale (10,000 Contacts)

Meta restricts how many marketing messages a user can receive across all businesses in a 24-hour cycle. When competing brands message users first, Meta rejects new broadcasts with Error 131049: Message undeliverable due to fatigue limits.

Example Festive Impact: On a 20,000-contact Diwali campaign where 3,200 contacts hit Meta's fatigue limit, the Auto-Healer recovered 3,088 contacts (96.5% recovery rate) the next morning, generating an additional ₹4,62,500 ($5,550) in revenue with zero manual re-uploads.

Bulk Multi-Customer Enrollment & Real-Time Delivery Receipts

Marketers can enroll thousands of contacts simultaneously by tag, whole database, or table checkbox selection. Clicking "Delivery History" displays a live audit timeline with official WhatsApp delivery receipts:

When a customer asks "Where is my package?" or "What is my EMI balance?", the ApiNode fires a live HTTP request to your Shopify store, ERP, custom CRM, or database:

Private Internal Team Notes

Team members can leave internal notes directly inside the customer chat timeline. Notes are highlighted in amber and invisible to the customer, ensuring complete context when re-assigning leads.

4-Step CTWA Campaign Creation Wizard

1. Budget & Account: Select your Meta Ad Account (act_...) and daily spend.
2. Targeting & Placements: Filter geography, age, and search Meta's live interest database via Sendy's Interest Search Proxy.
3. Media Upload & Hash: Upload creatives; Sendy generates official Meta image_hash tokens automatically with dual Instagram/Facebook previews.
4. Pre-Filled Message & Auto-Responder: Configure the message pre-filled in the buyer's WhatsApp bar and assign a template to trigger automatically upon click.

The 72-Hour Free Conversation Benefit

Whenever a customer initiates a WhatsApp conversation by clicking a Meta CTWA ad, Meta grants a 72-hour completely free messaging window. All business replies and follow-ups within these 3 days incur zero conversation fees.

x-api-key: YOUR_SENDY_API_KEY
Content-Type: application/json

curl -X POST https://api.sendy.weservecodes.com/v1/messages/template \
  -H "x-api-key: YOUR_SENDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+919876543210",
    "template_name": "order_confirmation_v2",
    "language": "en",
    "parameters": ["John Doe", "ORD-98421", "INR 2,499"]
  }'

Interactive In-App API Playground (`/api-test`)

Evaluate APIs without writing code. Select any approved template, populate variables in form fields, and inspect real-time JSON responses, HTTP status codes, and round-trip server latency directly in your browser.

3. Two-Way Customer Sync & Smart Audience Segmentation

Customer profiles and total order spend are continuously synchronized from your online store into Sendy's CRM. Sendy applies dynamic tags automatically:

Marketers can instantly filter campaigns: "Send a 20% festive voucher only to customers tagged VIP Shopper who haven't purchased in the last 60 days."

4. Meta Product Catalogs & In-Chat Commerce

Sync your Meta Commerce Manager catalog directly with Sendy. Send single-product cards or multi-item carousels in WhatsApp chat, allowing shoppers to view descriptions, select sizes, add items to a native WhatsApp cart, and complete purchase with integrated payment links.

Telegram Bot Integration

Paste any HTTP API Token generated by Telegram's @BotFather. Sendy automatically provisions secure webhooks to route Telegram alerts and bot flows without requiring separate backend code.

Ecosystem Diagnostics & Error Audit (`/logs`)

Monitor Meta Cloud API response latency graphs (P50/P99), queue worker depths, and real-time error logs surfacing internal Meta error codes (131026: Undeliverable, 131049: Fatigue Limit, 131051: Parameter Mismatch).