plazbot-cli 0.2.25 → 0.3.1

package/src/commands/whatsapp/connect.ts

@@ -2,9 +2,10 @@ import { Command } from 'commander';
 import axios from 'axios';
 import ora from 'ora';
 import chalk from 'chalk';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { theme, section } from '../../utils/ui';
+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: string, dev: boolean): string {
   if (dev) return 'http://localhost:5090';
@@ -44,9 +45,9 @@ async function activateIntegration(baseUrl: string, workspaceId: string, integra
 }
 
 export const whatsappConnectCommand = new Command('connect')
-  .description('Conectar un numero de WhatsApp al workspace (sin crear agente)')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
-  .option('--business', 'Conectar como WhatsApp Business', false)
+  .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)
   .action(async (options: any) => {
     try {
       const credentials = await getStoredCredentials();
@@ -60,20 +61,20 @@ export const whatsappConnectCommand = new Command('connect')
       const channelType = options.business ? 'whatsapp_business' : 'whatsapp';
       const channelLabel = options.business ? 'WhatsApp Business' : 'WhatsApp';
 
-      console.log(section(`Conectar ${channelLabel}`));
+      console.log(section(`Connect ${channelLabel}`));
       console.log();
 
       // Cargar integraciones existentes
-      const loadSpinner = ora({ text: chalk.gray('Cargando integraciones existentes...'), spinner: 'dots', color: 'green' }).start();
+      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: any) => ig.type === 'whatsapp');
       loadSpinner.stop();
 
       if (existing.length > 0) {
-        console.log(theme.muted(`  ${existing.length} numero(s) ya conectado(s):`));
+        console.log(theme.muted(`  ${existing.length} number(s) already connected:`));
         existing.forEach((ig: any) => {
           const label = getIntegrationLabel(ig);
-          const status = ig.isActive ? chalk.hex('#66BB6A')('activo') : chalk.hex('#EF5350')('inactivo');
+          const status = ig.isActive ? chalk.hex('#66BB6A')('active') : chalk.hex('#EF5350')('inactive');
           console.log(`    ${theme.muted('•')} ${label}  ${status}`);
         });
         console.log();
@@ -81,7 +82,7 @@ export const whatsappConnectCommand = new Command('connect')
 
       // 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('Obteniendo link de conexion...'), spinner: 'dots', color: 'green' }).start();
+      const spinner = ora({ text: chalk.gray('Fetching connection link...'), spinner: 'dots', color: 'green' }).start();
 
       let linkData: any = null;
 
@@ -125,32 +126,36 @@ export const whatsappConnectCommand = new Command('connect')
       }
 
       if (!linkData?.token) {
-        spinner.fail(chalk.hex('#EF5350')('No se pudo obtener el link de conexion'));
+        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('es-ES', { day: 'numeric', month: 'long', year: 'numeric' }) : '';
+      const expiresAt = linkData.expiresAt ? new Date(linkData.expiresAt).toLocaleDateString('en-US', { day: 'numeric', month: 'long', year: 'numeric' }) : '';
       spinner.stop();
 
       // Mostrar link
-      console.log(chalk.hex('#25D366')('  ┌' + '─'.repeat(54) + '┐'));
-      console.log(chalk.hex('#25D366')('  │') + chalk.bold(`  Abre este link en tu navegador:`).padEnd(64) + chalk.hex('#25D366')('│'));
-      console.log(chalk.hex('#25D366')('  │') + ''.padEnd(54) + chalk.hex('#25D366')('│'));
-      console.log(chalk.hex('#25D366')('  │') + chalk.hex('#22d3ee')(`  ${shortUrl}`).padEnd(64) + chalk.hex('#25D366')('│'));
-      console.log(chalk.hex('#25D366')('  │') + ''.padEnd(54) + chalk.hex('#25D366')('│'));
-      console.log(chalk.hex('#25D366')('  │') + chalk.gray('  Escanea el codigo QR desde tu WhatsApp').padEnd(64) + chalk.hex('#25D366')('│'));
+      const W = 54;
+      const pad = (text: string) => 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(chalk.hex('#25D366')('  │') + chalk.gray(`  Expira: ${expiresAt}`).padEnd(64) + chalk.hex('#25D366')('│'));
+        console.log(border('  │') + chalk.gray(pad(`  Expires: ${expiresAt}`)) + border('│'));
       }
-      console.log(chalk.hex('#25D366')('  └' + '─'.repeat(54) + '┘'));
+      console.log(border('  └' + '─'.repeat(W) + '┘'));
       console.log();
 
       // Guardar IDs actuales para detectar nuevos
       const prevIds = new Set(allIntegrations.map((i: any) => i.id));
 
       // Polling para detectar nueva integracion
-      const pollSpinner = ora({ text: chalk.gray('Esperando conexion... (Ctrl+C para cancelar)'), spinner: 'dots', color: 'cyan' }).start();
+      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: any = null;
@@ -169,40 +174,47 @@ export const whatsappConnectCommand = new Command('connect')
         } catch {}
 
         const elapsed = Math.floor(((i + 1) * POLL_INTERVAL) / 1000);
