📄Contacts & Chats APIs
The Contacts & Chats APIs allow you to programmatically manage contacts, retrieve chat and lead data, update user statuses, and modify chat records from any external system or integration.
Before You Begin
- Base URL:
https://api.eleapis.com/ - All requests must include the following headers:
| Header | Required | Value |
|---|---|---|
| Authorization | ✅ Yes | Bearer [MASKED_TOKEN] |
| authtype | ✅ Yes | Key |
| Content-Type | ✅ Yes | application/json |
Available APIs
| Method | API | Endpoint | Description |
|---|---|---|---|
| GET | Segments / Groups | /inbox/segments | Retrieve all segments and groups configured for your account |
| GET | Chats / Leads Listing | /inbox/direct/chats | Fetch paginated chat and lead records for a specific bot |
| POST | Add WhatsApp Contact | /inbox/users/import | Import one or more contacts into your account |
| POST | Get User Inbox | /inbox/users | Retrieve filtered and paginated contact records from your inbox |
| PUT | Update User Status | /inbox/users/status-update | Update the status of one or more contacts by User ID |
| PUT | Update Chat / Lead Data | /inbox/direct/lead | Update profile, tags, attributes, and status of a specific chat or lead |
FAQs
What is the difference between a segment and a group?
Segments and groups refer to the same entity in this API. The endpoint /inbox/segments returns objects with a segmentName field — these are the same records you see listed under Inbox → Groups in the Customer Panel. The terms are used interchangeably across the platform.
The GET — Chats / Leads Listing uses a different auth header. Why?
All six endpoints in this section use the same authentication method:
Authorization: Bearer YOUR_API_TOKEN
with authtype: Key.
Refer to the Before You Begin section above for the exact headers to pass.
What is the difference between GET — Chats / Leads Listing and POST — Get User Inbox?
These two endpoints serve different purposes:
GET — Chats / Leads Listing (/inbox/direct/chats) is scoped to a specific bot. It requires a botId and customerId and returns records filtered by type — either lead or non-lead.
POST — Get User Inbox (/inbox/users) operates at the account level. It accepts a rich filter body (tags, segments, bots, agents, date ranges, status, and more) and returns all matching contacts across your account with full profile data.
Use the GET endpoint when you need a quick, bot-specific pull. Use the POST endpoint when you need advanced filtering across your entire contact base.
Can I import contacts who are not on WhatsApp?
Yes. Despite the display name Add WhatsApp Contact, the /inbox/users/import endpoint imports contacts into your general contact base. It is not limited to WhatsApp.
You can import any contact by providing a name, email, phone number, tags, and custom attributes.
What does the applicableFilters field do in POST — Get User Inbox?
Support
If everything is correct and you are still unable to move forward, write to us at support@tandtglobal.net. We will respond back within 48 business hours.
