Sendy Documentation

Welcome to the official documentation for Sendy, the multi-channel messaging gateway. Our platform allows you to connect your Meta WhatsApp Business API and Telegram bots to send high-volume transactional and marketing messages, both through a user-friendly dashboard and a powerful developer API.

Pricing & Wallet

Sendy operates on a combination of Subscription Planssystem.

  • Subscription Plans: Determine your baseline features, such as maximum messaging speed (messages/sec), the number of allowed agents, and whether specific channels (SMS, WhatsApp, Telegram) are enabled.
  • Wallet Balance: You must load credits into your account wallet. Messages are billed on a per-message basis depending on the type of message sent (deducted from your balance).

WhatsApp Integration

Sendy integrates directly with the Meta Official Graph API. You do not need to use a phone scanner.

Step 1: Embedded Signup

Navigate to Settings in your dashboard and click the Connect WhatsApp button. Connect your business phone number securely via Meta's Embedded Signup.

Step 2: Connect Account

Log in with Facebook, select your WhatsApp Business Account (WABA), and immediately associate your business phone numbers through the secure Meta pop-up.

Step 3: Automatic Provisioning

Once connected, Sendy automatically handles line-of-credit allocation for partner billing and secure message routing. No manual API key copying or manual webhook configuration is required!

Telegram Integration

Sendy can also manage Telegram bots to send automated alerts.

  1. Open Telegram and search for @BotFather.
  2. Send the command /newbot and follow the instructions to get an HTTP API Token.
  3. Go to your Sendy dashboard Integrations -> Telegram and paste this token.
  4. Sendy will automatically configure the Telegram webhooks to manage incoming messages.

Developer API Reference

Every feature in the dashboard is powered by our developer API. You can generate an API Key from your account settings.

Authentication Headers

HTTP Headers
sendy-account-id: YOUR_ACCOUNT_SID
sendy-auth-token: YOUR_API_KEY

Send a Message

POST /v1/messages/send

curl -X POST https://api.sendy.weservecodes.com/v1/messages/send \
  -H "sendy-account-id: YOUR_ACCOUNT_SID" \
  -H "sendy-auth-token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "whatsapp",
    "to_number": "919999999999",
    "message": "Hello from API!"
  }'

Send a Message with Attachment

POST /v1/messages/send (multipart/form-data)

curl -X POST https://api.sendy.weservecodes.com/v1/messages/send \
  -H "sendy-account-id: YOUR_ACCOUNT_SID" \
  -H "sendy-auth-token: YOUR_API_KEY" \
  -F "channel=whatsapp" \
  -F "to_number=919999999999" \
  -F "message=Here is your invoice" \
  -F "file=@/path/to/invoice.pdf"

Send a Template

POST /v1/messages/send

curl -X POST https://api.sendy.weservecodes.com/v1/messages/send \
  -H "sendy-account-id: YOUR_ACCOUNT_SID" \
  -H "sendy-auth-token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "whatsapp",
    "to_number": "919999999999",
    "template_name": "welcome_offer",
    "params": ["John", "20%"]
  }'

Templates & Campaigns

Meta requires all business-initiated messages to be pre-approved templates.

  • Creating Templates: Use the Sendy dashboard to draft templates with variables (e.g., {{1}}). Meta usually approves them within minutes.
  • Broadcasting: Upload an Excel or CSV file in the Campaigns tab. Sendy will automatically map your columns (Name, Order ID) to the template variables and bulk dispatch the messages through the /bulk endpoint securely.

Automation Flows (Bot)

Sendy includes a powerful Visual Flow Builder to create automated conversational bots without coding.

  • Trigger Keywords: Define keywords (e.g., "help", "order") that trigger specific responses.
  • API Actions: You can configure a node to make an HTTP GET/POST request to your own servers to fetch dynamic data (like an order status) and reply to the customer with it.
  • Fallback: Configure a default message if the bot doesn't understand the user's input.

WhatsApp Embedded Signup

Quickly onboard your own clients by allowing them to securely connect their WhatsApp Business Accounts directly from our dashboard using Meta's Embedded Signup flow.

  • Initiation: Click "Connect with Facebook" to trigger the secure Meta pop-up.
  • Permissions: Users grant the necessary WABA permissions and select their specific WhatsApp phone numbers.
  • Automatic Sync: Sendy instantly retrieves the WABA ID, Phone Number ID, and provisions the webhook securely without requiring manual API key copying.

Meta Ads Manager Integration

Link your Facebook & Instagram Lead Ads directly to Sendy to automate follow-ups and instantly capture leads.

  • Account Linking: Authorize your Meta Ad accounts securely via our Social Connect interface.
  • Real-time Webhooks: When a prospect submits a lead form on Facebook or Instagram, Sendy receives a secure webhook instantly.
  • Instant Outreach: Automatically trigger pre-configured WhatsApp welcome messages or drip sequences to the newly captured lead within seconds.