-        pollSpinner.text = chalk.gray(`Esperando conexion... ${elapsed}s (Ctrl+C para cancelar)`);
+        pollSpinner.text = chalk.gray(`Waiting for connection... ${elapsed}s (Ctrl+C to cancel)`);
       }
 
       if (detected) {
         const detectedName = getIntegrationLabel(detected);
-        pollSpinner.succeed(chalk.hex('#4ade80')(`Conexion detectada: ${detectedName}`));
+        pollSpinner.succeed(chalk.hex('#4ade80')(`Connection detected: ${detectedName}`));
 
         // Activar la integracion
-        const actSpinner = ora({ text: chalk.gray('Activando integracion...'), spinner: 'dots', color: 'green' }).start();
+        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')('Integracion activada correctamente'));
+          actSpinner.succeed(chalk.hex('#4ade80')('Integration activated successfully'));
         } else {
-          actSpinner.warn(chalk.hex('#FFA726')('No se pudo activar automaticamente. Activala desde la plataforma.'));
+          actSpinner.warn(chalk.hex('#FFA726')('Could not activate automatically. Activate it from the platform.'));
         }
 
         console.log();
-        console.log(theme.success('  WhatsApp conectado exitosamente'));
-        console.log(theme.muted(`  Numero: ${detectedName}`));
+        console.log(theme.success('  WhatsApp connected successfully'));
+        console.log(theme.muted(`  Number: ${detectedName}`));
         console.log();
-        console.log(theme.muted('  Ahora puedes:'));
-        console.log(theme.muted('    plazbot whatsapp send-message    Enviar un mensaje'));
-        console.log(theme.muted('    plazbot whatsapp chat <phone>    Chat interactivo'));
-        console.log(theme.muted('    plazbot whatsapp assign <phone> <agentId>  Asignar a un agente'));
+        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();
       } else {
-        pollSpinner.warn(chalk.hex('#FFA726')('Timeout: no se detecto conexion en 5 minutos.'));
-        console.log(theme.muted('  Puedes volver a intentar con: plazbot whatsapp connect'));
+        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();
       }
 
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido';
+      const message = error instanceof Error ? error.message : 'Unknown error';
       logger.error(message);
       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' },
+]);

package/src/commands/whatsapp/delete-webhook.ts

@@ -1,7 +1,8 @@
 import { Command } from 'commander';
 import { Message } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
