Message Types Overview

interface BaseMessage {
  type: WhatsAppMessageType;  // Message type identifier
  to: string;                 // Recipient phone number (+1234567890)
  context?: {                 // Optional: Reply to another message
    message_id: string;
  };
}

interface MessageResponse {
  messaging_product: 'whatsapp';
  contacts: Array<{
    input: string;            // Phone number sent to
    wa_id: string;           // WhatsApp ID
  }>;
  messages: Array<{
    id: string;              // Unique message ID
    message_status?: string; // Message status
  }>;
}

// Text message
await client.sendText('+1234567890', 'Hello World!');

// Image with caption
await client.sendImage('+1234567890', {
  link: 'https://example.com/image.jpg',
  caption: 'Check out this image!'
});

// Location
await client.sendLocation('+1234567890', 40.7128, -74.0060, {
  name: 'New York City',
  address: 'New York, NY, USA'
});

// Button menu
await client.sendButtons(
  '+1234567890',
  'Choose an option:',
  [
    { id: 'option1', title: 'Option 1' },
    { id: 'option2', title: 'Option 2' },
    { id: 'option3', title: 'Option 3' }
  ]
);

// List menu
await client.sendList(
  '+1234567890',
  'Select a category:',
  'View Options',
  [
    {
      title: 'Main Category',
      rows: [
        { id: 'item1', title: 'Item 1', description: 'First item' },
        { id: 'item2', title: 'Item 2', description: 'Second item' }
      ]
    }
  ]
);

// Upload and send
const mediaResponse = await client.uploadMedia(fileBuffer, 'image');
await client.sendImage('+1234567890', {
  id: mediaResponse.id,
  caption: 'Uploaded image'
});

// Send from URL
await client.sendDocument('+1234567890', {
  link: 'https://example.com/document.pdf',
  filename: 'important-document.pdf'
});

await client.sendTemplate(
  '+1234567890',
  'hello_world',
  'en_US',
  [
    {
      type: 'body',
      parameters: [
        { type: 'text', text: 'John' }
      ]
    }
  ]
);

// ✅ Good: Choose appropriate message type
// For simple confirmations
await client.sendText(to, 'Your order has been confirmed!');

// For choices
await client.sendButtons(to, 'Rate your experience:', [
  { id: 'excellent', title: '⭐⭐⭐⭐⭐' },
  { id: 'good', title: '⭐⭐⭐⭐' },
  { id: 'poor', title: '⭐⭐' }
]);

// For file sharing
await client.sendDocument(to, {
  link: documentUrl,
  filename: 'invoice.pdf',
  caption: 'Your invoice is attached'
});

// ✅ Good: Optimize content for mobile
await client.sendText(
  to,
  'Order Update 📦\n\n' +
  '• Status: Shipped\n' +
  '• Tracking: 123456789\n' +
  '• ETA: Tomorrow 2-4 PM\n\n' +
  'Track: https://track.example.com/123456789'
);

try {
  const response = await client.sendImage(to, { link: imageUrl });
  console.log('Message sent:', response.messages[0].id);
} catch (error) {
  if (error instanceof MessageValidationError) {
    console.error('Invalid message:', error.field);
  } else if (error instanceof MediaProcessingError) {
    console.error('Media error:', error.message);
  }
}

// Send related messages in sequence
async function sendOrderConfirmation(to: string, order: Order) {
  // 1. Confirmation text
  await client.sendText(to, `Order #${order.id} confirmed! 🎉`);
  
  // 2. Order details document
  await client.sendDocument(to, {
    link: order.invoiceUrl,
    filename: `invoice-${order.id}.pdf`,
    caption: 'Your order invoice'
  });
  
  // 3. Tracking options
  await client.sendButtons(to, 'What would you like to do?', [
    { id: 'track', title: '📦 Track Order' },
    { id: 'support', title: '💬 Contact Support' },
    { id: 'receipt', title: '📧 Email Receipt' }
  ]);
}