Send Message

Send a message into an active session. The flow engine processes the message, advances to the next node, and delivers the response to the callback URL.

X-Api-Key

string

required

Your API key (prefixed with wh_).

sessionId

string

required

The UUID of the active session.

Body

type

string

required

Message type: text, interactive, image, video, audio, or document.

text

object

Text payload. Send when type is text.

Show Fields

text.body

string

required

The text content of the message.

media

object

Media payload. Send when type is image, video, audio, or document.

Show Fields

media.mimeType

string

required

File MIME type (e.g., image/png, video/mp4).

media.url

string

required

Public URL of the file.

media.caption

string

Media caption.

interactive

object

Interactive payload. Send when type is interactive.

Show Fields

interactive.type

string

required

Interaction type: button_reply or list_reply.

interactive.button_reply

object

Button reply.

Show Fields

interactive.button_reply.id

string

required

The button ID.

interactive.button_reply.title

string

required

The button label.

interactive.list_reply

object

List reply.

Show Fields

interactive.list_reply.id

string

required

The selected row ID.

interactive.list_reply.title

string

required

The selected row title.

Payload examples

{
  "type": "text",
  "text": {
    "body": "Hello, how can I help?"
  }
}

{
  "type": "image",
  "media": {
    "mimeType": "image/png",
    "url": "https://example.com/photo.png",
    "caption": "Product photo"
  }
}

{
  "type": "video",
  "media": {
    "mimeType": "video/mp4",
    "url": "https://example.com/video.mp4",
    "caption": "Tutorial video"
  }
}

{
  "type": "audio",
  "media": {
    "mimeType": "audio/ogg",
    "url": "https://example.com/audio.ogg",
    "caption": "Voice message"
  }
}

{
  "type": "document",
  "media": {
    "mimeType": "application/pdf",
    "url": "https://example.com/contract.pdf",
    "caption": "Contract"
  }
}

{
  "type": "interactive",
  "interactive": {
    "type": "button_reply",
    "button_reply": {
      "id": "btn_support",
      "title": "Support"
    }
  }
}

{
  "type": "interactive",
  "interactive": {
    "type": "list_reply",
    "list_reply": {
      "id": "row_pricing",
      "title": "Plans & Pricing"
    }
  }
}

curl -X POST https://api.whatabot.app/api/v1/sessions/{sessionId}/message \
  -H "X-Api-Key: wh_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"type": "text", "text": {"body": "Hello, how can I help?"}}'

{
  "messageId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "queued"
}

Overview

Sessions

Flows

Workspaces

Sectors

OAuth Clients

Iframe

Body

Payload examples

Overview

Sessions

Flows

Workspaces

Sectors

OAuth Clients

Iframe

​Body

​Payload examples

Body

Payload examples