+import { getStoredCredentials } from '../../utils/credentials.js';
+import { logger } from '../../utils/logger.js';
+import { addExamples } from '../../utils/help.js';
 
 interface DeleteWebhookOptions {
   dev?: boolean;
@@ -9,9 +10,9 @@ interface DeleteWebhookOptions {
 }
 
 export const deleteWebhookCommand = new Command('delete-webhook')
-  .description('Elimina el webhook de WhatsApp')
-  .requiredOption('-n, --number <phone>', 'Número de WhatsApp (con código de país, ej: 51912345678)')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .description('Delete the WhatsApp webhook')
+  .requiredOption('-n, --number <phone>', 'WhatsApp number (with country code, e.g.: 51912345678)')
+  .option('--dev', 'Use development environment', false)
   .action(async (options: DeleteWebhookOptions) => {
     try {
       const credentials = await getStoredCredentials();
@@ -22,16 +23,21 @@ export const deleteWebhookCommand = new Command('delete-webhook')
         ...(options.dev && { customUrl: "http://localhost:5090" })
       });
 
-      logger.title('Eliminando webhook de WhatsApp');
-      logger.label('Numero', options.number);
+      logger.title('Deleting WhatsApp webhook');
+      logger.label('Number', options.number);
 
       await messageClient.deleteWebhook({
         number: options.number
       });
 
-      logger.success('Webhook eliminado exitosamente');
+      logger.success('Webhook deleted successfully');
     } catch (error: unknown) {
       logger.error((error as Error).message);
       process.exit(1);
     }
-  }); 
+  });
+
+addExamples(deleteWebhookCommand, [
+  { description: 'Remove the webhook from a WhatsApp number',
+    command: 'plazbot whatsapp delete-webhook -n 51912345678' },
+]);

package/src/commands/whatsapp/index.ts

@@ -1,16 +1,17 @@
 import { Command } from 'commander';
-import { sendMessageCommand } from './send';
-import { sendTemplateCommand } from './send-template';
-import { registerWebhookCommand } from './register-webhook';
-import { deleteWebhookCommand } from './delete-webhook';
-import { broadcastCommand } from './broadcast';
-import { whatsappChatCommand } from './chat';
-import { whatsappConnectCommand } from './connect';
-import { widgetCommand } from './widget';
-import { channelsCommand, assignCommand } from './channels';
+import { addExamples } from '../../utils/help.js';
+import { sendMessageCommand } from './send.js';
+import { sendTemplateCommand } from './send-template.js';
+import { registerWebhookCommand } from './register-webhook.js';
+import { deleteWebhookCommand } from './delete-webhook.js';
+import { broadcastCommand } from './broadcast.js';
+import { whatsappChatCommand } from './chat.js';
+import { whatsappConnectCommand } from './connect.js';
+import { widgetCommand } from './widget.js';
+import { channelsCommand, assignCommand } from './channels.js';
 
 export const whatsappCommands = new Command('whatsapp')
-  .description('Comandos de WhatsApp: mensajes, templates, broadcast y mas')
+  .description('WhatsApp commands: messages, templates, broadcast and more')
   .addCommand(whatsappConnectCommand)
   .addCommand(sendMessageCommand)
   .addCommand(sendTemplateCommand)
@@ -21,3 +22,16 @@ export const whatsappCommands = new Command('whatsapp')
   .addCommand(widgetCommand)
   .addCommand(channelsCommand)
   .addCommand(assignCommand);
+
+addExamples(whatsappCommands, [
+  { description: 'Connect a WhatsApp number to the workspace',
+    command: 'plazbot whatsapp connect' },
+  { description: 'Send a quick message',
+    command: 'plazbot whatsapp send-message -t 51912345678 -m "Hello"' },
+  { description: 'Send a template with variables',
+    command: 'plazbot whatsapp send-template -p 51912345678 -t welcome --var name=Anna' },
+  { description: 'Open an interactive chat',
+    command: 'plazbot whatsapp chat 51912345678' },
+  { description: 'Assign a number to an agent',
+    command: 'plazbot whatsapp assign 51912345678 agt_AbcDef123' },
+]);

package/src/commands/whatsapp/register-webhook.ts

@@ -1,7 +1,8 @@
 import { Command } from 'commander';
 import { Message } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
