plazbot-cli 0.3.7 → 0.4.1

package/dist/commands/whatsapp/connect.js

@@ -1,187 +1,53 @@
 import { Command } from 'commander';
-import axios from 'axios';
-import ora from 'ora';
 import chalk from 'chalk';
+import ora from 'ora';
 import { getStoredCredentials } from '../../utils/credentials.js';
 import { logger } from '../../utils/logger.js';
 import { addExamples } from '../../utils/help.js';
 import { theme, section } from '../../utils/ui.js';
-function getBaseUrl(zone, dev) {
-    if (dev)
-        return 'http://localhost:5090';
-    return zone === 'EU' ? 'https://apieu.plazbot.com' : 'https://api.plazbot.com';
-}
-function getIntegrationLabel(ig) {
-    if (ig.type === 'whatsapp') {
-        return ig.aliasName
-            ? `${ig.aliasName} (${ig.cellphoneNumberFormat || ig.cellphoneNumber || ''})`
-            : ig.cellphoneNumberFormat || ig.cellphoneNumber || ig.id;
-    }
-    return ig.aliasName || ig.srcName || ig.id;
-}
-async function fetchWorkspaceIntegrations(baseUrl, workspaceId, headers) {
-    try {
-        const wkRes = await axios.get(`${baseUrl}/api/workspace/${workspaceId}`, { headers });
-        const wsData = Array.isArray(wkRes.data) ? wkRes.data[0] : wkRes.data;
-        return wsData?.integrations || [];
-    }
-    catch {
-        return [];
-    }
-}
-async function activateIntegration(baseUrl, workspaceId, integrationId, headers) {
-    try {
-        const res = await axios.post(`${baseUrl}/api/workspace/${workspaceId}/integrations/${integrationId}/activate`, { isActive: true }, { headers });
-        return res.data?.success === true;
-    }
-    catch {
-        return false;
-    }
-}
+import { connectNewNumber, fetchIntegrations, integrationLabel, whatsappNumbers } from './connect-flow.js';
 export const whatsappConnectCommand = new Command('connect')
