Receive message from end user - Jelou AI Docs

Description

Jelou emits this event to your webhook when the end user sends a message during an active conversation. All events include the X-Jelou-Signature header for verification.

Webhook event `message`

Text message
Image message

{
  "field": "messages",
  "object": "message_event",
  "event_type": "message",
  "timestamp": 1776134278574,
  "project_id": "PROJECT_ID",
  "room_id": "ROOM_ID",
  "contact": {
    "id": "USER_ID",
    "name": "USER_NAME"
  },
  "conversation": {
    "id": "CONVERSATION_ID"
  },
  "bot": {
    "id": "BOT_ID",
    "name": "BOT_NAME"
  },
  "value": {
    "id": "MESSAGE_ID",
    "type": "text",
    "content": {
      "body": "Hello"
    }
  }
}

{
  "field": "messages",
  "object": "message_event",
  "event_type": "message",
  "timestamp": 1776134352163,
  "project_id": "PROJECT_ID",
  "room_id": "ROOM_ID",
  "contact": {
    "id": "USER_ID",
    "name": "USER_NAME"
  },
  "conversation": {
    "id": "CONVERSATION_ID"
  },
  "bot": {
    "id": "BOT_ID",
    "name": "BOT_NAME"
  },
  "value": {
    "id": "MESSAGE_ID",
    "type": "image",
    "content": {
      "url": "https://storage.example.com/media/image.jpg",
      "mime_type": "image/jpeg"
    }
  }
}

Supported message types

Type	`value.content` field	Additional fields
`text`	`{ "body": "Message text" }`	—
`image`	`{ "url": "...", "mime_type": "image/jpeg" }`	`caption` (optional)
`video`	`{ "url": "...", "mime_type": "video/mp4" }`	`caption` (optional)
`audio`	`{ "url": "...", "mime_type": "audio/mpeg" }`	—
`document`	`{ "url": "...", "mime_type": "application/pdf" }`	`filename` (optional)