+import { getStoredCredentials } from '../../utils/credentials.js';
+import { logger } from '../../utils/logger.js';
+import { addExamples } from '../../utils/help.js';
 
 interface RegisterWebhookOptions {
   dev?: boolean;
@@ -10,10 +11,10 @@ interface RegisterWebhookOptions {
 }
 
 export const registerWebhookCommand = new Command('register-webhook')
-  .description('Registra un webhook para WhatsApp')
-  .requiredOption('-n, --number <phone>', 'Número de WhatsApp (con código de país, ej: 51912345678)')
-  .requiredOption('-u, --url <webhook>', 'URL del webhook')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .description('Register a webhook for WhatsApp')
+  .requiredOption('-n, --number <phone>', 'WhatsApp number (with country code, e.g.: 51912345678)')
+  .requiredOption('-u, --url <webhook>', 'Webhook URL')
+  .option('--dev', 'Use development environment', false)
   .action(async (options: RegisterWebhookOptions) => {
     try {
       const credentials = await getStoredCredentials();
@@ -24,8 +25,8 @@ export const registerWebhookCommand = new Command('register-webhook')
         ...(options.dev && { customUrl: "http://localhost:5090" })
       });
 
-      logger.title('Registrando webhook de WhatsApp');
-      logger.label('Numero', options.number);
+      logger.title('Registering WhatsApp webhook');
+      logger.label('Number', options.number);
       logger.label('URL', options.url);
 
       await messageClient.registerWebhook({
@@ -33,9 +34,14 @@ export const registerWebhookCommand = new Command('register-webhook')
         webhookUrl: options.url
       });
 
-      logger.success('Webhook registrado exitosamente');
+      logger.success('Webhook registered successfully');
     } catch (error: unknown) {
       logger.error((error as Error).message);
       process.exit(1);
     }
-  }); 
+  });
+
+addExamples(registerWebhookCommand, [
+  { description: 'Register an inbound webhook for a WhatsApp number',
+    command: 'plazbot whatsapp register-webhook -n 51912345678 -u https://api.example.com/webhooks/whatsapp' },
+]);

package/src/commands/whatsapp/send-template.ts

@@ -1,18 +1,19 @@
 import { Command } from 'commander';
 import { Message } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { createSpinner } from '../../utils/ui';
+import { getStoredCredentials } from '../../utils/credentials.js';
+import { logger } from '../../utils/logger.js';
+import { addExamples } from '../../utils/help.js';
+import { createSpinner } from '../../utils/ui.js';
 
 export const sendTemplateCommand = new Command('send-template')
