> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Receive message from end user

> Text and multimedia messages the end user sends during an active conversation

## 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`

<Tabs>
  <Tab title="Text message">
    ```json theme={null}
    {
      "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"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Image message">
    ```json theme={null}
    {
      "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"
        }
      }
    }
    ```
  </Tab>
</Tabs>

## 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) |