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

# Introduction

> Learn how to send messages through the Jelou API

## Welcome

The Jelou API allows you to send messages to users through WhatsApp. This API supports multiple message types including text, images, audio, video, files, stickers, location, contacts, and interactive elements such as buttons and quick replies.

## Base Endpoint

All messages are sent through the following endpoint:

```
POST https://api.jelou.ai/v1/bots/{botId}/messages
```

## Session Requirements

This API can only send messages when an active session exists: you have 24 hours from the user's last message to respond with any type of message.

## Common Fields

All message types share these fields:

| Field      | Location | Type   | Required | Description                                                          |
| ---------- | -------- | ------ | -------- | -------------------------------------------------------------------- |
| **botId**  | Path     | string | Yes      | Unique identifier of the bot sending the message.                    |
| **type**   | Body     | string | Yes      | Type of message to send. See available types on the following pages. |
| **userId** | Body     | string | Yes      | Unique identifier of the user who will receive the message.          |

## Available Message Types

The Jelou API supports the following message types:

<CardGroup cols={2}>
  <Card title="Text Message" icon="message" href="/api/envia-mensajes/texto">
    Simple text messages and messages with interactive buttons
  </Card>

  <Card title="Message with Options" icon="list" href="/api/envia-mensajes/texto-con-opciones">
    Text with multiple-selection buttons
  </Card>

  <Card title="Quick Replies" icon="bolt" href="/api/envia-mensajes/respuestas-rapidas">
    Messages with quick reply buttons
  </Card>

  <Card title="Image Message" icon="image" href="/api/envia-mensajes/imagen">
    Send images with optional text
  </Card>

  <Card title="Audio Message" icon="volume" href="/api/envia-mensajes/audio">
    Send audio files
  </Card>

  <Card title="Video Message" icon="video" href="/api/envia-mensajes/video">
    Send videos with optional text
  </Card>

  <Card title="File Message" icon="file" href="/api/envia-mensajes/archivo">
    Send documents and files
  </Card>

  <Card title="Sticker Message" icon="smile" href="/api/envia-mensajes/sticker">
    Send stickers in WebP format
  </Card>

  <Card title="Location Message" icon="map-pin" href="/api/envia-mensajes/ubicacion">
    Share specific coordinates
  </Card>

  <Card title="Contact Message" icon="user" href="/api/envia-mensajes/contacto">
    Share contact cards (vCard)
  </Card>

  <Card title="Location Request" icon="location" href="/api/envia-mensajes/solicitud-ubicacion">
    Request the user's location
  </Card>

  <Card title="URL Button" icon="link" href="/api/envia-mensajes/boton-url">
    Button that opens a URL
  </Card>

  <Card title="Flow Button" icon="workflow" href="/api/envia-mensajes/boton-flujo">
    Button that opens a WhatsApp Flow
  </Card>

  <Card title="Call Button" icon="phone" href="/api/envia-mensajes/boton-llamada">
    Button that initiates a voice call
  </Card>
</CardGroup>

## Next Steps

Explore the different message types available on the following pages. Each page includes complete request examples and detailed parameter documentation.