-  .description('Envia un mensaje de template de WhatsApp con variables')
-  .requiredOption('-p, --phone <number>', 'Numero de telefono (con codigo de pais)')
-  .requiredOption('-t, --template <name>', 'Nombre del template')
-  .option('--var <vars...>', 'Variables del body (formato: name=valor)')
-  .option('--header-var <vars...>', 'Variables del header (formato: name=valor)')
-  .option('--file-url <url>', 'URL del archivo adjunto')
-  .option('--file-name <name>', 'Nombre del archivo adjunto')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .description('Send a WhatsApp template message with variables')
+  .requiredOption('-p, --phone <number>', 'Phone number (with country code)')
+  .requiredOption('-t, --template <name>', 'Template name')
+  .option('--var <vars...>', 'Body variables (format: name=value)')
+  .option('--header-var <vars...>', 'Header variables (format: name=value)')
+  .option('--file-url <url>', 'Attachment file URL')
+  .option('--file-name <name>', 'Attachment file name')
+  .option('--dev', 'Use development environment', false)
   .action(async (options: any) => {
     try {
       const credentials = await getStoredCredentials();
@@ -31,23 +32,23 @@ export const sendTemplateCommand = new Command('send-template')
       // Archivo adjunto
       const file = options.fileUrl ? {
         fileUrl: options.fileUrl,
-        fileName: options.fileName || 'archivo',
+        fileName: options.fileName || 'file',
       } : undefined;
 
-      logger.title('Enviando template WhatsApp');
-      logger.label('Destino', options.phone);
+      logger.title('Sending WhatsApp template');
+      logger.label('Destination', options.phone);
       logger.label('Template', options.template);
       if (variablesBody.length > 0) {
-        logger.label('Variables body', variablesBody.map(v => `${v.variable}=${v.value}`).join(', '));
+        logger.label('Body variables', variablesBody.map(v => `${v.variable}=${v.value}`).join(', '));
       }
       if (variablesHeader.length > 0) {
-        logger.label('Variables header', variablesHeader.map(v => `${v.variable}=${v.value}`).join(', '));
+        logger.label('Header variables', variablesHeader.map(v => `${v.variable}=${v.value}`).join(', '));
       }
       if (file) {
-        logger.label('Archivo', file.fileUrl);
+        logger.label('File', file.fileUrl);
       }
 
-      const spinner = createSpinner('Enviando...');
+      const spinner = createSpinner('Sending...');
       spinner.start();
 
       const params: any = {
@@ -60,19 +61,30 @@ export const sendTemplateCommand = new Command('send-template')
 
       const response = await messageClient.onConversation(params);
 
-      spinner.succeed('Template enviado exitosamente');
+      spinner.succeed('Template sent successfully');
 
       if (options.dev) {
-        logger.warning('Ambiente: desarrollo');
+        logger.warning('Environment: development');
       }
 
     } catch (error: unknown) {
-      const message = (error as Error)?.message || 'Error desconocido al enviar el template';
+      const message = (error as Error)?.message || 'Unknown error while sending the template';
       logger.error(message);
       process.exit(1);
     }
   });
 
+addExamples(sendTemplateCommand, [
+  { description: 'Send a template with no variables',
+    command: 'plazbot whatsapp send-template -p 51912345678 -t welcome_message' },
+  { description: 'Send a template with body variables',
+    command: 'plazbot whatsapp send-template -p 51912345678 -t order_status --var name=Anna code=PB-123' },
+  { description: 'Send a template with an attached PDF',
+    command: 'plazbot whatsapp send-template -p 51912345678 -t invoice_template --file-url https://files.example.com/inv.pdf --file-name invoice.pdf' },
+  { description: 'Send a template with header and body variables',
+    command: 'plazbot whatsapp send-template -p 51912345678 -t promo --header-var image=https://img.example.com/banner.png --var amount=20' },
+]);
+
 function parseVariables(vars: string[] | undefined): { variable: string; value: string }[] {
   if (!vars) return [];
   return vars.map(v => {

package/src/commands/whatsapp/send.ts

@@ -1,15 +1,16 @@
 import { Command } from 'commander';
 import { Message } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { DirectMessageCommandOptions } from '../../types/message';
-import { createSpinner } from '../../utils/ui';
+import { getStoredCredentials } from '../../utils/credentials.js';
+import { logger } from '../../utils/logger.js';
+import { addExamples } from '../../utils/help.js';
+import { DirectMessageCommandOptions } from '../../types/message.js';
+import { createSpinner } from '../../utils/ui.js';
 
 export const sendMessageCommand = new Command('send-message')
-  .description('Envia un mensaje directo de WhatsApp')
-  .requiredOption('-t, --to <phone>', 'Numero de telefono (con codigo de pais, ej: 51912345678)')
-  .requiredOption('-m, --message <text>', 'Mensaje a enviar')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .description('Send a direct WhatsApp message')
+  .requiredOption('-t, --to <phone>', 'Phone number (with country code, e.g.: 51912345678)')
+  .requiredOption('-m, --message <text>', 'Message to send')
+  .option('--dev', 'Use development environment', false)
   .action(async (options: DirectMessageCommandOptions) => {
     try {
       const credentials = await getStoredCredentials();
@@ -21,11 +22,11 @@ export const sendMessageCommand = new Command('send-message')
         ...(options.dev && { customUrl: "http://localhost:5090" })
       });
 
-      logger.title('Enviando mensaje WhatsApp');
-      logger.label('Destino', options.to);
-      logger.label('Mensaje', options.message);
+      logger.title('Sending WhatsApp message');
+      logger.label('Destination', options.to);
+      logger.label('Message', options.message);
 
-      const spinner = createSpinner('Enviando...');
+      const spinner = createSpinner('Sending...');
       spinner.start();
 
       const response = await messageClient.onWhatsappMessage({
@@ -33,15 +34,22 @@ export const sendMessageCommand = new Command('send-message')
         to: options.to
       });
 
-      spinner.succeed('Mensaje enviado exitosamente');
+      spinner.succeed('Message sent successfully');
 
       if (options.dev) {
-        logger.warning('Ambiente: desarrollo');
+        logger.warning('Environment: development');
       }
 
     } catch (error: unknown) {
-      const message = (error as Error)?.message || 'Error desconocido al enviar el mensaje';
+      const message = (error as Error)?.message || 'Unknown error while sending the message';
       logger.error(message);
       process.exit(1);
     }
   });
+
+addExamples(sendMessageCommand, [
+  { description: 'Send a quick WhatsApp message',
+    command: 'plazbot whatsapp send-message -t 51912345678 -m "Hello from Plazbot"' },
+  { description: 'Send through the development backend',
+    command: 'plazbot whatsapp send-message -t 51912345678 -m "Hi" --dev' },
+]);

package/src/commands/whatsapp/widget.ts

@@ -1,17 +1,25 @@
 import { Command } from 'commander';
 import { Agent } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { createSpinner } from '../../utils/ui';
+import { getStoredCredentials } from '../../utils/credentials.js';
+import { logger } from '../../utils/logger.js';
+import { addExamples } from '../../utils/help.js';
+import { createSpinner } from '../../utils/ui.js';
 
 const widgetGroup = new Command('widget')
-  .description('Gestionar widget de WhatsApp');
+  .description('Manage WhatsApp widget');
+
+addExamples(widgetGroup, [
+  { description: 'Enable the WhatsApp click-to-chat widget on an agent',
+    command: 'plazbot whatsapp widget enable agt_AbcDef123 -u https://wa.me/51912345678' },
+  { description: 'Disable the widget',
+    command: 'plazbot whatsapp widget disable agt_AbcDef123' },
+]);
 
 widgetGroup.command('enable')
-  .description('Activar widget de WhatsApp en un agente')
-  .argument('<agentId>', 'ID del agente')
-  .requiredOption('-u, --url <url>', 'URL de WhatsApp (ej: https://wa.me/51912345678)')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .description('Enable the WhatsApp widget on an agent')
+  .argument('<agentId>', 'Agent ID')
+  .requiredOption('-u, --url <url>', 'WhatsApp URL (e.g.: https://wa.me/51912345678)')
+  .option('--dev', 'Use development environment', false)
   .action(async (agentId: string, options: any) => {
     try {
       const credentials = await getStoredCredentials();
@@ -22,26 +30,26 @@ widgetGroup.command('enable')
         ...(options.dev && { customUrl: "http://localhost:5090" })
       });
 
-      const spinner = createSpinner('Activando widget WhatsApp...');
+      const spinner = createSpinner('Enabling WhatsApp widget...');
       spinner.start();
       await agent.updateAgent(agentId, {
         enableWhatsappWidget: true,
         urlWhatsappWidget: options.url,
       });
-      spinner.succeed('Widget WhatsApp activado');
+      spinner.succeed('WhatsApp widget enabled');
       logger.label('URL', options.url);
 
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido';
+      const message = error instanceof Error ? error.message : 'Unknown error';
       logger.error(message);
       process.exit(1);
     }
   });
 
 widgetGroup.command('disable')
-  .description('Desactivar widget de WhatsApp de un agente')
-  .argument('<agentId>', 'ID del agente')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .description('Disable the WhatsApp widget on an agent')
+  .argument('<agentId>', 'Agent ID')
+  .option('--dev', 'Use development environment', false)
   .action(async (agentId: string, options: any) => {
     try {
       const credentials = await getStoredCredentials();
@@ -52,13 +60,13 @@ widgetGroup.command('disable')
         ...(options.dev && { customUrl: "http://localhost:5090" })
       });
 
-      const spinner = createSpinner('Desactivando widget WhatsApp...');
+      const spinner = createSpinner('Disabling WhatsApp widget...');
       spinner.start();
       await agent.updateAgent(agentId, { enableWhatsappWidget: false });
-      spinner.succeed('Widget WhatsApp desactivado');
+      spinner.succeed('WhatsApp widget disabled');
 
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido';
+      const message = error instanceof Error ? error.message : 'Unknown error';
       logger.error(message);
       process.exit(1);
     }