Developer docs

IotaBot WhatsApp API

Send and receive WhatsApp messages from your code — on every number you connected.

Get an API key

Test the WhatsApp API without sending messages

Test keys run every check, store everything separately, and never send.

POST/v1/test/inboundSign in to try

Simulate a customer message

Produces the same webhooks, with livemode: false.

Request
curl -X POST "https://api.iotabot.com/v1/test/inbound" \
  -H "Authorization: Bearer $IOTABOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "channel": "whatsapp",
  "from": "+15550000001",
  "name": "Priya Sharma",
  "text": "Hi, where is my order?"
}'
Response · 201
{
  "data": {
    "livemode": false,
    "conversation": {
      "id": "6a4bc1…",
      "object": "conversation",
      "channel": "whatsapp",
      "status": "open",
      "mode": "ai"
    },
    "message": {
      "id": "6a4bc2…",
      "object": "message",
      "direction": "inbound",
      "text": "Hi, where is my order #1042?",
      "status": "received"
    }
  }
}
Errors
test_key_requiredchannel_not_allowedwebsite_not_allowed
Put simulate:failed in a message's text to get a failed delivery.