IotaBot logo
Developer docs

IotaBot Chat API

Your website chat, in your code: every message in, live replies out.

Get an API key

Live chat API documentation

The IotaBot chat widget on your site, driven by your own system.

  • Every visitor message and form on your webhook
  • Replies appear in the visitor's chat instantly
  • Take over from the AI, or hand back
  • Match visitors to your own users
  1. Install the IotaBot widget on your site.
  2. Create an API key and a webhook endpoint.
  3. Reply to a visitor:
POST/v1/messagesmessages:sendThe API key needs the messages:send permission. Without it the call is refused with 403 insufficient_scope.Sign in to try

Reply to a visitor

Request
curl -X POST "https://api.iotabot.com/v1/messages" \
  -H "Authorization: Bearer $IOTABOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "conversation_id": "6a4b9e21c3f1a2b3c4d5e6f7",
  "text": "I found your order — it ships today."
}' \
  -H "Idempotency-Key: order-1042-shipped"
Response · 202
{
  "data": {
    "id": "6a4ba0f1c3f1a2b3c4d5e733",
    "object": "message",
    "status": "queued",
    "channel": "website",
    "conversation_id": "6a4b9e21c3f1a2b3c4d5e6f7",
    "created_at": "2026-10-01T09:16:10.004Z"
  }
}
Errors
conversation_closedintegration_pausedfile_already_usedattachments_too_largeapi_quota_exceededidempotency_key_reusedidempotency_in_progress
Retries are safe with an Idempotency-Key header. Give each message its own key (e.g. order-1042-shipped) and reuse it when you retry — a request with a key already seen returns the first result instead of sending again. Kept 24 hours.
Live chat API overview →