-    .description('Connect a WhatsApp number to the workspace (without creating an agent)')
-    .option('--dev', 'Use development environment', false)
-    .option('--business', 'Connect as WhatsApp Business', false)
+    .description('Conecta un número de WhatsApp al workspace')
+    .option('--business', 'Conectar tu app WhatsApp Business actual (coexistencia)', false)
+    .option('--no-browser', 'No abrir el navegador automáticamente')
+    .option('--dev', 'Usar el entorno de desarrollo local', false)
     .action(async (options) => {
     try {
         const credentials = await getStoredCredentials();
-        const baseUrl = getBaseUrl(credentials.zone, options.dev);
-        const headers = {
-            'Authorization': `Bearer ${credentials.apiKey}`,
-            'x-workspace-id': credentials.workspace,
-            'Content-Type': 'application/json',
-        };
-        const channelType = options.business ? 'whatsapp_business' : 'whatsapp';
-        const channelLabel = options.business ? 'WhatsApp Business' : 'WhatsApp';
-        console.log(section(`Connect ${channelLabel}`));
-        console.log();
-        // Cargar integraciones existentes
-        const loadSpinner = ora({ text: chalk.gray('Loading existing integrations...'), spinner: 'dots', color: 'green' }).start();
-        const allIntegrations = await fetchWorkspaceIntegrations(baseUrl, credentials.workspace, headers);
-        const existing = allIntegrations.filter((ig) => ig.type === 'whatsapp');
+        console.log(section(options.business ? 'Conectar WhatsApp Business' : 'Conectar WhatsApp'));
+        const loadSpinner = ora({ text: chalk.gray('Cargando números conectados...'), spinner: 'dots', color: 'green' }).start();
+        const existing = whatsappNumbers(await fetchIntegrations(credentials, options.dev));
         loadSpinner.stop();
         if (existing.length > 0) {
-            console.log(theme.muted(`  ${existing.length} number(s) already connected:`));
-            existing.forEach((ig) => {
-                const label = getIntegrationLabel(ig);
-                const status = ig.isActive ? chalk.hex('#66BB6A')('active') : chalk.hex('#EF5350')('inactive');
-                console.log(`    ${theme.muted('•')} ${label}  ${status}`);
+            console.log(theme.muted(`  ${existing.length} número(s) ya conectado(s):`));
+            existing.forEach(ig => {
+                const status = ig.isActive ? chalk.hex('#66BB6A')('activo') : chalk.hex('#EF5350')('inactivo');
+                console.log(`    ${theme.muted('•')} ${integrationLabel(ig)}  ${status}`);
             });
-            console.log();
         }
-        // Obtener o generar link de onboarding (mismo flujo que Plazbot Front)
-        const ONBOARDING_SHORT_DOMAIN = 'https://co.plzb.link';
-        const spinner = ora({ text: chalk.gray('Fetching connection link...'), spinner: 'dots', color: 'green' }).start();
-        let linkData = null;
-        // 1. Intentar obtener link existente (GET)
-        try {
-            const getRes = await axios.get(`${baseUrl}/api/workspace/${credentials.workspace}/onboarding-link`, { headers, params: { type: channelType } });
-            linkData = getRes.data?.data ?? null;
-        }
-        catch {
-            linkData = null;
-        }
-        // 2. Si existe pero esta expirado, regenerar
-        if (linkData?.expiresAt && new Date(linkData.expiresAt) < new Date()) {
-            try {
-                const regenRes = await axios.post(`${baseUrl}/api/workspace/${credentials.workspace}/onboarding-link/regenerate`, { type: channelType }, { headers });
-                linkData = regenRes.data?.data ?? null;
-            }
-            catch {
-                linkData = null;
-            }
-        }
-        // 3. Si no existe, generar uno nuevo (POST)
-        if (!linkData?.token) {
-            try {
-                const createRes = await axios.post(`${baseUrl}/api/workspace/${credentials.workspace}/onboarding-link`, { type: channelType }, { headers });
-                linkData = createRes.data?.data ?? null;
-            }
-            catch {
-                linkData = null;
-            }
-        }
-        if (!linkData?.token) {
-            spinner.fail(chalk.hex('#EF5350')('Could not obtain the connection link'));
-            process.exit(1);
-        }
-        const shortUrl = `${ONBOARDING_SHORT_DOMAIN}/${linkData.token}`;
-        const expiresAt = linkData.expiresAt ? new Date(linkData.expiresAt).toLocaleDateString('en-US', { day: 'numeric', month: 'long', year: 'numeric' }) : '';
-        spinner.stop();
-        // Mostrar link
-        const W = 54;
-        const pad = (text) => text + ' '.repeat(Math.max(0, W - text.length));
-        const border = chalk.hex('#25D366');
-        console.log(border('  ┌' + '─'.repeat(W) + '┐'));
-        console.log(border('  │') + chalk.bold(pad('  Open this link in your browser:')) + border('│'));
-        console.log(border('  │') + ' '.repeat(W) + border('│'));
-        console.log(border('  │') + chalk.hex('#22d3ee')(pad(`  ${shortUrl}`)) + border('│'));
-        console.log(border('  │') + ' '.repeat(W) + border('│'));
-        console.log(border('  │') + chalk.gray(pad('  Scan the QR code from your WhatsApp')) + border('│'));
-        if (expiresAt) {
-            console.log(border('  │') + chalk.gray(pad(`  Expires: ${expiresAt}`)) + border('│'));
-        }
-        console.log(border('  └' + '─'.repeat(W) + '┘'));
+        const detected = await connectNewNumber(credentials, {
+            business: options.business,
+            dev: options.dev,
+            openInBrowser: options.browser,
+        });
         console.log();
-        // Guardar IDs actuales para detectar nuevos
-        const prevIds = new Set(allIntegrations.map((i) => i.id));
-        // Polling para detectar nueva integracion
-        const pollSpinner = ora({ text: chalk.gray('Waiting for connection... (Ctrl+C to cancel)'), spinner: 'dots', color: 'cyan' }).start();
-        const POLL_INTERVAL = 5000;
-        const MAX_POLLS = 60; // 5 minutos
-        let detected = null;
-        for (let i = 0; i < MAX_POLLS; i++) {
-            await new Promise(r => setTimeout(r, POLL_INTERVAL));
-            try {
-                const freshIntegrations = await fetchWorkspaceIntegrations(baseUrl, credentials.workspace, headers);
-                const newOnes = freshIntegrations.filter((ig) => !prevIds.has(ig.id));
-                if (newOnes.length > 0) {
-                    const match = newOnes.find((ig) => ig.type === 'whatsapp');
-                    detected = match || newOnes[0];
-                    break;
-                }
-            }
-            catch { }
-            const elapsed = Math.floor(((i + 1) * POLL_INTERVAL) / 1000);
-            pollSpinner.text = chalk.gray(`Waiting for connection... ${elapsed}s (Ctrl+C to cancel)`);
-        }
         if (detected) {
-            const detectedName = getIntegrationLabel(detected);
-            pollSpinner.succeed(chalk.hex('#4ade80')(`Connection detected: ${detectedName}`));
-            // Activar la integracion
-            const actSpinner = ora({ text: chalk.gray('Activating integration...'), spinner: 'dots', color: 'green' }).start();
-            const activated = await activateIntegration(baseUrl, credentials.workspace, detected.id, headers);
-            if (activated) {
-                actSpinner.succeed(chalk.hex('#4ade80')('Integration activated successfully'));
-            }
-            else {
-                actSpinner.warn(chalk.hex('#FFA726')('Could not activate automatically. Activate it from the platform.'));
-            }
-            console.log();
-            console.log(theme.success('  WhatsApp connected successfully'));
-            console.log(theme.muted(`  Number: ${detectedName}`));
-            console.log();
-            console.log(theme.muted('  You can now:'));
-            console.log(theme.muted('    plazbot whatsapp send-message    Send a message'));
-            console.log(theme.muted('    plazbot whatsapp chat <phone>    Interactive chat'));
-            console.log(theme.muted('    plazbot whatsapp assign <phone> <agentId>  Assign to an agent'));
+            console.log(theme.success(`  WhatsApp conectado: ${integrationLabel(detected)}`));
             console.log();
+            console.log(theme.muted('  Siguiente paso:'));
+            console.log(`    ${chalk.cyan('plazbot whatsapp setup')}   ${theme.muted('Prueba enviar y recibir tu primer mensaje')}`);
         }
         else {
-            pollSpinner.warn(chalk.hex('#FFA726')('Timeout: no connection detected within 5 minutes.'));
-            console.log(theme.muted('  You can try again with: plazbot whatsapp connect'));
-            console.log();
+            console.log(theme.muted('  Puedes intentarlo otra vez con: plazbot whatsapp connect'));
         }
+        console.log();
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        logger.error(message);
+        logger.error(error instanceof Error ? error.message : 'Error desconocido');
         process.exit(1);
     }
 });
 addExamples(whatsappConnectCommand, [
-    { description: 'Generate a QR connection link for WhatsApp',
-        command: 'plazbot whatsapp connect' },
-    { description: 'Connect a WhatsApp Business number',
-        command: 'plazbot whatsapp connect --business' },
+    { description: 'Conectar un número con WhatsApp API', command: 'plazbot whatsapp connect' },
+    { description: 'Conectar tu app WhatsApp Business actual', command: 'plazbot whatsapp connect --business' },
 ]);

package/dist/commands/whatsapp/index.js

@@ -7,10 +7,12 @@ import { deleteWebhookCommand } from './delete-webhook.js';
 import { broadcastCommand } from './broadcast.js';
 import { whatsappChatCommand } from './chat.js';
 import { whatsappConnectCommand } from './connect.js';
+import { whatsappSetupCommand } from './setup.js';
 import { widgetCommand } from './widget.js';
 import { channelsCommand, assignCommand } from './channels.js';
 export const whatsappCommands = new Command('whatsapp')
     .description('WhatsApp commands: messages, templates, broadcast and more')
+    .addCommand(whatsappSetupCommand)
     .addCommand(whatsappConnectCommand)
     .addCommand(sendMessageCommand)
     .addCommand(sendTemplateCommand)
@@ -22,6 +24,8 @@ export const whatsappCommands = new Command('whatsapp')
     .addCommand(channelsCommand)
     .addCommand(assignCommand);
 addExamples(whatsappCommands, [
+    { description: 'Asistente: conectar WhatsApp y enviar tu primer mensaje',
+        command: 'plazbot whatsapp setup' },
     { description: 'Connect a WhatsApp number to the workspace',
         command: 'plazbot whatsapp connect' },
     { description: 'Send a quick message',

package/dist/commands/whatsapp/setup.js

@@ -0,0 +1,242 @@
+import { Command } from 'commander';
+import axios from 'axios';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { apiBaseUrl, getStoredCredentials } from '../../utils/credentials.js';
+import { createSpinner, theme } from '../../utils/ui.js';
+import { logger } from '../../utils/logger.js';
+import { addExamples, addNotes } from '../../utils/help.js';
+import { runBrowserLogin } from '../auth/browser-login.js';
+import { activateIntegration, apiHeaders, connectNewNumber, fetchIntegrations, integrationLabel, whatsappNumbers, } from './connect-flow.js';
+/**
+ * plazbot whatsapp setup — wizard de primer uso:
+ *   1. Sesión      → si no hay, login por navegador.
+ *   2. Número      → usa uno conectado o conecta uno nuevo (link de Meta).
+ *   3. Prueba      → el developer escribe "hola" desde su celular (crea el contacto y abre la
+ *                    ventana de 24 h de WhatsApp) y el CLI responde por la API.
+ *   4. Webhook     → opcional, registra la URL que recibirá los mensajes entrantes.
+ *   5. Código      → snippet con sus datos para su app.
+ *
+ * El paso 3 es necesario: POST /api/message solo envía a contactos que ya existen y
+ * WhatsApp solo permite texto libre dentro de las 24 h desde el último mensaje del cliente.
+ */
+const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+const step = (n, title) => console.log(`\n${chalk.hex('#25D366').bold(`[${n}/4]`)} ${chalk.bold(title)}`);
+/** Variantes del número tal como WhatsApp lo reporta (México 52/521, Argentina 54/549). */
+function phoneVariants(digits) {
+    const v = new Set([digits]);
+    if (digits.startsWith('521') && digits.length === 13)
+        v.add('52' + digits.slice(3));
+    else if (digits.startsWith('52') && digits.length === 12)
+        v.add('521' + digits.slice(2));
+    if (digits.startsWith('549') && digits.length === 13)
+        v.add('54' + digits.slice(3));
+    else if (digits.startsWith('54') && digits.length === 12)
+        v.add('549' + digits.slice(2));
+    return [...v];
+}
+async function findRecentContact(creds, dev, phones, since, numberId) {
+    for (const phone of phones) {
+        try {
+            const res = await axios.get(`${apiBaseUrl(creds.zone, dev)}/api/contact/searchByCellphone`, {
+                headers: apiHeaders(creds),
+                params: { workspaceId: creds.workspace, cellphone: phone },
+            });
+            const contacts = res.data?.data?.data ?? [];
+            const hit = contacts.find(c => c.lastMessageDate && new Date(c.lastMessageDate).getTime() >= since &&
+                (!numberId || !c.platformSenderId || c.platformSenderId === numberId));
+            if (hit)
+                return hit;
+        }
+        catch {
+            // error puntual: se reintenta en la siguiente vuelta
+        }
+    }
+    return null;
+}
+async function ensureSession(opts) {
+    try {
+        const creds = await getStoredCredentials();
+        console.log(`  ${chalk.green('✓')} ${creds.workspaceName || creds.workspace} ${theme.muted(`(${creds.zone})`)}${creds.email ? theme.muted(` · ${creds.email}`) : ''}`);
+        return creds;
+    }
+    catch {
+        console.log(theme.muted('  No tienes una sesión activa. Vamos a iniciarla desde el navegador.'));
+        return runBrowserLogin({ dev: opts.dev, browser: opts.browser });
+    }
+}
+async function chooseNumber(creds, opts) {
+    const spinner = createSpinner('Buscando números conectados...').start();
+    const numbers = whatsappNumbers(await fetchIntegrations(creds, opts.dev)).filter(n => !n.isUnofficialWsp);
+    spinner.stop();
+    let choice = 'new';
+    if (numbers.length > 0) {
+        const answer = await inquirer.prompt([{
+                type: 'list',
+                name: 'choice',
+                message: '¿Qué número quieres usar?',
+                choices: [
+                    ...numbers.map(n => ({ name: `${integrationLabel(n)}${n.isActive ? '' : chalk.hex('#EF5350')('  (inactivo)')}`, value: n.id })),
+                    new inquirer.Separator(),
+                    { name: 'Conectar un número nuevo', value: 'new' },
+                ],
+            }]);
+        choice = answer.choice;
+    }
+    if (choice !== 'new') {
+        const selected = numbers.find(n => n.id === choice);
+        if (!selected.isActive) {
+            const act = createSpinner('Activando el número...').start();
+            if (await activateIntegration(creds, selected.id, opts.dev))
+                act.succeed('Número activo');
+            else
+                act.warn('No se pudo activar. Actívalo en el panel → Integraciones.');
+        }
+        console.log(`  ${chalk.green('✓')} ${integrationLabel(selected)}`);
+        return selected;
+    }
+    const { kind } = await inquirer.prompt([{
+            type: 'list',
+            name: 'kind',
+            message: '¿Cómo quieres conectar WhatsApp?',
+            choices: [
+                { name: `WhatsApp API ${theme.muted('— número nuevo o dedicado, ideal para enviar a escala')}`, value: 'api' },
+                { name: `WhatsApp Business ${theme.muted('— tu app actual en el celular (coexistencia, se vincula con QR)')}`, value: 'business' },
+            ],
+        }]);
+    return connectNewNumber(creds, { business: kind === 'business', dev: opts.dev, openInBrowser: opts.browser });
+}
+async function firstMessageTest(creds, number, dev) {
+    const { phone } = await inquirer.prompt([{
+            type: 'input',
+            name: 'phone',
+            message: '¿Desde qué celular vas a escribir? (con código de país, p. ej. 51912345678)',
+            validate: (v) => /^\d{8,15}$/.test(v.replace(/\D/g, '')) || 'Escribe solo el número con código de país.',
+        }]);
+    const digits = String(phone).replace(/\D/g, '');
+    const target = number.cellphoneNumber || '';
+    console.log();
+    console.log(`  Desde ese celular envía ${chalk.bold('"hola"')} por WhatsApp a ${chalk.bold(`+${target}`)}`);
+    if (target)
+        console.log(`  ${theme.muted('Atajo:')} ${chalk.underline(`https://wa.me/${target}?text=hola`)}`);
+    console.log(theme.muted('  Tu mensaje crea el contacto y abre la ventana de 24 h en la que WhatsApp permite responder con texto libre.'));
+    console.log();
+    const since = Date.now() - 60_000;
+    const spinner = createSpinner('Esperando tu mensaje... (Ctrl+C para cancelar)').start();
+    const deadline = Date.now() + 5 * 60_000;
+    let contact = null;
+    while (Date.now() < deadline && !contact) {
+        await sleep(3000);
+        contact = await findRecentContact(creds, dev, phoneVariants(digits), since, number.codeCellphoneNumberId);
+    }
+    if (!contact) {
+        spinner.warn('No recibimos tu mensaje en 5 minutos.');
+        console.log(theme.muted('  Revisa que el número esté activo y vuelve a ejecutar plazbot whatsapp setup.'));
+        return null;
+    }
+    spinner.succeed(`Recibimos tu mensaje${contact.lastMessage ? `: "${contact.lastMessage}"` : ''}`);
+    const { reply } = await inquirer.prompt([{ type: 'confirm', name: 'reply', message: '¿Te respondemos desde la API?', default: true }]);
+    if (!reply)
+        return contact.internalWhatsappNumber;
+    const sendSpinner = createSpinner('Enviando respuesta...').start();
+    try {
+        const res = await axios.post(`${apiBaseUrl(creds.zone, dev)}/api/message`, {
+            workspaceId: creds.workspace,
+            recipientPhone: contact.internalWhatsappNumber,
+            content: '¡Funciona! 🎉 Este mensaje lo envió tu código a través de la API de Plazbot.',
+        }, { headers: apiHeaders(creds) });
+        if (res.data?.success === false)
+            throw new Error(res.data?.message || 'La API rechazó el envío.');
+        sendSpinner.succeed('Mensaje enviado. Revisa tu WhatsApp.');
+    }
+    catch (error) {
+        const msg = axios.isAxiosError(error) ? (error.response?.data?.message || error.message) : error.message;
+        sendSpinner.fail(`No se pudo enviar: ${msg}`);
+    }
+    return contact.internalWhatsappNumber;
+}
+async function webhookStep(creds, number, dev) {
+    const { url } = await inquirer.prompt([{
+            type: 'input',
+            name: 'url',
+            message: 'URL de tu webhook para recibir los mensajes entrantes (Enter para omitir):',
+            default: number.webhookUrl || '',
+            validate: (v) => !v || /^https:\/\/\S+$/.test(v) || 'Debe ser una URL https://',
+        }]);
+    if (!url) {
+        console.log(theme.muted('  Omitido. Puedes registrarlo después con: plazbot whatsapp register-webhook'));
+        return null;
+    }
+    const spinner = createSpinner('Registrando webhook...').start();
+    try {
+        const res = await axios.post(`${apiBaseUrl(creds.zone, dev)}/api/workspace/${creds.workspace}/whatsapp/numbers/${number.cellphoneNumber}/webhook`, { webhook: url }, { headers: apiHeaders(creds) });
+        if (res.data?.success === false)
+            throw new Error(res.data?.message);
+        spinner.succeed(`Webhook registrado: ${url}`);
+        return url;
+    }
+    catch (error) {
+        spinner.fail(`No se pudo registrar el webhook${error instanceof Error && error.message ? `: ${error.message}` : ''}`);
+        return null;
+    }
+}
+function printSnippet(creds, to) {
+    const code = [
+        `import { Plazbot } from "plazbot"`,
+        ``,
+        `const bot = new Plazbot({`,
+        `  apiKey:      process.env.PLAZBOT_KEY!,`,
+        `  workspaceId: "${creds.workspace}",`,
+        `  zone:        "${creds.zone}",`,
+        `})`,
+        ``,
+        `await bot.message.onWhatsappMessage({`,
+        `  to:      "${to || '51912345678'}",`,
+        `  message: "Hola desde mi app",`,
+        `})`,
+    ];
+    console.log(`\n${chalk.bold('Listo. Usa esto en tu app')} ${theme.muted('(npm i plazbot)')}\n`);
+    code.forEach(l => console.log('  ' + chalk.hex('#9CDCFE')(l)));
+    console.log();
+    console.log(theme.muted('  Para tu servidor crea una API key en el panel → Configuración → Developer y guárdala en PLAZBOT_KEY.'));
+    console.log(theme.muted('  Docs: https://developers.plazbot.com/sdk'));
+    console.log();
+}
+export const whatsappSetupCommand = new Command('setup')
+    .description('Asistente: conecta WhatsApp y envía/recibe tu primer mensaje')
+    .option('--no-browser', 'No abrir el navegador automáticamente')
+    .option('--dev', 'Usar el entorno de desarrollo local', false)
+    .action(async (options) => {
+    try {
+        console.log(`\n${chalk.bold('WhatsApp · configuración inicial')}`);
+        step(1, 'Tu cuenta');
+        const creds = await ensureSession(options);
+        step(2, 'Tu número de WhatsApp');
+        const number = await chooseNumber(creds, options);
+        if (!number) {
+            console.log(theme.muted('\n  Ejecuta plazbot whatsapp setup de nuevo cuando termines el registro en Meta.\n'));
+            process.exit(1);
+        }
+        step(3, 'Prueba de ida y vuelta');
+        const to = await firstMessageTest(creds, number, options.dev);
+        step(4, 'Webhook (opcional)');
+        await webhookStep(creds, number, options.dev);
+        printSnippet(creds, to);
+    }
+    catch (error) {
+        // Ctrl+C durante un prompt de inquirer
+        if (error instanceof Error && error.name === 'ExitPromptError') {
+            console.log(theme.muted('\n  Cancelado.\n'));
+            process.exit(130);
+        }
+        logger.error(error instanceof Error ? error.message : 'Error desconocido');
+        process.exit(1);
+    }
+});
+addExamples(whatsappSetupCommand, [
+    { description: 'Configurar WhatsApp paso a paso', command: 'plazbot whatsapp setup' },
+]);
+addNotes(whatsappSetupCommand, [
+    'La prueba usa tu propio celular: le escribes "hola" a tu número y la API te responde.',
+    'Para escribir primero a un cliente nuevo necesitas una plantilla aprobada (plazbot whatsapp send-template).',
+]);

package/dist/schemas/agent.config.schema.json

@@ -99,6 +99,30 @@
     "enableWhatsappWidget": { "type": "boolean" },
     "urlWhatsappWidget": { "type": "string" },
     "formWidget": { "type": "boolean" },
+    "formTypeWidget": {
+      "type": ["string", "null"],
+      "enum": ["chat", "fields", null],
+      "default": "chat",
+      "description": "Estilo del formulario de registro: chat (conversacional) o fields (campos en una sola pantalla). Solo aplica si formWidget es true."
+    },
+    "formFieldsWidget": {
+      "type": ["array", "null"],
+      "maxItems": 5,
+      "description": "Campos adicionales del formulario por campos (formTypeWidget = fields). Cada valor se guarda en una variable del contacto.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string" },
+          "label": { "type": "string", "maxLength": 60 },
+          "type": { "type": "string", "enum": ["text", "select", "date"], "default": "text" },
+          "options": { "type": ["array", "null"], "items": { "type": "string", "maxLength": 60 }, "maxItems": 20 },
+          "variable": { "type": "string" },
+          "required": { "type": "boolean" }
+        },
+        "required": ["label", "type", "variable"],
+        "additionalProperties": false
+      }
+    },
     "darkWidget": { "type": "boolean" },
     "colorWidget": {
       "type": ["string", "null"],

package/dist/studio/components/App.js

@@ -200,7 +200,7 @@ export function App({ version, stream, initialAgentId, dev, supportMode }) {
 function formatError(err, dev) {
     if (err instanceof StudioHttpError) {
         if (err.status === 401)
-            return '✖ Token expired or invalid. Run `plazbot init` with a valid JWT.';
+            return '✖ Token expired or invalid. Run `plazbot login`.';
         if (err.status === 403)
             return '✖ No permission for this workspace.';
         if (err.status === 429)

package/dist/studio/runOneShot.js

@@ -10,7 +10,7 @@ export async function runOneShot(opts) {
     }
     catch {
         logger.error('No active session. Run:');
-        console.log('  plazbot init -e <email> -k <jwt> -w <workspace> -z <LA|EU>');
+        console.log('  plazbot login');
         process.exit(1);
         return;
     }
@@ -78,7 +78,7 @@ export async function runOneShot(opts) {
 function formatError(err, dev) {
     if (err instanceof StudioHttpError) {
         if (err.status === 401)
-            return '✖ Token expired or invalid. Run `plazbot init`.';
+            return '✖ Token expired or invalid. Run `plazbot login`.';
         if (err.status === 403)
             return '✖ No permission for this workspace.';
         if (err.status === 429)

package/dist/studio/runRepl.js

@@ -18,7 +18,7 @@ export async function runRepl(opts) {
     }
     catch (err) {
         logger.error('No active session. Run:');
-        console.log('  plazbot init -e <email> -k <jwt> -w <workspace> -z <LA|EU>');
+        console.log('  plazbot login');
         process.exit(1);
     }
     const effectiveWorkspace = opts.workspaceOverride ?? creds.workspace;

package/dist/utils/agent-errors.js

@@ -17,13 +17,13 @@ export function describeAgentLoadError(error, agentId, credentials, context = {}
             chalk.gray('    plazbot status'),
             chalk.gray('    plazbot agent list'),
             chalk.gray('  If the agent lives in a different zone, re-init with the right one:'),
-            chalk.gray('    plazbot init -z LA   # or EU'),
+            chalk.gray('    plazbot login'),
         ].join('\n');
     }
     if (status === 401) {
         return [
             'Authentication token rejected (401).',
-            chalk.gray('  Re-run: plazbot init -k <jwt> -w <workspace> -z LA|EU'),
+            chalk.gray('  Re-run: plazbot login'),
         ].join('\n');
     }
     if (status === 403) {

package/dist/utils/banner.js

@@ -47,22 +47,23 @@ export async function showBanner() {
         rightColumn.push('');
         rightColumn.push(chalk.hex('#4CAF50')('─'.repeat(35)));
         rightColumn.push('');
-        rightColumn.push(chalk.bold.hex('#4CAF50')('Quick commands'));
-        rightColumn.push(chalk.white('  plazbot agent list'));
-        rightColumn.push(chalk.white('  plazbot agent create'));
-        rightColumn.push(chalk.white('  plazbot agent chat -a <id>'));
+        rightColumn.push(chalk.bold.hex('#4CAF50')('Comandos rápidos'));
+        rightColumn.push(chalk.white('  plazbot whatsapp setup'));
         rightColumn.push(chalk.white('  plazbot whatsapp send-message'));
+        rightColumn.push(chalk.white('  plazbot agent list'));
+        rightColumn.push(chalk.white('  plazbot studio'));
     }
     else {
-        rightColumn.push(chalk.bold.hex('#FFA726')('Not connected'));
+        rightColumn.push(chalk.bold.hex('#FFA726')('Sin sesión'));
         rightColumn.push('');
-        rightColumn.push(chalk.bold.hex('#4CAF50')('To get started'));
-        rightColumn.push(chalk.white('  plazbot init -e <email> -k <key> -w <workspace> -z <zone>'));
+        rightColumn.push(chalk.bold.hex('#4CAF50')('Empieza aquí'));
+        rightColumn.push(chalk.white('  plazbot login'));
+        rightColumn.push(chalk.white('  plazbot whatsapp setup'));
         rightColumn.push('');
         rightColumn.push(chalk.hex('#4CAF50')('─'.repeat(35)));
         rightColumn.push('');
-        rightColumn.push(chalk.bold.hex('#4CAF50')('Documentation'));
-        rightColumn.push(chalk.gray('  https://docs.plazbot.com'));
+        rightColumn.push(chalk.bold.hex('#4CAF50')('Documentación'));
+        rightColumn.push(chalk.gray('  https://developers.plazbot.com'));
     }
     // Imprimir título
     console.log(title);

package/dist/utils/credentials.js

@@ -3,7 +3,23 @@ import path from 'path';
 import os from 'os';
 const configDir = path.join(os.homedir(), '.plazbot');
 const configPath = path.join(configDir, 'config.json');
+/**
+ * Credenciales desde variables de entorno (CI / servidores):
+ * PLAZBOT_API_KEY + PLAZBOT_WORKSPACE_ID (+ PLAZBOT_ZONE, por defecto LA).
+ * Tienen prioridad sobre ~/.plazbot/config.json.
+ */
+function getEnvCredentials() {
+    const apiKey = process.env.PLAZBOT_API_KEY;
+    const workspace = process.env.PLAZBOT_WORKSPACE_ID;
+    if (!apiKey || !workspace)
+        return null;
+    const zone = (process.env.PLAZBOT_ZONE || 'LA').toUpperCase() === 'EU' ? 'EU' : 'LA';
+    return { apiKey, workspace, zone, source: 'env' };
+}
 export async function getStoredCredentials() {
+    const fromEnv = getEnvCredentials();
+    if (fromEnv)
+        return fromEnv;
     try {
         const configRaw = await fs.readFile(configPath, 'utf-8');
         const config = JSON.parse(configRaw);
@@ -13,13 +29,25 @@ export async function getStoredCredentials() {
         return config;
     }
     catch (error) {
-        throw new Error("No se encontró una sesión activa. Ejecuta 'plazbot init' primero.");
+        throw new Error("No hay una sesión activa. Ejecuta 'plazbot login' para iniciar sesión.");
     }
 }
 export async function saveCredentials(credentials) {
-    await fs.mkdir(configDir, { recursive: true });
-    await fs.writeFile(configPath, JSON.stringify(credentials, null, 2));
+    await fs.mkdir(configDir, { recursive: true, mode: 0o700 });
+    // 0600: el archivo contiene el token de acceso
+    await fs.writeFile(configPath, JSON.stringify(credentials, null, 2), { mode: 0o600 });
+    await fs.chmod(configPath, 0o600).catch(() => { });
 }
 export async function removeCredentials() {
     await fs.rm(configPath, { force: true });
 }
+export function apiBaseUrl(zone, dev = false) {
+    if (dev)
+        return 'http://localhost:5090';
+    return zone === 'EU' ? 'https://apieu.plazbot.com' : 'https://api.plazbot.com';
+}
+export function appBaseUrl(zone, dev = false) {
+    if (dev)
+        return 'http://localhost:5173';
+    return zone === 'EU' ? 'https://appeu.plazbot.com' : 'https://appla.plazbot.com';
+}