AgentChat API
This document describes how you can use the ChannelMobile AgentChat API
All endpoints are available below, containing information necessary to run each.
Here is a link to our SwaggerHub documentation, you can use our testing credentials to make API calls and try everything out for yourself right now.
EmailAddress: [email protected]
Password: Something23!
Authentication
The API call to logon the agent and return a session token
The current version number
{{BUILD_VERSION}}
The unique email address and the username the agent will use to login
The password corresponding to the unique email address
POST /api/AgentLogon HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 62
{
"EmailAddress": "[email protected]",
"Password": "123smith$$"
}
No content
The API call to update the password for an agent
The current version number
{{BUILD_VERSION}}
The ResetCode in the reset password request URL
POST /api/SetPassword HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 39
{
"ResetCode": "76897132458762458761243"
}
No content
The API call to initiate a password change for an agent
The unique email address and the username of the agent
{{EmailAddress}}
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/RequestPasswordReset HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
The API call to log-off the agent and invalidate the session token
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/AgentLogoff HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
Chats
The API call to send a message to a chat
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The ID number of the Chat from which the message is to be sent
The text of the message
Type of file being attached to the message
The name of the file to be attached to the message
The base 64 encoded file content
POST /api/SendMessage HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 199
{
"ChatID": "408",
"MessageText": "Hallo there",
"AttachmentType": "image/jpeg",
"AttachmentName": "image.jpg",
"AttachmentData": "/9j/4AAQSkZJRgABAQEBLAEsAAD//gATQ3JlYXRlZCB3...............M0xIZA4JnL+v/2Q=="
}
No content
The API call to add a comment to a customer
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The customer ID of the customer that the chat belongs to. The customer must be linked to an active chat
The Comment being added.
POST /api/AddComment HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 52
{
"CustomerID": "1",
"Comment": "This is a new comment"
}
No content
The API call to transfer a chat to a new department.
The ID of the chat to be assigned
The ID of the department that the chat must be transferred to
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/TransferChat HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
The API call to transfer a chat to a new agent. Business Rules: 1. Chat must be assigned. 2 Agent must be online.
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/ReAssignChat HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
The API call to assign a new chat to the calling agent (Agent making the GrabChat call)
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/GrabChat HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
The API call to return a list and details of unassigned, open and closed chats
The type of Chat which has to be one of the three Valid Values: open, unassigned, closed
closed
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/GetChatList HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
The API call to return the details of a chat to be exported, this data will be in a csv format
The unique ID number of each chat
406
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/ExportChat HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
The API call to update the status of a chat to closed
The unique ID number of each chat
406
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/CloseChat HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
The API call to update the status of a Chat to assigned, when assigned to an Agent
The ID of the chat to be assigned
406
the id of the agent the chat must be assigned to, if not specified, the chat will be assigned to the agent that is performing the call
3
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/AssignChat HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
Agent/User
The API call to create a new Agent
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The full name of the Agent
The unique email address and the username the agent will use to login
The role ID of the user being created, 1 = Agent, 2 = Manager
Array of Department ID numbers that the agents will be assigned to
POST /api/CreateAgent HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 122
{
"Name": "Testing",
"EmailAddress": "[email protected]",
"MobileNumber": "0821231234",
"RoleID": "2",
"DepartmentID": [
"1",
"2"
]
}
No content
The API call to keep the session active
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/KeepAlive HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
The API call to update an existing Agent’s details
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The ID number of the Agent to be updated
The name of the Agent to be updated
The mobile number of the Agent to be updated
The unique email address, which is also used as the username, of the Agent to be updated
The array of notifications to enable. (Note the current version only has UnassignedChatsWaiting )
The role ID of the user being updated 1 = Agent, 2 = Manager
The status ID of the Agent being updated 1 = Offline, 2 = Busy, 3 = Onbreak, 4 = Online
Array of Department ID numbers that the agents will be assigned to
POST /api/UpdateAgent HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 217
{
"AgentID": "3",
"Name": "Jack Rabbit",
"MobileNumber": "+27800000000",
"EmailAddress": "[email protected]",
"Notifications": [
"UnassignedChatsWaiting"
],
"RoleID": "2",
"StatusID": "4",
"DepartmentID": [
"1",
"4"
],
"Enabled": true
}
No content
Department
The API call to create a new Department
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The name of the department to be created
Must the Department Name be included in the welcome menu
The name of the Department as it will be included in the welcome menu options
Welcome message for returning customers
Welcome message for new customers (typically includes POPIA information)
Option number in the welcome menu
To Enabled the Department (true/false)
The list of tag ID numbers that will automatically be tagged to the Department being created
POST /api/CreateDepartment HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 331
{
"Name": "Reception",
"IncludeInWelcomeMenu": true,
"NameInMenu": "Reception",
"WelcomeReturning": "Welcome back #CUSTOMERNAME#. You are number #POSITIONINQUEUE# in the #DEPARTMENTNAME# queue",
"WelcomeNew": "Welcome to #DEPARTMENTNAME#. You are number #POSITIONINQUEUE# in the queue",
"MenuIndex": 1,
"Enabled": true,
"AutoTagID": [
"1",
"2",
"3"
]
}
No content
The API call to update an existing Department
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The ID number of the Department to be updated
The name of the department to be updated
Must the Department Name be included in the welcome menu
The name of the Department as it will be included in the welcome menu options
Welcome message for returning customers
Welcome message for new customers (typically includes POPIA information)
Option number in the welcome menu
To Enabled the Department (true/false)
The list of tag ID numbers that will automatically be tagged to the Department being created
POST /api/UpdateDepartment HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 334
{
"DepartmentID": "8",
"Name": "New department",
"IncludeInWelcomeMenu": true,
"NameInMenu": "New department",
"WelcomeReturning": "Welcome back #CUSTOMERNAME#. You are number #POSITIONINQUEUE# in the #DEPARTMENTNAME# queue",
"WelcomeNew": "Welcome to #DEPARTMENTNAME#. You are number #POSITIONINQUEUE# in the queue",
"MenuIndex": 8,
"Enabled": true
}
No content
The API call to return a list of Departments and corresponding setting and message details
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/GetDepartmentList HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
Customer/Client
The API call to update a Customer’s details
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The ID number of the customer to be updated
The full name of the customer
The customer’s email address
Text field to allow comments
The ID of tag assigned to the chat. Note that the chat must be active as the tags are linked to the chat not the customer
POST /api/UpdateCustomer HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 123
{
"CustomerID": "1",
"FullName": "Joe the Jester",
"EmailAddress": "[email protected]",
"Comment": "Another Comment",
"TagID": [
"1",
"2"
]
}
No content
The API call to return the results of a search for a customer
The mobile number to search for, in international format
112798647
Flag to include the chats for the mobile number
true
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/FindCustomer HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
Tags
The API call to add a tag to a chat.
NB The CustomerID or ChatID must be specified in the request.
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The ChatID of the chat the Tag must be assigned to.
The customer ID of the customer that the chat belongs to. The customer must be linked to an active chat
POST /api/AddTag HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 28
{
"ChatID": "407",
"TagID": "1"
}
No content
The API call to create a new Tag
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The ID number of the group to which the tag will be allocated
The name of the tag to be created
Flag true to enable and false to disable the ability to create a tag
POST /api/CreateTag HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 61
{
"TagGroupID": "1",
"Name": "Warranty Enquiries",
"Enabled": true
}
No content
The API call to remove a tag from a chat
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The ID number of the Chat from which the Tag is to be removed
The ID number of the Tag to be removed
POST /api/RemoveTag HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 28
{
"ChatID": "407",
"TagID": "1"
}
No content
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The ID number of the tag to be updated
The name of the tag group to be updated
Flag true to enable and false to disable the tag
POST /api/UpdateTag HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 51
{
"TagID": "22",
"Name": "Updated Name",
"Enabled": true
}
No content
The API call to delete a Tag
The ID of the tag to be deleted
2
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
DELETE /api/DeleteTag HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
Tag Groups
The API call to create a new Group of Tags
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The name of the Tag Group to be created
Flag true to enable and false to disable the ability to create a Tag Group
POST /api/CreateTagGroup HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 43
{
"Name": "Product Enquiries",
"Enabled": true
}
No content
The API call to update an existing Group of Tags
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The ID number of the tag group to be updated
The name of the tag group to be updated
Flag true to enable and false to disable the TagGroup
POST /api/UpdateTagGroup HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 56
{
"TagGroupID": "5",
"Name": "Updated Group",
"Enabled": true
}
No content
Canned Response
The API call to create a new Canned Response
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The name of the canned response to be created
The text of the canned response being created
POST /api/CreateCannedResponse HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 86
{
"Name": "opening hours",
"MessageText": "We are open from 9am to 5pm, Monday to Friday"
}
No content
The API call to update an existing Canned Response
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The ID number of the canned Response to be updated
The name of the canned Response to be updated
The text of the message of the response
POST /api/UpdateCannedResponse HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 94
{
"CannedResponseID": "1",
"Name": "Test canned response",
"MessageText": "This is a test response"
}
No content
The API call to delete a Canned Response
The ID of the canned response to be deleted
2
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
DELETE /api/DeleteCannedResponse HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
Working Hours
The API call to update Working Hours
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
POST /api/UpdateWorkingHours HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 453
{
"Days": [
{
"Day": 1,
"Enabled": true,
"StartTime": "08:00",
"EndTime": "17:30"
},
{
"Day": 2,
"Enabled": true,
"StartTime": "08:00",
"EndTime": "17:30"
},
{
"Day": 3,
"Enabled": true,
"StartTime": "08:00",
"EndTime": "17:30"
},
{
"Day": 4,
"Enabled": true,
"StartTime": "08:00",
"EndTime": "17:30"
},
{
"Day": 5,
"Enabled": true,
"StartTime": "08:00",
"EndTime": "17:30"
},
{
"Day": 6,
"Enabled": false,
"StartTime": "00:00",
"EndTime": "00:00"
},
{
"Day": 7,
"Enabled": false,
"StartTime": "00:00",
"EndTime": "00:00"
}
]
}
No content
Reports
The API call to create a new schedule of Reports
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The ID number of the recipient to receive the report
The ID number of the report the recipient will receive
The format of the file containing the report the recipient will receive
The time over which the reports will be sent
The method of delivery of the report
The day or days of the week the reports will be sent to the recipients. Monday is 1, Tuesday 2, etc
The time of the day each report will be sent on SheduledDay. Format: HH:MM
POST /api/CreateReportSchedule HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 157
{
"RecipientID": "1",
"ReportID": "1",
"Format": "CSV",
"Grouping": [
"WEEK",
"MONTH"
],
"Delivery": "EMAIL",
"ScheduledDay": [
"1",
"2",
"3",
"4",
"5"
],
"ScheduledTime": "16:30"
}
No content
The API call to return the values of the Live Metrics of the Dashboard
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/LiveMetrics HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
The API call to return details for all available reports
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/GetReports HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
The API call to return the reporting data shown on the dashboard
The period the report data must be grouped by
week
Possible values: The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/DataInsight HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
The API call to delete a Scheduled report
The ID of the schedule to be deleted
2
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
DELETE /api/DeleteReportSchedule HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
Recipients
The API call to create a new Recipient of emailed reports
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
The full name (first name and surname) of the recipient
The email address of the recipient to which data, report or other information will be sent
POST /api/CreateRecipient HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 66
{
"FullName": "Zakes Mthini",
"EmailAddress": "[email protected]"
}
No content
The API call to return recipient details and corresponding report and schedule sending details
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/GetRecipients HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
The API call to delete a Recipient of an email report(s)
The ID of the recipient to be deleted
2
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
DELETE /api/DeleteRecipient HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
Settings
The API call to update the company’s Agent Chat setting
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
{"Settings":[{"CompanyName":"Channel"}]}
POST /api/UpdateSettings HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Content-Type: application/json
Accept: */*
Content-Length: 40
{
"Settings": [
{
"CompanyName": "Channel"
}
]
}
No content
The API call to return the company’s Agent Chat settings and messages
The current version number
{{BUILD_VERSION}}
The session token returned by the AgentLogon call
3a4783a081028a59e7b35529a3f9ef22
GET /api/GetSettings HTTP/1.1
Host: agentchat.abcsoftware.dnsalias.com
Accept: */*
No content
Last updated
Was this helpful?