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., [phone]) 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

ApiKeyAuth

X-API-KEYstringRequired

Your API key, available from the dashboard

Body

application/ld+jsonapplication/json

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

accountIdstring | nullRequiredExample: 3b09d99c-0e30-48e0-a465-361db360e755

numberstring | nullRequiredExample: [phone]

textstring | nullRequiredExample: How you doing

metadatastring[]OptionalExample: [{"user":"Your custom bot","and":"more"}]

Responses

201

Send WhatsApp Message resource created

application/ld+jsonapplication/json

400

Invalid input

application/ld+jsonapplication/problem+jsonapplication/json

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

422

An error occurred

application/ld+jsonapplication/problem+jsonapplication/json

post

/api/send/whatsapp

HTTPcURLJavaScriptPython

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": "[phone]",
  "text": "How you doing",
  "metadata": [
    {
      "user": "Your custom bot",
      "and": "more"
    }
  ]
}

application/ld+jsonapplication/json

No content