List messages in a WhatsApp conversation

curl --request GET \
  --url https://api.dialtu.com/api/v2/public/whatsapp/conversations/{session_id}/messages \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.dialtu.com/api/v2/public/whatsapp/conversations/{session_id}/messages"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.dialtu.com/api/v2/public/whatsapp/conversations/{session_id}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": 123,
      "sender_type": "<string>",
      "sender": {
        "type": "<string>",
        "id": 123,
        "name": "<string>",
        "email": "<string>"
      },
      "message_type": "<string>",
      "content": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "media": {
        "kind": "<string>",
        "mime": "<string>",
        "filename": "<string>",
        "caption": "<string>"
      },
      "reply_to_id": 123
    }
  ],
  "count": 123,
  "limit": 123,
  "offset": 123,
  "status": "success",
  "participants": {
    "ai_agents": [
      {
        "id": 123,
        "name": "<string>",
        "message_count": 0,
        "first_message_at": "2023-11-07T05:31:56Z",
        "last_message_at": "2023-11-07T05:31:56Z"
      }
    ],
    "users": [
      {
        "id": 123,
        "name": "<string>",
        "email": "<string>",
        "message_count": 0,
        "first_message_at": "2023-11-07T05:31:56Z",
        "last_message_at": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

WhatsApp

List messages in a WhatsApp conversation

Paginated transcript for a single conversation, oldest-first.

Use it to fetch the rest of a conversation that List WhatsApp conversations truncated (has_more_messages=true). Tool-execution rows are excluded; media exposes metadata only. Each message names its sender in sender, and participants returns the conversation’s full roster (not just this page’s).

Returns 404 {"detail": "..."} when the conversation does not exist in your workspace.

GET

/

api

/

v2

/

public

/

whatsapp

/

conversations

/

{session_id}

/

messages

List messages in a WhatsApp conversation

curl --request GET \
  --url https://api.dialtu.com/api/v2/public/whatsapp/conversations/{session_id}/messages \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.dialtu.com/api/v2/public/whatsapp/conversations/{session_id}/messages"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.dialtu.com/api/v2/public/whatsapp/conversations/{session_id}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": 123,
      "sender_type": "<string>",
      "sender": {
        "type": "<string>",
        "id": 123,
        "name": "<string>",
        "email": "<string>"
      },
      "message_type": "<string>",
      "content": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "media": {
        "kind": "<string>",
        "mime": "<string>",
        "filename": "<string>",
        "caption": "<string>"
      },
      "reply_to_id": 123
    }
  ],
  "count": 123,
  "limit": 123,
  "offset": 123,
  "status": "success",
  "participants": {
    "ai_agents": [
      {
        "id": 123,
        "name": "<string>",
        "message_count": 0,
        "first_message_at": "2023-11-07T05:31:56Z",
        "last_message_at": "2023-11-07T05:31:56Z"
      }
    ],
    "users": [
      {
        "id": 123,
        "name": "<string>",
        "email": "<string>",
        "message_count": 0,
        "first_message_at": "2023-11-07T05:31:56Z",
        "last_message_at": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

API key created in the dashboard under Settings → API Keys. Send it as Authorization: Bearer pk_....

Path Parameters

session_id

integer

required

Conversation (session) ID, as returned by List WhatsApp conversations.

Query Parameters

limit

integer

default:50

Page size (1–500).

Required range: 1 <= x <= 500

offset

integer

default:0

Number of messages to skip, oldest-first.

Required range: x >= 0

Response

OK

Paginated transcript for a single session (overflow drill-down).

data

PublicWhatsAppMessageSchema · object[]

required

Messages on this page, oldest-first.

Show child attributes

count

integer

required

Total conversational messages in the session.

limit

integer

required

Page size that was applied.

offset

integer

required

Offset that was applied.

status

string

default:success

Always success.

Allowed value: "success"

participants

PublicWhatsAppParticipantsSchema · object

The conversation's participant roster. Describes the whole conversation, not just the returned page.

Show child attributes