Buscar contactos

Busca contactos por número de WhatsApp o por email. Un mismo número puede tener más de un contacto si escribió a distintos números de tu empresa, por eso el resultado es una lista.

bash

01plazbot contacts search (-p <número> | -e <email>) [--json]

Parámetros

Parámetro	Flag	Requerido	Descripción
Teléfono	`-p, --phone <number>`	Uno de los dos	Número en formato internacional: `+51912345678`, `51912345678` o `"+51 912 345 678"`
Email	`-e, --email <email>`	Uno de los dos	Email exacto
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`

Pasa --phone o --email, no los dos.

Ejemplos

bash

01# Buscar por teléfono
02plazbot contacts search -p +51912345678
03 
04# Buscar por email, en JSON
05plazbot contacts search -e ana@empresa.com --json
06 
07# Obtener solo el ID del primer resultado
08plazbot contacts search -p +51912345678 --json | jq -r '.data[0].id'

Resultado

text

01  Contacts (2)
02  ────────────────────────────────────────
03┌───────────────┬────────────┬─────────────┬──────────┬────────────┬──────────────────┐
04│ ID            │ Name       │ Phone       │ Channel  │ Agent      │ Last message     │
05├───────────────┼────────────┼─────────────┼──────────┼────────────┼──────────────────┤
06│ con_AbcDef123 │ Ana Torres │ 51912345678 │ whatsapp │ Luis Pérez │ 2026-10-06 17:32 │
07├───────────────┼────────────┼─────────────┼──────────┼────────────┼──────────────────┤
08│ con_GhiJkl456 │ Ana Torres │ 51912345678 │ whatsapp │ Luis Pérez │ 2026-06-25 02:23 │
09└───────────────┴────────────┴─────────────┴──────────┴────────────┴──────────────────┘

Salida JSON

json

01{
02  "data": [
03    {
04      "id": "con_AbcDef123",
05      "name": "Ana",
06      "lastname": "Torres",
07      "internalWhatsappNumber": "51912345678",
08      "platformId": 2,
09      "assignedAgentName": "Luis Pérez",
10      "lastMessageDate": "2026-10-06T17:32:08.404Z"
11    }
12  ],
13  "nextCursor": null
14}

Cada elemento es el contacto completo, igual que en plazbot contacts get.

Errores comunes

Mensaje	Causa	Solución
`Pass either --phone or --email.`	No pasaste ninguno, o pasaste los dos	Usa solo uno
`Invalid phone number "..."`	El número no tiene entre 8 y 15 dígitos	Usa el formato internacional con código de país
`No contact matches`	No hay contactos con ese dato	Revisa el número o el email, y el workspace activo