Ricky logorickyDocs

Buscar mensajes

GET
/messages/search

Mensajes de todas las conversaciones que contienen las palabras, primero los más recientes. Responde una página de hasta limit; next_cursor siempre es null.

Permiso: conversations:read.

Autorización

bearerAuth
headerAuthorizationBearer <clave>

Una clave de API de la organización, rky_live_…, creada en Configuración → API. Envíala solo desde un servidor.

Parámetros de consulta

query*string

Palabras en el texto del mensaje, o texto en lo que Ricky obtuvo de una nota de voz o un archivo.

Longitud1 <= length <= 200
limit?integer

Cantidad máxima de resultados.

Rango1 <= value <= 30
Predeterminado10

Cuerpo de la respuesta

Éxito.

application/json
  1. response
data*array<>
next_cursor*|

Pásalo como cursor para la página siguiente; null en la última página.

curl -X GET 'https://getricky.ai/api/v1/messages/search?query=string'
{  "data": [    {      "message_id": "c41d7e2a-5b6f-4a89-8c3d-0e1f2a3b4c5d",      "conversation_id": "9b2e4c61-7a3f-4d18-b5c2-6e0f1a2b3c4d",      "direction": "inbound",      "type": "text",      "text": "¿Ya están mis lentes?",      "contact": {        "name": "Ana Pérez",        "external_id": "50760001234"      },      "agent_name": null,      "messaged_at": "2026-10-14T15:30:00.000Z"    }  ],  "next_cursor": "string"}