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

# Text

> Send a WhatsApp text message

## Request

`type` must be `text`.

### Field types

* `to`: string (required)
* `type`: string = `text` (required)
* `text`: object (required)
* `text.body`: string (required)
* `text.preview_url`: boolean (optional)
* `tags`: array of strings (optional)
* `metadata`: object | string (optional)

### Field behavior and limits

* `text.body` is required.
* `text.body` maximum length: 4096 characters.
* URLs in `text.body` are automatically hyperlinked by WhatsApp clients.
* `text.preview_url` is optional:
  * `true`: attempts to render a link preview for URLs in `text.body`.
  * `false` or omitted: no link preview is requested.

```json theme={null}
{
  "to": "+573001112233",
  "type": "text",
  "text": {
    "body": "Hola, este es un mensaje de prueba",
    "preview_url": true
  }
}
```

## Response

Text sends are queued asynchronously.

```json theme={null}
{
  "data": {
    "messageId": "uuid",
    "status": "queued",
    "logId": "uuid"
  },
  "meta": {
    "timestamp": "2024-01-01T00:00:00.000Z"
  }
}
```
