Sending

Start sending messages with the API

Our API enables you to programmatically send WhatsApp messages, facilitating seamless communication with your users. This functionality is ideal for trigger-based events such as appointment confirmations or customer re-engagement notifications.​

Rate limiting

To comply with WhatsApp's API rate limits and ensure reliable message delivery, our system implements the following measures:​

  • Per-Sender Limit: Each individual sender number (e.g., +1234567890) is restricted to sending one message every 10 seconds. This rate limiting helps prevent exceeding WhatsApp's API constraints and maintains optimal delivery performance.​

  • Message Queueing: While you can initiate multiple messages simultaneously, our system queues these messages and dispatches (fifo) them sequentially, adhering to the 10-second interval per sender number. This approach ensures compliance with rate limits while allowing for high-volume messaging.​

Implementing these controls helps prevent exceeding WhatsApp's thresholds, which could result in temporary restrictions or errors.​

Use cases

This API is particularly useful for:​

  • Appointment Confirmations: Automatically notify users of upcoming appointments, reducing no-show rates.​

  • Customer Re-Engagement: Send timely reminders or promotional messages to encourage user interaction and retention.​

By integrating this API into your application, you can enhance communication efficiency and improve user engagement through automated WhatsApp messaging.​

Send a WhatsApp message

post

This endpoint sends a WhatsApp message to a specified phone number using a connected WhatsApp account.

Authorizations
X-API-KEYstringRequired

Your API key, available from the dashboard

Body

Send a WhatsApp message to a recipient using a connected account.

accountIdstring | nullRequiredExample: 3b09d99c-0e30-48e0-a465-361db360e755
numberstring | nullRequiredExample: +1234567890
textstring | nullRequiredExample: How you doing
metadatastring[]OptionalExample: [{"user":"Your custom bot","and":"more"}]
Responses
201

Send WhatsApp Message resource created

Responseany
post
/api/send/whatsapp
POST /api/send/whatsapp HTTP/1.1
Host: app.inboxcomponents.com
X-API-KEY: YOUR_API_KEY
Content-Type: application/ld+json
Accept: */*
Content-Length: 151

{
  "accountId": "3b09d99c-0e30-48e0-a465-361db360e755",
  "number": "+1234567890",
  "text": "How you doing",
  "metadata": [
    {
      "user": "Your custom bot",
      "and": "more"
    }
  ]
}

No content

Last updated

Was this helpful?