Inscribir un número en una secuencia

Inscribe un número de WhatsApp en una secuencia. Desde ese momento el número empieza a recibir los mensajes de la secuencia desde el canal que elijas. Si el número no existe como contacto, la API lo crea.

Este comando envía mensajes reales (plantillas de WhatsApp, que Meta cobra). Pide confirmación; en scripts y agentes de IA necesita --yes.

bash

01plazbot sequences enroll <sequenceId> -p <número> --channel <integrationId> [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
Secuencia	`<sequenceId>`	Sí	ID de la secuencia (`seq_...`).
Teléfono	`-p, --phone <number>`	Sí	Número de WhatsApp en formato internacional, por ejemplo `+51912345678`.
Canal	`--channel <integrationId>`	Sí	Número de WhatsApp que envía (`int_...`). Los IDs salen de `plazbot workspace show channels`.
Confirmar	`-y, --yes`	No	Omite la confirmación (para scripts y CI).
Workspace	`-w, --workspace <id>`	No	Workspace donde se ejecuta. Por defecto, el activo.
Zona	`-z, --zone <zone>`	No	`LA` o `EU`. Por defecto, la zona de la sesión.
JSON	`--json`	No	Imprime el resultado como JSON.

Ejemplos

bash

01# Inscribir un número (pide confirmación)
02plazbot sequences enroll seq_AbcDef123 -p +51912345678 --channel int_AbcDef123
03 
04# Desde un script, sin preguntar
05plazbot sequences enroll seq_AbcDef123 -p +51912345678 --channel int_AbcDef123 --yes --json

Resultado

text

01? Enroll +51912345678 in sequence seq_AbcDef123? It will receive its messages. Yes
02 
03  +51912345678 enrolled in seq_AbcDef123

Salida JSON

Con --json imprime la respuesta de la API (POST /api/sequence/individual):

json

01{
02  "success": true,
03  "code": 200,
04  "message": "..."
05}

Para cancelar la secuencia de un contacto hazlo desde el chat en la app, o con plazbot api sobre POST /api/contact/cancelSequence.

Errores comunes

Mensaje	Causa	Solución
`You are not signed in.`	No hay sesión.	Ejecuta `plazbot login`.
`Missing --channel.`	No pasaste el canal que envía.	Elige uno con `plazbot workspace show channels`.
`Invalid phone number "..."`	El número no tiene formato internacional.	Usa el código de país, por ejemplo `+51912345678`.
`This action needs confirmation and there is no interactive terminal.`	Se ejecutó sin terminal y sin `--yes`.	Agrega `--yes`.
`The sequence with id '...' was not found in workspace '...'.`	La secuencia no existe en el workspace.	Revisa el ID con `plazbot sequences list`.
`Integration was not found.`	El canal no existe en el workspace.	Revisa el ID con `plazbot workspace show channels`.