Get user Inbox | All in One Messenger | shared team inbox

◈ GET — Chats / Leads Listing

Retrieve a paginated list of chats or leads and their metadata for a specific bot. Use the type parameter to switch between leads and non-lead chats.

Overview

Property Details
Method POST
Endpoint https://api.eleapis.com/inbox/direct/chats
Base URL https://api.eleapis.com
API Version v7
Auth Required Yes — x-bot-token
Content-Type application/json

Authentication

Header Required Value
x-bot-token ✅ Yes Your Omnihubs API Token

🔑 Where to get your token: Contact support@tandtglobal.net to obtain your x-bot-token.

Request

Header Required Value
x-bot-token ✅ Yes Your Omnihubs API Token
Content-Type ✅ Yes application/json
Headers
  • Authorization :A bearer token is required for authentication. Replace [MASKED_TOKEN] with your valid API token. This token is used to authenticate and authorize the request.

Request Body

The request body should be a JSON object containing various filtering criteria to customize the query. Here’s a breakdown of the request body fields:

  • searchText (string): Search text to filter users.
  • tags (array): An array of tags to filter users.
  • status (array): An array of status values to filter users.
  • isOnline (boolean): Indicates whether users are online.
  • _botWebsite (array): Filter users based on interactions on the website.
  • _botWhatsapp (array): Filter users based on interactions on WhatsApp.
  • _botTelegram (array): Filter users based on interactions on Telegram.
  • _botFacebook (array): Filter users based on interactions on Facebook.
  • _agentAssigned (array): Filter users assigned to specific agents.
  • segments (array): An array of segments to filter users.
  • applicableFilters (array): An array of applicable filters.
  • lastSeenAt (object): Date range filter for the last seen timestamp.
  • createdAt (object): Date range filter for the creation timestamp.
  • userInteracted (boolean): Indicates whether users have interacted.
  • lastMessageBy (array): Filter users based on the last message sender.
  • isLiveChatActive (boolean): Indicates whether live chat is active for users.
  • hasOrdered (object): Filter users based on their order history.

Sample Request

sample
JavaScript
curl https://api-v7.express-chat.com/inbox/users' \
  -X 'POST' \
  -H 'Authorization: Bearer [MASKED_TOKEN]' \
  -H 'Content-Type: application/json' \
  -d '{
    "searchText": "",
    "tags": [],
    "status": [],
    "isOnline": false,
    "_botWebsite": [],
    "_botWhatsapp": [],
    "_botTelegram": [],
    "_botFacebook": [],
    "_agentAssigned": [],
    "segments": [],
    "applicableFilters": ["userInteracted"],
    "lastSeenAt": {
      "startAt": "",
      "endsAt": ""
    },
    "createdAt": {
      "startAt": "",
      "endsAt": ""
    },
    "userInteracted": true,
    "lastMessageBy": [],
    "isLiveChatActive": false,
    "hasOrdered": {
      "status": false,
      "lastAt": ""
    },
    "page": 1,
    "isExport": "none",
    "isContact": true
  }' \
  --compressed
Replace [MASKED_TOKEN] in the request with your actual API token and customize the request body filters as needed for your use case.

Response

The API will respond with a JSON object containing the user data based on the applied filters. The response format may vary depending on the data available and the applied filters. Please replace [MASKED_TOKEN] in the request with your actual API token for actual usage.