# Inscribir un número en una secuencia

> plazbot sequences enroll: inscribe un número de WhatsApp en una secuencia; empieza a recibir sus mensajes.

Fuente: https://developers.plazbot.com/cli/sequences/enroll/

### 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.

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

```bash
plazbot 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`](https://developers.plazbot.com/cli/workspace). |
| 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
# Inscribir un número (pide confirmación)
plazbot sequences enroll seq_AbcDef123 -p +51912345678 --channel int_AbcDef123

# Desde un script, sin preguntar
plazbot sequences enroll seq_AbcDef123 -p +51912345678 --channel int_AbcDef123 --yes --json
```

### Resultado

```text
? Enroll +51912345678 in sequence seq_AbcDef123? It will receive its messages. Yes

+51912345678 enrolled in seq_AbcDef123
```

### Salida JSON

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

```json
{
"success": true,
"code": 200,
"message": "..."
}
```

Para cancelar la secuencia de un contacto hazlo desde el chat en la app, o con [`plazbot api`](https://developers.plazbot.com/cli/ia/api) sobre `POST /api/contact/cancelSequence`.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `You are not signed in.` | No hay sesión. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login). |
| `Missing --channel.` | No pasaste el canal que envía. | Elige uno con [`plazbot workspace show channels`](https://developers.plazbot.com/cli/workspace). |
| `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`](https://developers.plazbot.com/cli/sequences/list). |
| `Integration was not found.` | El canal no existe en el workspace. | Revisa el ID con `plazbot workspace show channels`. |