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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# API de Messages

> Un Message es una publicación en un channel. Contiene contenido en Markdown y puede incluir archivos adjuntos, una encuesta o una respuesta a otro mensaje.

Usa la API de Messages para [enviar](https://docs.whop.com/es/api-reference/messages/send-message.md), [editar](https://docs.whop.com/es/api-reference/messages/update-message.md), [eliminar](https://docs.whop.com/es/api-reference/messages/delete-message.md) y [fijar](https://docs.whop.com/es/api-reference/messages/pin-message.md) mensajes. [Lista los mensajes de un channel](https://docs.whop.com/es/api-reference/messages/list-messages.md) para leer su historial y sincronizar ediciones y eliminaciones. También puedes [reaccionar](https://docs.whop.com/es/api-reference/messages/react-to-message.md) con un emoji, [listar quién reaccionó](https://docs.whop.com/es/api-reference/messages/list-message-reactions.md) y [votar](https://docs.whop.com/es/api-reference/messages/vote-on-message.md) una vez en una encuesta. Cada mensaje muestra sus recuentos de reacciones y votos y si tú reaccionaste o votaste, pero no quién más votó.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar mensajes](https://docs.whop.com/es/api-reference/messages/list-messages.md) | GET `/messages` |
| [Recuperar mensaje](https://docs.whop.com/es/api-reference/messages/retrieve-message.md) | GET `/messages/{id}` |
| [Listar reacciones de un mensaje](https://docs.whop.com/es/api-reference/messages/list-message-reactions.md) | GET `/messages/{id}/reactions` |
| [Enviar mensaje](https://docs.whop.com/es/api-reference/messages/send-message.md) | POST `/messages` |
| [Fijar mensaje](https://docs.whop.com/es/api-reference/messages/pin-message.md) | POST `/messages/{id}/pin` |
| [Reaccionar a un mensaje](https://docs.whop.com/es/api-reference/messages/react-to-message.md) | POST `/messages/{id}/react` |
| [Desfijar mensaje](https://docs.whop.com/es/api-reference/messages/unpin-message.md) | POST `/messages/{id}/unpin` |
| [Quitar reacción de un mensaje](https://docs.whop.com/es/api-reference/messages/remove-reaction-from-message.md) | POST `/messages/{id}/unreact` |
| [Votar en un mensaje](https://docs.whop.com/es/api-reference/messages/vote-on-message.md) | POST `/messages/{id}/vote` |
| [Actualizar mensaje](https://docs.whop.com/es/api-reference/messages/update-message.md) | PATCH `/messages/{id}` |
| [Eliminar mensaje](https://docs.whop.com/es/api-reference/messages/delete-message.md) | DELETE `/messages/{id}` |

## Atributos

**id** `string` *required*

ID del mensaje, con el prefijo `post_`. Coincide con el `id` enviado al crearlo, cuando se envió uno.

**attachments** `object[]` *required*

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El ID del archivo, con el prefijo `file_`.
>
> **blurhash** `string | null` *required*
>
> Marcador de posición BlurHash para una imagen o un video. Null cuando no está disponible o fue eliminado por moderación.
>
> **content\_type** `string | null` *required*
>
> El tipo MIME del archivo original, por ejemplo `application/pdf`. Se conserva cuando la moderación elimina el archivo.
>
> **created\_at** `string` *required*
>
> Cuándo se creó el archivo, como marca de tiempo ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Duración del audio o video en segundos. Null cuando no está disponible o fue eliminado por moderación.
>
> **filename** `string | null` *required*
>
> El nombre de archivo original, incluida su extensión.
>
> **height** `integer | null` *required*
>
> Alto de la imagen o el video en píxeles. Null cuando no está disponible o fue eliminado por moderación.
>
> **multipart\_chunk\_size** `integer | null`
>
> El tamaño en bytes que debe tener cada parte (excepto la última). Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_id** `string | null`
>
> El ID de la carga multiparte, que se devuelve a `complete`. Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_urls** `object[] | null`
>
> La URL prefirmada de cada parte. Solo está presente al crear, y solo para cargas multiparte.
>
> > [accordion] Propiedades
> >
> > **part\_number** `integer` *required*
> >
> > El índice, empezando en 1, de esta parte dentro de la carga multiparte.
> >
> > **url** `string` *required*
> >
> > La URL prefirmada a la que enviar con PUT los bytes de esta parte.
>
> **object** `string` *required*
>
> El tipo de este objeto, siempre `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Si la moderación eliminó el archivo. Cuando es `true`, `url` sirve una imagen de reemplazo. `filename`, `size` y `content_type` siguen describiendo el archivo original.
>
> **size** `integer | null` *required*
>
> El tamaño del archivo en bytes. `null` hasta que termina la carga.
>
> **upload\_headers** `object`
>
> Encabezados que se envían con el PUT de la carga. Solo está presente al crear.
>
> **upload\_status** `string` *required*
>
> En qué punto del ciclo de vida de la carga se encuentra el archivo.
>
> Opciones disponibles: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL prefirmada a la que enviar con PUT los bytes del archivo. Solo está presente al crear, y solo para cargas de una sola parte.
>
> **url** `string | null` *required*
>
> Una URL para descargar el archivo. Los archivos públicos reciben una URL de CDN permanente y los privados una URL firmada que caduca. `null` hasta que termina la carga. Cuando la moderación elimina el archivo, una URL de imagen de reemplazo.
>
> **visibility** `string` *required*
>
> Los archivos `public` se sirven desde una URL de CDN sin firmar. Los archivos `private` se sirven desde una URL firmada que caduca.
>
> Opciones disponibles: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forma de onda del audio. Null cuando no está disponible o fue eliminada por moderación.
>
> **width** `integer | null` *required*
>
> Ancho de la imagen o el video en píxeles. Null cuando no está disponible o fue eliminado por moderación.

**author** `object | null` *required*

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del usuario, con el prefijo `user_`.
>
> **name** `string | null` *required*
>
> Nombre visible.
>
> **profile\_picture** `object` *required*
>
> Contenedor del avatar. Su `url` siempre está presente y es un marcador de posición generado cuando el usuario no estableció ninguna imagen.
>
> > [accordion] Propiedades
> >
> > **url** `string` *required*
> >
> > URL de la imagen del avatar. Siempre presente. Es un marcador de posición generado cuando el usuario no estableció ninguna imagen.
>
> **username** `string` *required*
>
> Nombre de usuario público.

**author\_is\_team\_member** `boolean` *required*

`true` si el autor es miembro del equipo de la cuenta propietaria de este channel de comunidad. `false` para partners, channels privados y de soporte, y mensajes eliminados.

**author\_user\_id** `string | null` *required*

**channel\_id** `string` *required*

**content** `string | null` *required*

Contenido en Markdown. `null` para un mensaje eliminado.

**created\_at** `string` *required*

Hora de creación como marca de tiempo ISO 8601.

**custom\_author** `object | null` *required*

> [accordion] Propiedades
>
> **display\_name** `string | null` *required*
>
> Nombre visible del webhook, o null para usar el nombre del usuario.
>
> **profile\_picture** `object | null` *required*
>
> Imagen de perfil del webhook, o null para usar la imagen del usuario.
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > El ID del archivo, con el prefijo `file_`.
> >
> > **blurhash** `string | null` *required*
> >
> > Marcador de posición BlurHash para una imagen o un video. Null cuando no está disponible o fue eliminado por moderación.
> >
> > **content\_type** `string | null` *required*
> >
> > El tipo MIME del archivo original, por ejemplo `application/pdf`. Se conserva cuando la moderación elimina el archivo.
> >
> > **created\_at** `string` *required*
> >
> > Cuándo se creó el archivo, como marca de tiempo ISO 8601.
> >
> > **duration\_seconds** `number | null` *required*
> >
> > Duración del audio o video en segundos. Null cuando no está disponible o fue eliminado por moderación.
> >
> > **filename** `string | null` *required*
> >
> > El nombre de archivo original, incluida su extensión.
> >
> > **height** `integer | null` *required*
> >
> > Alto de la imagen o el video en píxeles. Null cuando no está disponible o fue eliminado por moderación.
> >
> > **multipart\_chunk\_size** `integer | null`
> >
> > El tamaño en bytes que debe tener cada parte (excepto la última). Solo está presente al crear, y solo para cargas multiparte.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > El ID de la carga multiparte, que se devuelve a `complete`. Solo está presente al crear, y solo para cargas multiparte.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > La URL prefirmada de cada parte. Solo está presente al crear, y solo para cargas multiparte.
> >
> > > [accordion] Propiedades
> > >
> > > **part\_number** `integer` *required*
> > >
> > > El índice, empezando en 1, de esta parte dentro de la carga multiparte.
> > >
> > > **url** `string` *required*
> > >
> > > La URL prefirmada a la que enviar con PUT los bytes de esta parte.
> >
> > **object** `string` *required*
> >
> > El tipo de este objeto, siempre `file`.
> >
> > **removed\_by\_moderation** `boolean` *required*
> >
> > Si la moderación eliminó el archivo. Cuando es `true`, `url` sirve una imagen de reemplazo. `filename`, `size` y `content_type` siguen describiendo el archivo original.
> >
> > **size** `integer | null` *required*
> >
> > El tamaño del archivo en bytes. `null` hasta que termina la carga.
> >
> > **upload\_headers** `object`
> >
> > Encabezados que se envían con el PUT de la carga. Solo está presente al crear.
> >
> > **upload\_status** `string` *required*
> >
> > En qué punto del ciclo de vida de la carga se encuentra el archivo.
> >
> > Opciones disponibles: `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > URL prefirmada a la que enviar con PUT los bytes del archivo. Solo está presente al crear, y solo para cargas de una sola parte.
> >
> > **url** `string | null` *required*
> >
> > Una URL para descargar el archivo. Los archivos públicos reciben una URL de CDN permanente y los privados una URL firmada que caduca. `null` hasta que termina la carga. Cuando la moderación elimina el archivo, una URL de imagen de reemplazo.
> >
> > **visibility** `string` *required*
> >
> > Los archivos `public` se sirven desde una URL de CDN sin firmar. Los archivos `private` se sirven desde una URL firmada que caduca.
> >
> > Opciones disponibles: `public`, `private`
> >
> > **waveform\_url** `string | null` *required*
> >
> > URL de la forma de onda del audio. Null cuando no está disponible o fue eliminada por moderación.
> >
> > **width** `integer | null` *required*
> >
> > Ancho de la imagen o el video en píxeles. Null cuando no está disponible o fue eliminado por moderación.

**deleted\_at** `string | null` *required*

Hora de eliminación, o null para un mensaje activo.

**edited** `boolean` *required*

**embeds** `object[]` *required*

> [accordion] Propiedades
>
> **color** `integer | null` *required*
>
> **description** `string | null` *required*
>
> **fields** `object[]` *required*
>
> > [accordion] Propiedades
> >
> > **inline** `boolean` *required*
> >
> > **name** `string` *required*
> >
> > **value** `string` *required*
>
> **footer** `object | null` *required*
>
> Pie que se muestra en la parte inferior del embed. Null cuando el embed no tiene pie.
>
> > [accordion] Propiedades
> >
> > **icon** `object | null` *required*
> >
> > Imagen pequeña que se muestra junto al texto del pie. Null cuando el pie no tiene icono.
> >
> > > [accordion] Propiedades
> > >
> > > **blurhash** `string | null` *required*
> > >
> > > **height** `integer | null` *required*
> > >
> > > **url** `string` *required*
> > >
> > > **width** `integer | null` *required*
> >
> > **text** `string` *required*
>
> **image** `object | null` *required*
>
> > [accordion] Propiedades
> >
> > **blurhash** `string | null` *required*
> >
> > **height** `integer | null` *required*
> >
> > **url** `string` *required*
> >
> > **width** `integer | null` *required*
>
> **thumbnail** `object | null` *required*
>
> > [accordion] Propiedades
> >
> > **blurhash** `string | null` *required*
> >
> > **height** `integer | null` *required*
> >
> > **url** `string` *required*
> >
> > **width** `integer | null` *required*
>
> **timestamp\_at** `string | null` *required*
>
> Hora proporcionada por el autor del embed, como marca de tiempo ISO 8601 en UTC. Null cuando falta o no es válida.
>
> **title** `string | null` *required*
>
> **url** `string | null` *required*

**gifs** `object[]` *required*

GIFs adjuntos al mensaje. Vacío para un mensaje eliminado.

> [accordion] Propiedades
>
> **height** `integer` *required*
>
> Alto de `original_url`, en píxeles.
>
> **original\_url** `string` *required*
>
> GIF a tamaño completo. HTTPS en un host de medios de Klipy.
>
> **preview\_url** `string` *required*
>
> Versión más pequeña para vistas previas y marcadores de posición. HTTPS en un host de medios de Klipy.
>
> **slug** `string` *required*
>
> Identificador del GIF.
>
> **title** `string` *required*
>
> Título del GIF.
>
> **url** `string` *required*
>
> URL desde la que el mensaje renderiza el GIF. HTTPS en un host de medios de Klipy.
>
> **width** `integer` *required*
>
> Ancho de `original_url`, en píxeles.

**link\_previews** `object[]` *required*

> [accordion] Propiedades
>
> **description** `string | null` *required*
>
> Descripción de la página, o null mientras no está disponible.
>
> **favicon\_url** `string | null` *required*
>
> URL del icono del sitio, o null cuando no está disponible.
>
> **footer** `object | null` *required*
>
> Información adicional de la vista previa, o null cuando no está disponible.
>
> > [accordion] Propiedades
> >
> > **description** `string | null` *required*
> >
> > **icon\_url** `string` *required*
> >
> > **title** `string` *required*
>
> **image\_url** `string | null` *required*
>
> URL de la imagen de vista previa, o null cuando no está disponible.
>
> **processing** `boolean` *required*
>
> Si el servidor todavía está generando esta vista previa.
>
> **title** `string | null` *required*
>
> Título de la página, o null mientras no está disponible.
>
> **url** `string` *required*
>
> URL de la que se muestra la vista previa.

**mentioned\_user\_ids** `string[]` *required*

**message\_type** `string` *required*

Opciones disponibles: `regular`, `system`, `automated`

**pinned** `boolean` *required*

**plain\_content** `string | null` *required*

Texto del mensaje sin formato. null cuando no hay texto o el mensaje está eliminado

**poll** `object | null` *required*

> [accordion] Propiedades
>
> **options** `object[]` *required*
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > Identificador de la opción dentro de la encuesta.
> >
> > **text** `string` *required*
> >
> > **vote\_count** `integer` *required*
> >
> > **voted** `boolean` *required*
> >
> > Si votaste por esta opción.

**reaction\_counts** `object[]` *required*

> [accordion] Propiedades
>
> **kind** `string` *required*
>
> Opciones disponibles: `like`, `view`, `emoji`
>
> **reacted** `boolean` *required*
>
> Si reaccionaste con este valor.
>
> **total\_score** `integer` *required*
>
> **user\_count** `integer` *required*
>
> **value** `string | null` *required*
>
> El emoji Unicode de una reacción con emoji. Para otros tipos de reacción, el valor de la reacción.

**replying\_to\_message** `object | null`

El mensaje al que se responde. Se omite salvo que se use `include_replying_to_message=true`. Incluye todos los campos del mensaje excepto `replying_to_message`. `null` cuando este mensaje está eliminado o no existe un destino en el mismo channel.

**replying\_to\_message\_id** `string | null` *required*

**replying\_to\_user\_id** `string | null` *required*

ID de usuario del autor del mensaje al que se responde, con el prefijo `user_`. `null` sin una respuesta en este channel, o cuando alguno de los mensajes está eliminado.

**updated\_at** `string` *required*

Último cambio del mensaje como marca de tiempo ISO 8601.

**view\_count** `integer | null` *required*

Recuento de vistas de la experiencia. `null` para channels basados en DM.

```json ChatMessage theme={null}
{
	"id": "post_xxxxxxxxxxxxxxxxxxxxxx",
	"channel_id": "feed_xxxxxxxxxxxxxxxxxxxxxx",
	"author_user_id": "user_yyyyyyyyyyyyyy",
	"author": {
		"id": "user_yyyyyyyyyyyyyy",
		"username": "marcusreed",
		"name": "Marcus Reed",
		"profile_picture": {
			"url": "https://img.whop.com/avatars/user_yyyyyyyyyyyyyy.png"
		}
	},
	"author_is_team_member": true,
	"custom_author": null,
	"content": "Which coating should we test on the demo car this Saturday? **Vote below.** Booking page: https://shinetime.example/book",
	"plain_content": "Which coating should we test on the demo car this Saturday? Vote below. Booking page: https://shinetime.example/book",
	"message_type": "regular",
	"edited": false,
	"pinned": true,
	"replying_to_message_id": null,
	"replying_to_user_id": null,
	"attachments": [
		{
			"id": "file_yyyyyyyyyyyyyy",
			"object": "file",
			"filename": "demo-car.jpg",
			"content_type": "image/jpeg",
			"size": 284190,
			"url": "https://img.whop.com/uploads/demo-car.jpg",
			"removed_by_moderation": false,
			"upload_status": "ready",
			"visibility": "public",
			"created_at": "2026-09-02T16:20:11.000Z",
			"width": 1600,
			"height": 1067,
			"blurhash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
			"duration_seconds": null,
			"waveform_url": null
		}
	],
	"poll": {
		"options": [
			{
				"id": "1",
				"text": "Graphene",
				"vote_count": 14,
				"voted": true
			},
			{
				"id": "2",
				"text": "Ceramic",
				"vote_count": 9,
				"voted": false
			}
		]
	},
	"mentioned_user_ids": [],
	"link_previews": [
		{
			"url": "https://shinetime.example/book",
			"title": "Book a detail | Shine Time",
			"description": "Pick a bay and a time for your next detail.",
			"image_url": "https://shinetime.example/og.png",
			"favicon_url": "https://shinetime.example/favicon.ico",
			"processing": false,
			"footer": {
				"title": "shinetime.example",
				"description": null,
				"icon_url": "https://shinetime.example/favicon.ico"
			}
		}
	],
	"gifs": [
		{
			"slug": "car-wash-shine-xxxxxxxx",
			"title": "Car Wash Shine",
			"url": "https://media.giphy.com/media/xxxxxxxx/giphy.gif",
			"original_url": "https://media.giphy.com/media/xxxxxxxx/giphy.gif",
			"preview_url": "https://media.giphy.com/media/xxxxxxxx/200w.gif",
			"width": 480,
			"height": 270
		}
	],
	"embeds": [
		{
			"color": 3447003,
			"title": "Saturday demo day",
			"url": "https://shinetime.example/demo",
			"description": "Live coating demo at Bay 2, 10:00 AM.",
			"timestamp_at": "2026-10-18T15:00:00.000Z",
			"thumbnail": {
				"url": "https://img.whop.com/uploads/demo-car-thumb.jpg",
				"width": 320,
				"height": 213,
				"blurhash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj"
			},
			"image": null,
			"footer": {
				"text": "Shine Time Auto Detailing",
				"icon": null
			},
			"fields": [
				{
					"name": "Location",
					"value": "Bay 2",
					"inline": true
				},
				{
					"name": "Time",
					"value": "10:00 AM",
					"inline": true
				}
			]
		}
	],
	"reaction_counts": [
		{
			"kind": "emoji",
			"value": "🔥",
			"user_count": 6,
			"total_score": 6,
			"reacted": false
		}
	],
	"view_count": 182,
	"created_at": "2026-10-14T09:12:40.000Z",
	"updated_at": "2026-10-14T09:12:40.000Z",
	"deleted_at": null
}
```
