Docs menu

Conversations and bookings

Every WhatsApp chat and every phone call is a conversation, and the appointments the employee booked are listed too. This is how your own software reads what the employee did.

GET /conversations

List conversations. Any key, including a read-only key.

Most recent first.

Query parameters

channel
text
whatsapp or voice.
status
text
open, handoff or closed.
limit
integer
How many items, 1 to 100. Default 50.
cursor
text
The nextCursor from the previous page.

Request

curl https://navaprastha.in/api/v1/conversations \
  -H "Authorization: Bearer $NAVAPRASTHA_KEY"

Response

{
  "data": [
    {
      "id": "cv_41a9",
      "channel": "whatsapp",
      "contactPhone": "+919848012345",
      "contactName": "Ravi Kumar",
      "leadId": "9f3c0a1b2c3d4e5f",
      "status": "open",
      "lastMessageAt": 1794139000,
      "createdAt": 1794135000
    }
  ],
  "nextCursor": null
}

GET /conversations/{id}/messages

The messages of one conversation. Any key, including a read-only key.

Oldest first. direction is in or out. sender is customer, agent or human.

Query parameters

limit
integer
How many items, 1 to 100. Default 50.
cursor
text
The nextCursor from the previous page.

Request

curl https://navaprastha.in/api/v1/conversations/ID/messages \
  -H "Authorization: Bearer $NAVAPRASTHA_KEY"

Response

{
  "data": [
    {
      "id": "m_77",
      "direction": "in",
      "sender": "customer",
      "body": "Doctor garu repu untara?",
      "createdAt": 1794135000
    },
    {
      "id": "m_78",
      "direction": "out",
      "sender": "agent",
      "body": "Untaru. 11:00 AM ki slot undi.",
      "createdAt": 1794135004
    }
  ],
  "nextCursor": null
}

GET /appointments

Appointments the employee booked. Any key, including a read-only key.

when is exactly what the person asked for, for example "tomorrow 11:00 AM".

Query parameters

status
text
booked, cancelled or done.
limit
integer
How many items, 1 to 100. Default 50.
cursor
text
The nextCursor from the previous page.

Request

curl https://navaprastha.in/api/v1/appointments \
  -H "Authorization: Bearer $NAVAPRASTHA_KEY"

Response

{
  "data": [
    {
      "id": "ap_5",
      "leadId": "9f3c0a1b2c3d4e5f",
      "name": "Ravi Kumar",
      "phone": "+919848012345",
      "service": "General consultation",
      "when": "tomorrow 11:00 AM",
      "status": "booked",
      "source": "whatsapp",
      "createdAt": 1794135010
    }
  ],
  "nextCursor": null
}

Last updated 13 November 2026. Found something wrong on this page? Email bodavulasiddardha@navaprastha.in and we will correct it.