Conversations
Comprehensive API for managing conversations and messages in the system
Reading time: 2 minutes
Conversations
Comprehensive conversation management with filtering and search support.
Conversation Operations
Conversation Status Values
| Parameter | Type | Required | Description |
|---|---|---|---|
unassigned | string | No | Unassigned |
my | string | No | My conversations |
unread | string | No | Unread |
expired | string | No | Expired |
opened | string | No | Opened |
closed | string | No | Closed |
bot | string | No | Bot |
Message Status Values
| Parameter | Type | Required | Description |
|---|---|---|---|
sent | string | No | Sent |
delivered | string | No | Delivered |
read | string | No | Read |
failed | string | No | Failed |
Important Notes
š”
Status
unread- unread messagesopened- open conversationclosed- closed conversationexpired- expired conversation (24 hours without interaction)
ā ļø
Search
- Search works on name and phone number
- Search is case-insensitive
- Can search with partial numbers
ā
Best Practices
- Use status filtering to organize conversations
- Review unread conversations regularly
- Close completed conversations to organize work
Error Codes
| Code | Description | Cause | Solution |
|---|---|---|---|
| 400 | Bad Request | Invalid data | Check sent data |
| 404 | Not Found | Conversation not found | Check conversation ID |
| 401 | Unauthorized | Invalid authentication | Review authentication |
Related Sections
Technical Support
Need help?
- š§ Email: support@awalchat.com
- š¬ Live Chat: Available in the dashboard
- š± WhatsApp: Contact us directly via WhatsApp
- š Examples: See Code Examples