WhatsApp Channel Setup

# ~/.orcbot/orcbot.config.yaml

# Enable WhatsApp channel
whatsappEnabled: true

# Session storage path
whatsappSessionPath: ~/.orcbot/whatsapp-session

# Auto-reply to incoming messages
whatsappAutoReplyEnabled: true

# Reply to WhatsApp Status updates
whatsappStatusReplyEnabled: false

# Auto-react with emojis to messages
whatsappAutoReactEnabled: false

# Context profiling for better responses
whatsappContextProfilingEnabled: true

# Owner JID (auto-populated on first connection)
whatsappOwnerJID: "1234567890@s.whatsapp.net"

// Send an image
send_file(
  to: "1234567890@s.whatsapp.net",
  filePath: "/path/to/chart.png",
  caption: "Here's the sales chart you requested",
  channel: "whatsapp"
)

// Send a document
send_file(
  to: "1234567890@s.whatsapp.net",
  filePath: "/path/to/report.pdf",
  caption: "Monthly report attached",
  channel: "whatsapp"
)

send_voice_note(
  to: "1234567890@s.whatsapp.net",
  text: "Hello! This is a voice message from OrcBot."
)

this.sock.ev.on('contacts.set', (payload: any) => {
  const contacts = payload?.contacts || [];
  this.recordContacts(contacts);
  logger.info(`WhatsApp: Contacts set (${contacts.length})`);
});

// From a custom skill
const results = whatsappChannel.searchContacts('John');
// Returns: [{ jid: '1234567890@s.whatsapp.net', name: 'John Doe' }]

const contacts = whatsappChannel.getRecentContacts();
contacts.forEach(c => {
  console.log(`${c.name}: ${c.jid}`);
});

// When user replies to a message
if (contextInfo?.quotedMessage) {
  const quotedText = contextInfo.quotedMessage.conversation || '[Media]';
  const quotedName = contextInfo.participant.split('@')[0];
  
  replyContext = `[Replying to ${quotedName}'s message: "${quotedText}"]`;
}

Alice: "What's the weather?"
You:   [Reply to Alice] "@bot answer this"

Bot:   "Based on Alice's question about weather..."
       [Reply includes context from Alice's original message]

whatsappAutoReplyEnabled: true  # Reply to all group messages

whatsappAutoReplyEnabled: false  # Only reply when mentioned

const isGroup = senderId?.endsWith('@g.us');

if (isGroup) {
  // Special handling for group messages
  const groupName = await getGroupMetadata(senderId);
}

whatsappStatusReplyEnabled: true

const isStatus = senderId === 'status@broadcast';

if (isStatus && this.statusReplyEnabled) {
  // Process status update
  const contentType = this.detectStatusContentType(message);
  const participant = msg.key.participant;
}

~/.orcbot/whatsapp-session/
  ├── creds.json          # Authentication credentials
  ├── app-state-sync-key-*.json  # Sync keys
  └── app-state-sync-version-*.json

# Stop OrcBot first
orcbot daemon stop

# Backup session
cp -r ~/.orcbot/whatsapp-session ~/.orcbot/whatsapp-session.backup

# Restart
orcbot run

orcbot daemon stop
rm -rf ~/.orcbot/whatsapp-session
cp -r ~/.orcbot/whatsapp-session.backup ~/.orcbot/whatsapp-session
orcbot run

this.sock.ev.on('connection.update', (update: any) => {
  const { connection, lastDisconnect } = update;

  if (connection === 'close') {
    const shouldReconnect = 
      lastDisconnect?.error?.output?.statusCode !== DisconnectReason.loggedOut;
    
    if (shouldReconnect) {
      logger.warn('WhatsApp: Connection closed. Reconnecting...');
      this.start();  // Auto-reconnect
    }
  }
});

whatsappContextProfilingEnabled: true

whatsappAutoReactEnabled: true

private readonly AGENT_MESSAGE_PREFIX = '🤖 ';

// Bot messages: "🤖 Your reminder has been set."
// Your messages: "Set a reminder for 3 PM"

// Priority: WhatsApp → Discord → Telegram
if (to.includes('@s.whatsapp.net') || to.includes('@g.us')) {
  return whatsappChannel.sendMessage(to, message);
} else if (to.match(/^\d{17,19}$/)) {
  return discordChannel.sendMessage(to, message);
} else {
  return telegramChannel.sendMessage(to, message);
}

# Check if socket is connected
grep "Connection opened" ~/.orcbot/logs/orcbot.log

# Check message event listeners
grep "messages.upsert" ~/.orcbot/logs/orcbot.log

// Check download directory
const downloadsDir = path.join(this.agent.config.getDataHome(), 'downloads');
if (!fs.existsSync(downloadsDir)) {
  fs.mkdirSync(downloadsDir, { recursive: true });
}

rm -rf ~/.orcbot/whatsapp-session
orcbot run
# Scan new QR code

You: "Remind me to call mom at 6 PM"
Bot: "🤖 ✅ Reminder set for today at 6:00 PM: Call mom"

[At 6 PM]
Bot: "🤖 ⏰ Reminder: Call mom"

You: [sends PDF invoice]
     "Extract the total amount and due date"

Bot: "🤖 Analyzing document...
      
      Total Amount: $1,234.56
      Due Date: March 15, 2024
      Invoice #: INV-2024-001"

Family Group:

Alice: "What time is dinner?"
Bob:   "Where are we meeting?"

@OrcBot: "Summarize the last 10 messages"

Bot:   "🤖 Recent discussion:
        - Alice asked about dinner time
        - Bob asked about meeting location
        - Mom suggested 7 PM at home
        - Dad confirmed he'll bring dessert"