Producto
CLI

Crear o actualizar un contacto

plazbot contacts upsert: crea un contacto de WhatsApp, o lo actualiza si el número ya existe

Crear o actualizar un contacto de WhatsApp

Crea un contacto de WhatsApp, o lo actualiza si el número ya existe en ese canal. Se puede repetir sin crear duplicados, así que sirve para sincronizar contactos desde otro sistema.

bash
01plazbot contacts upsert -p <número> [opciones]

Parámetros

ParámetroFlagRequeridoDescripción
Teléfono-p, --phone <number>SíNúmero de WhatsApp del contacto en formato internacional
Canal--channel <integrationId>NoNúmero de WhatsApp de tu empresa al que pertenece el contacto (int_...). Por defecto, el único número de WhatsApp activo del workspace
Nombre--name <name>NoNombre
Apellido--lastname <lastname>NoApellido
Email-e, --email <email>NoEmail
Fase--stage <stageId>NoID de la fase
JSON--jsonNoImprime la respuesta de la API en JSON
Confirmar-y, --yesNoOmite la confirmación
Workspace-w, --workspace <id>NoOtro de tus workspaces
Zona-z, --zone <zone>NoLA o EU

Cómo funciona

  • Solo crea contactos de WhatsApp.
  • El contacto se busca por número y canal. Si ya existe, se actualizan los campos que pasas (nombre, apellido, email y fase); si no, se crea.
  • Si el workspace tiene un solo número de WhatsApp activo, se usa automáticamente. Con varios números, o con ninguno, tienes que pasar --channel. Consulta los IDs con plazbot workspace show channels.
  • Pide confirmación antes de guardar; sin terminal interactiva necesitas --yes.

Ejemplos

bash
01# Crear o actualizar un contacto
02plazbot contacts upsert -p +51912345678 --name Ana --email ana@empresa.com
03 
04# Workspace con varios números de WhatsApp
05plazbot contacts upsert -p +51912345678 --name Ana --channel int_AbcDef123 --yes
06 
07# Crear y dejar en una fase
08plazbot contacts upsert -p +51912345678 --name Ana --stage mos_AbcDef123 --yes

Resultado

text
01? Create or update contact +51912345678? Yes
02 
03 Contact +51912345678 saved

Salida JSON

Con --json se imprime la respuesta de la API:

json
01{
02 "success": true,
03 "code": 200,
04 "message": "Contact created successfully.",
05 "data": { "id": "con_AbcDef123" }
06}

Para cambiar etiquetas, agente u otros campos después de crearlo, usa plazbot contacts update.

Errores comunes

MensajeCausaSolución
The workspace has several WhatsApp numbers.Hay más de un número activoElige uno con --channel
The workspace has no active WhatsApp number.No hay números de WhatsApp conectadosConecta uno con plazbot whatsapp connect
Invalid phone number "..."Número inválidoUsa el formato internacional con código de país
The assigned integration is not located in your workspace.--channel no es un número de WhatsApp de ese workspaceRevisa el ID con plazbot workspace show channels
This action needs confirmation and there is no interactive terminal.Sin terminal y sin --yesAgrega --yes
¿Quieres probar la API en vivo? Abre el Playground.