Historial de Mensajes

curl -X GET "https://api.whaapy.com/conversations/v1/uuid/messages?limit=20" \
  -H "Authorization: Bearer wha_xxxxx"

const conversationId = 'uuid';
const response = await fetch(
  `https://api.whaapy.com/conversations/v1/${conversationId}/messages?limit=20`,
  {
    headers: { 'Authorization': 'Bearer wha_xxxxx' }
  }
);
const data = await response.json();

import requests

conversation_id = 'uuid'
response = requests.get(
    f'https://api.whaapy.com/conversations/v1/{conversation_id}/messages',
    params={'limit': 20},
    headers={'Authorization': 'Bearer wha_xxxxx'}
)
data = response.json()

$conversationId = 'uuid';
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whaapy.com/conversations/v1/{$conversationId}/messages?limit=20",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer wha_xxxxx"
  ],
]);

$response = curl_exec($curl);
$data = json_decode($response, true);

{
  "data": [
    {
      "id": "msg-uuid-1",
      "conversationId": "conv-uuid",
      "content": "Hola, ¿tienen disponibilidad para mañana?",
      "messageType": "text",
      "direction": "inbound",
      "status": "read",
      "sentByAi": false,
      "timestamp": "2026-01-29T10:30:00Z",
      "createdAt": "2026-01-29T10:30:00Z"
    },
    {
      "id": "msg-uuid-2",
      "conversationId": "conv-uuid",
      "content": "¡Hola! Sí, tenemos disponibilidad. ¿A qué hora te gustaría?",
      "messageType": "text",
      "direction": "outbound",
      "status": "delivered",
      "sentByAi": true,
      "timestamp": "2026-01-29T10:30:15Z",
      "createdAt": "2026-01-29T10:30:15Z"
    },
    {
      "id": "msg-uuid-3",
      "conversationId": "conv-uuid",
      "content": null,
      "messageType": "image",
      "direction": "inbound",
      "status": "read",
      "sentByAi": false,
      "mediaUrl": "https://api.whaapy.com/messages/msg-uuid-3/media?token=xxx",
      "mediaMimeType": "image/jpeg",
      "timestamp": "2026-01-29T10:31:00Z",
      "createdAt": "2026-01-29T10:31:00Z"
    }
  ],
  "meta": {
    "hasMore": true,
    "oldestMessageId": "msg-uuid-1"
  }
}

GET

conversations

{id}

messages

curl -X GET "https://api.whaapy.com/conversations/v1/uuid/messages?limit=20" \
  -H "Authorization: Bearer wha_xxxxx"

const conversationId = 'uuid';
const response = await fetch(
  `https://api.whaapy.com/conversations/v1/${conversationId}/messages?limit=20`,
  {
    headers: { 'Authorization': 'Bearer wha_xxxxx' }
  }
);
const data = await response.json();

import requests

conversation_id = 'uuid'
response = requests.get(
    f'https://api.whaapy.com/conversations/v1/{conversation_id}/messages',
    params={'limit': 20},
    headers={'Authorization': 'Bearer wha_xxxxx'}
)
data = response.json()

$conversationId = 'uuid';
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whaapy.com/conversations/v1/{$conversationId}/messages?limit=20",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer wha_xxxxx"
  ],
]);

$response = curl_exec($curl);
$data = json_decode($response, true);

{
  "data": [
    {
      "id": "msg-uuid-1",
      "conversationId": "conv-uuid",
      "content": "Hola, ¿tienen disponibilidad para mañana?",
      "messageType": "text",
      "direction": "inbound",
      "status": "read",
      "sentByAi": false,
      "timestamp": "2026-01-29T10:30:00Z",
      "createdAt": "2026-01-29T10:30:00Z"
    },
    {
      "id": "msg-uuid-2",
      "conversationId": "conv-uuid",
      "content": "¡Hola! Sí, tenemos disponibilidad. ¿A qué hora te gustaría?",
      "messageType": "text",
      "direction": "outbound",
      "status": "delivered",
      "sentByAi": true,
      "timestamp": "2026-01-29T10:30:15Z",
      "createdAt": "2026-01-29T10:30:15Z"
    },
    {
      "id": "msg-uuid-3",
      "conversationId": "conv-uuid",
      "content": null,
      "messageType": "image",
      "direction": "inbound",
      "status": "read",
      "sentByAi": false,
      "mediaUrl": "https://api.whaapy.com/messages/msg-uuid-3/media?token=xxx",
      "mediaMimeType": "image/jpeg",
      "timestamp": "2026-01-29T10:31:00Z",
      "createdAt": "2026-01-29T10:31:00Z"
    }
  ],
  "meta": {
    "hasMore": true,
    "oldestMessageId": "msg-uuid-1"
  }
}

Parámetros

string

required

UUID de la conversación

number

default:"50"

Número de mensajes (máximo 100)

string

Cursor para paginación (ID del mensaje más antiguo)

curl -X GET "https://api.whaapy.com/conversations/v1/uuid/messages?limit=20" \
  -H "Authorization: Bearer wha_xxxxx"

