Chat Sessions

Get Recent Chat Sessions

get

https://api.dmchamp.com/v1https://us-central1-whatzaidev.cloudfunctions.net/api/v1

/chat-sessions/recent

Retrieve chat sessions from the past X hours across all contacts belonging to the authenticated user. Supports optional filtering by session status and message inclusion.

Authorizations

ApiKeyAuthUserIdAuth

apiKeystringRequired

Your DM Champ API key. Obtain from Settings → API Keys.

Query parameters

apiKeystringOptional

API key for authentication. At least one of apiKey or userId is required for protected endpoints.

Example: your_api_key

userIdstringOptional

User ID for authentication. Alternative to apiKey. At least one of apiKey or userId is required for protected endpoints.

Example: your_user_id

hoursinteger · min: 1Required

Number of hours to look back for recent sessions

Example: 24

statusstring · enumOptional

Filter sessions by status

Possible values:

limitinteger · min: 1Optional

Maximum number of sessions to return

Default: 100

includeMessagesbooleanOptional

Whether to include messages in each session

Default: false

Responses

200

Recent chat sessions retrieved successfully

application/json

successbooleanOptionalExample: true

400

Missing or invalid hours parameter

application/json

401

Authentication required or invalid credentials

application/json

500

Internal server error

application/json

get

/chat-sessions/recent

HTTPcURLJavaScriptPython

GET /v1/chat-sessions/recent?hours=1 HTTP/1.1
Host: api.dmchamp.com
Accept: */*

{
  "success": true,
  "data": {
    "hours_ago": 24,
    "total_sessions": 15,
    "sessions": [
      {
        "session_id": "text",
        "contact_id": "text",
        "contact_name": "text",
        "contact_phone": "text",
        "contact_email": "text",
        "start_date_time": "2026-02-23T21:19:56.707Z",
        "end_date_time": "2026-02-23T21:19:56.707Z",
        "status": "ChatSessionOpened",
        "tag": null,
        "messages": [
          {
            "id": "text",
            "body": "text",
            "direction": "inbound",
            "timestamp": null,
            "type": "text",
            "channel": "text",
            "status": "text"
          }
        ]
      }
    ]
  }
}

Get Chat Sessions for Contact

get

https://api.dmchamp.com/v1https://us-central1-whatzaidev.cloudfunctions.net/api/v1

/chat-sessions/{contactId}

Retrieve all chat sessions for a specific contact. The contact must belong to the authenticated user.

Authorizations

ApiKeyAuthUserIdAuth

apiKeystringRequired

Your DM Champ API key. Obtain from Settings → API Keys.

Path parameters

contactIdstringRequired

Firestore document ID of the contact

Example: abc123xyz

Query parameters

apiKeystringOptional

API key for authentication. At least one of apiKey or userId is required for protected endpoints.

Example: your_api_key

userIdstringOptional

User ID for authentication. Alternative to apiKey. At least one of apiKey or userId is required for protected endpoints.

Example: your_user_id

statusstring · enumOptional

Filter sessions by status

Possible values:

limitinteger · min: 1Optional

Maximum number of sessions to return

Default: 100

includeMessagesbooleanOptional

Whether to include messages in each session

Default: false

Responses

200

Chat sessions retrieved successfully

application/json

successbooleanOptionalExample: true

400

Missing required parameters

application/json

401

Authentication required or invalid credentials

application/json

403

Contact does not belong to authenticated user

application/json

404

Contact not found

application/json

get

/chat-sessions/{contactId}

HTTPcURLJavaScriptPython

GET /v1/chat-sessions/{contactId} HTTP/1.1
Host: api.dmchamp.com
Accept: */*

{
  "success": true,
  "data": {
    "contact_id": "abc123xyz",
    "contact_name": "John Doe",
    "total_sessions": 5,
    "sessions": [
      {
        "id": "text",
        "start_date_time": "2026-02-23T21:19:56.707Z",
        "end_date_time": "2026-02-23T21:19:56.707Z",
        "status": "ChatSessionOpened",
        "tag": null,
        "messages": [
          {
            "id": "text",
            "body": "text",
            "direction": "inbound",
            "timestamp": null,
            "type": "text",
            "channel": "text",
            "status": "text"
          }
        ]
      }
    ]
  }
}