Conversations

import { buildKapsoFields } from '@kapso/whatsapp-cloud-api';

const page = await client.conversations.list({
  phoneNumberId: '123',
  status: 'active',
  lastActiveSince: '2025-01-01T00:00:00Z',
  limit: 20,
  fields: buildKapsoFields([
    'contact_name',
    'messages_count',
    'last_message_id',
    'last_message_type',
    'last_message_timestamp',
    'last_message_text',
    'last_inbound_at',
    'last_outbound_at'
  ])
});

page.data.forEach((c) => {
  console.log(c.id, c.phoneNumber, c.status, c.phoneNumberId);
});

const conv = await client.conversations.get({ conversationId: 'conv-123' });

// Example shape
// {
//   id: 'conv-123',
//   phoneNumber: '+15551234567',
//   status: 'active',
//   lastActiveAt: '2025-01-01T12:00:00Z',
//   phoneNumberId: '123',
//   metadata: {}
// }

await client.conversations.updateStatus({
  conversationId: 'conv-123',
  status: 'ended'
});