const conversationId = 'uuid';
const response = await fetch(
  `https://api.whaapy.com/conversations/v1/${conversationId}/messages?limit=20`,
  {
    headers: { 'Authorization': 'Bearer wha_xxxxx' }
  }
);
const data = await response.json();

import requests

conversation_id = 'uuid'
response = requests.get(
    f'https://api.whaapy.com/conversations/v1/{conversation_id}/messages',
    params={'limit': 20},
    headers={'Authorization': 'Bearer wha_xxxxx'}
)
data = response.json()

$conversationId = 'uuid';
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whaapy.com/conversations/v1/{$conversationId}/messages?limit=20",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer wha_xxxxx"
  ],
]);

$response = curl_exec($curl);
$data = json_decode($response, true);

{
  "data": [
    {
      "id": "msg-uuid-1",
      "conversationId": "conv-uuid",
      "content": "Hola, ¿tienen disponibilidad para mañana?",
      "messageType": "text",
      "direction": "inbound",
      "status": "read",
      "sentByAi": false,
      "timestamp": "2026-01-29T10:30:00Z",
      "createdAt": "2026-01-29T10:30:00Z"
    },
    {
      "id": "msg-uuid-2",
      "conversationId": "conv-uuid",
      "content": "¡Hola! Sí, tenemos disponibilidad. ¿A qué hora te gustaría?",
      "messageType": "text",
      "direction": "outbound",
      "status": "delivered",
      "sentByAi": true,
      "timestamp": "2026-01-29T10:30:15Z",
      "createdAt": "2026-01-29T10:30:15Z"
    },
    {
      "id": "msg-uuid-3",
      "conversationId": "conv-uuid",
      "content": null,
      "messageType": "image",
      "direction": "inbound",
      "status": "read",
      "sentByAi": false,
      "mediaUrl": "https://api.whaapy.com/messages/msg-uuid-3/media?token=xxx",
      "mediaMimeType": "image/jpeg",
      "timestamp": "2026-01-29T10:31:00Z",
      "createdAt": "2026-01-29T10:31:00Z"
    }
  ],
  "meta": {
    "hasMore": true,
    "oldestMessageId": "msg-uuid-1"
  }
}

Campos del mensaje

Campo	Tipo	Descripción
`id`	string	UUID del mensaje
`conversationId`	string	UUID de la conversación
`content`	string	Contenido del mensaje (null para media)
`messageType`	string	Tipo de mensaje (ver tabla abajo)
`direction`	string	`inbound` (recibido) o `outbound` (enviado)
`status`	string	`sent`, `delivered`, `read`, `failed`
`sentByAi`	boolean	Si fue enviado por la IA
`mediaUrl`	string	URL del archivo (si es media)
`mediaMimeType`	string	MIME type del archivo
`timestamp`	string	Fecha y hora del mensaje
`createdAt`	string	Fecha de creación en BD

Tipos de mensaje

Tipo	Descripción
`text`	Mensaje de texto simple
`image`	Imagen (jpeg, png, webp)
`video`	Video (mp4)
`audio`	Audio o nota de voz (ogg, mp3)
`document`	Documento (pdf, doc, etc.)
`sticker`	Sticker de WhatsApp
`template`	Mensaje de template
`interactive`	Mensaje interactivo (botones, listas)
`location`	Ubicación
`contacts`	Tarjeta de contacto
`reaction`	Reacción a mensaje

Paginación

Los mensajes se ordenan del más reciente al más antiguo. Para obtener mensajes más antiguos, usa el parámetro before con el id del mensaje más antiguo de la página actual.

// Primera página
const page1 = await fetch(
  `https://api.whaapy.com/conversations/v1/${id}/messages?limit=20`,
  { headers: { 'Authorization': 'Bearer wha_xxxxx' } }
).then(r => r.json());

// Segunda página (mensajes más antiguos)
if (page1.meta.hasMore) {
  const oldestId = page1.meta.oldestMessageId;
  const page2 = await fetch(
    `https://api.whaapy.com/conversations/v1/${id}/messages?limit=20&before=${oldestId}`,
    { headers: { 'Authorization': 'Bearer wha_xxxxx' } }
  ).then(r => r.json());
}

Los mensajes se ordenan del más reciente al más antiguo. Usa before para paginar hacia atrás en el historial.

Acceder a media

Las URLs de media (mediaUrl) son temporales y requieren el token incluido. Para acceder a la media:

// La URL ya incluye el token
const mediaUrl = message.mediaUrl;
const mediaResponse = await fetch(mediaUrl);
const blob = await mediaResponse.blob();

Las URLs de media expiran después de 5 minutos. Si necesitas acceso persistente, descarga el archivo y almacénalo en tu propio servidor.

General

Mensajes

Media

Conversaciones

Contactos

Funnels

Templates

Agente IA

Equipo

Webhooks

Historial de Mensajes

Parámetros

Campos del mensaje

Tipos de mensaje

Paginación

Acceder a media

​Parámetros

​Campos del mensaje

​Tipos de mensaje

​Paginación

​Acceder a media

Parámetros

Campos del mensaje

Tipos de mensaje

Paginación

Acceder a media