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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.