Buscar mensajes

Busca una palabra o frase en los mensajes. Tiene dos modos:

En todo el workspace (por defecto): devuelve los contactos que tienen un mensaje con ese texto, con el mejor resultado de cada uno.
En un contacto (-c): devuelve los mensajes de esa conversación que contienen el texto.

bash

01plazbot messages search <texto> [opciones]

Parámetros

Parámetro	Flag	Requerido	Descripción
Texto	`<text>`	Sí	Palabra o frase a buscar. Si tiene espacios, va entre comillas
Contacto	`-c, --contact <contactId>`	No	Busca solo en la conversación de ese contacto
Límite	`--limit <n>`	No	Máximo de resultados en la búsqueda del workspace. Por defecto `50`
JSON	`--json`	No	Imprime `{ data, nextCursor }` en JSON
Workspace	`-w, --workspace <id>`	No	Otro de tus workspaces
Zona	`-z, --zone <zone>`	No	`LA` o `EU`

Ejemplos

bash

01# Contactos que mencionaron "reembolso"
02plazbot messages search reembolso
03 
04# Buscar dentro de una conversación
05plazbot messages search "pedido 1234" -c con_AbcDef123
06 
07# IDs de los contactos que mencionaron una palabra
08plazbot messages search cancelar --json | jq -r '.data[].contactId'

Resultado

En todo el workspace:

text

01  Contacts with matching messages (2)
02  ────────────────────────────────────────
03┌───────────────┬─────────────┬──────────────────┬──────────────────────────────────┐
04│ Contact       │ Name        │ Date (UTC)       │ Message                          │
05├───────────────┼─────────────┼──────────────────┼──────────────────────────────────┤
06│ con_AbcDef123 │ Ana Torres  │ 2026-10-06 17:32 │ Quiero pedir un reembolso        │
07├───────────────┼─────────────┼──────────────────┼──────────────────────────────────┤
08│ con_GhiJkl456 │ Carlos Ruiz │ 2026-10-06 15:43 │ ¿Cuánto tarda el reembolso?      │
09└───────────────┴─────────────┴──────────────────┴──────────────────────────────────┘

Con -c, la tabla tiene las mismas columnas que plazbot messages list.

Salida JSON

En todo el workspace, un elemento por contacto:

json

01{
02  "data": [
03    {
04      "contactId": "con_AbcDef123",
05      "contactName": "Ana Torres",
06      "phone": "51912345678",
07      "messageId": "mes_AbcDef123",
08      "snippet": "Quiero pedir un reembolso",
09      "creationDate": "2026-10-06T17:32:08.404Z"
10    }
11  ],
12  "nextCursor": null
13}

Con -c, cada elemento es el mensaje completo, igual que en plazbot messages list.

Errores comunes

Mensaje	Causa	Solución
`No messages match`	Ningún mensaje contiene ese texto	Prueba con otra palabra o sin tildes