Methods to manage users, agents, and admins.
Returns the user details of a user.
token |
Your admin secret token. |
function |
Enter get-user. |
user_id |
The ID of the user. |
extra |
Set it to true to get the additional user details. Default: false. |
{ "success": true, "response": { "id": "123456", "first_name": "John", "last_name": "Doe", "email": "johon@example.com", "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "visitor", "creation_time": "2020-05-12 14:28:57", "last_activity": "2020-05-12 14:28:57", "department": null, "token": "a521773c5a566a251c3fb00e93162b20ff955b12", "password": "", "details": [ { "slug": "location", "name": "Location", "value": "New York, United States" }, { "slug": "country_code", "name": "Country code", "value": "America/New_York" } ... ] } }
Returns {"success":true, "response":false} if the user is not found.
Searches for a user with the specified user details and returns it.
by |
The user detail name. Accepted values: email, first_name, last_name, phone, [extra] (replace [extra] with any user additional detail name). |
value |
The value of the field. |
{ "id": "881", "first_name": "Don", "last_name": "John", "email": "example@example.com", "user_type": "visitor", "department": null }
Returns {"success":true, "response":false} if the user is not found.
Returns the additional details of a user.
token |
Your admin secret token. |
function |
Enter get-user-extra. |
user_id |
The ID of the user. |
slug |
The slug of the setting to retrieve. If this argument is not set, all user details are returned. Default: false. |
default |
The default value to return if the user details are not found. Default: false. |
{ "success": true, "response": [ { "slug": "browser", "name": "Browser", "value": "Chrome" }, { "slug": "current_url", "name": "Current URL", "value": "https://c.chatbot.inc/" }, { "slug": "os", "name": "OS", "value": "Windows 10" }, { "slug": "phone", "name": "Phone", "value": "3203057977" } ... ] }
Returns {"success":true, "response":[]} if the user is not found.
Returns the active language code used by the user. By default, it's the user browser language.
user_id |
The ID of the user from whom you want to get the language. |
The language code. Examples: es, it. Returns false if the language code is en or not found.
Returns the user details of all the users.
token |
Your admin secret token. |
function |
Enter get-users. |
sorting |
Set the order of the returned values. Enter ["column", "order"] and replace column with one of the following values: first_name, last_name, email, profile_image, user_type, creation_time, last_activity, department. Replace order with ASC or DESC. |
user_types |
Array in JSON format of user types to include in the return value. Array syntax: ["", "", "", ...]. Accepted values: visitor, lead, user, agent, admin. Default: all. |
search |
The string to search. |
pagination |
Integer from 1 to N to limit the results number. Enter 0 to get the first 100 results, 1 for the results from 101 to 200, etc. |
extra |
Set it to true to include all users extra details as well. Set it as an array of user extra detail slugs to include only a subset of extra details. Default: false. |
user_ids |
Array of IDs. If set, returns only the users with ID included in the given array of IDs. Array syntax: ["", "", "", ...]. Default: false. |
{ "success": true, "response": [ { "id": "880", "first_name": "User", "last_name": "#29938", "email": null, "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "visitor", "creation_time": "2020-05-13 08:58:18", "last_activity": "2020-05-13 09:07:39", "department": null, "token": "6d969f64f5ed6263714b9b39f3d3700b66f16820" }, { "id": "879", "first_name": "User", "last_name": "#86773", "email": null, "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "visitor", "creation_time": "2020-05-13 08:38:41", "last_activity": "2020-05-13 08:58:12", "department": null, "token": "2e5064670707d06b661d04353f4a462ec927f19a" } ... ] }
Returns the users created after the given date/ID.
token |
Your admin secret token. |
function |
Enter get-new-users. |
datetime |
User ID or date and time in the following format: YYYY-MM-DD HH:MM:SS. E.g. 2020-05-13 13:35:59. You can remove the time and leave only the date. The dates stored in the database are in UTC+0. |
{ "success": true, "response": [ { "id": "880", "first_name": "User", "last_name": "#29938", "email": null, "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "visitor", "creation_time": "2020-05-13 08:58:18", "last_activity": "2020-05-13 09:07:39", "department": null, "token": "6d969f64f5ed6263714b9b39f3d3700b66f16820" }, { "id": "879", "first_name": "User", "last_name": "#86773", "email": null, "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "visitor", "creation_time": "2020-05-13 08:38:41", "last_activity": "2020-05-13 08:58:12", "department": null, "token": "2e5064670707d06b661d04353f4a462ec927f19a" } ... ] }
Returns the online users including Agents.
token |
Your admin secret token. |
function |
Enter get-online-users. |
exclude_id |
Array of users IDs in JSON format to exclude from the returned values. Array syntax: [123, 123, 123, ...] |
sorting |
The name of the database table used for sorting. Default: creation_time. |
agents |
Set it to true to return only agents and admins. Default: false. |
{ "success": true, "response": [ { "id": "881", "first_name": "Don", "last_name": "John", "email": null, "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "visitor", "creation_time": "2020-05-13 09:18:59", "last_activity": "2020-05-13 09:32:34", "department": null, "token": "e435a5c67f4276cdb9c6fc19b7c015990ffc3268" }, { "id": "880", "first_name": "User", "last_name": "#29938", "email": null, "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "visitor", "creation_time": "2020-05-13 08:58:18", "last_activity": "2020-05-13 09:32:28", "department": null, "token": "6d969f64f5ed6263714b9b39f3d3700b66f16820" } ... ] }
Returns an array with the user IDs and details of the users who have the requested details.
token |
Your admin secret token. |
function |
Enter get-users-with-details. |
details |
Array of user details. E.g. [ "email", "phone" ]. |
user_ids |
Array, or comma-separated string of user IDs. If this argument is set only the users which have their ID included are returned. Set it to all or false to search all users, set it to agents to search only agents and admins. Default: false. |
{ "email": [ { "id": 4561, "value": "albert@example.com" }, { "id": 98436, "value": "jessica@example.com" }, ... ], "phone": [ { "id": 12563, "value": "+4462367136" }, { "id": 778956, "value": "+4462999345" }, ... ], ... }
Returns the details of an agent or admin.
token |
Your admin secret token. |
function |
Enter get-agent. |
agent_id |
The agent ID. |
{ "success": true, "response": { "id": "123456", "first_name": "John", "last_name": "Doe", "email": "johon@example.com", "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "agent", "creation_time": "2020-05-12 14:28:57", "last_activity": "2020-05-12 14:28:57", "department": null, "token": "a521773c5a566a251c3fb00e93162b20ff955b12", "password": "", "details": [ { "slug": "location", "name": "Location", "value": "New York, United States" }, { "slug": "country_code", "name": "Country code", "value": "America/New_York" } ... ] } }
Returns an array with the IDs of Agents.
token |
Your admin secret token. |
function |
Enter get-agents-ids. |
admins |
Set it to false to exclude the admins. Default: true; |
[ 881, 153, ... ]
Returns the user ID and email of the user, or last agent, of the given conversation.
token |
Your admin secret token. |
function |
Enter get-user-from-conversation. |
conversation_id |
The conversation ID. |
agent |
Set it to true to get the last agent who replied to the conversation. Default: false. |
{ "id": "123456", "email": "email@example.com" }
Checks if at least one agent or admin is online.
{ "success": true, "response": true }
Return true if there are agents or admin online, or false if all Agents are offline.
Returns the users matching the search.
token |
Your admin secret token. |
function |
Enter search-users. |
search |
The string to search. The additional user details are supported too. |
{ "success": true, "response": [ { "id": "881", "first_name": "Don", "last_name": "John", "email": null, "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "visitor", "creation_time": "2020-05-13 09:18:59", "last_activity": "2020-05-13 09:32:34", "department": null, "token": "e435a5c67f4276cdb9c6fc19b7c015990ffc3268" }, { "id": "880", "first_name": "User", "last_name": "#29938", "email": null, "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "visitor", "creation_time": "2020-05-13 08:58:18", "last_activity": "2020-05-13 09:32:28", "department": null, "token": "6d969f64f5ed6263714b9b39f3d3700b66f16820" } ... ] }
Returns {"success":true, "response":[]} if no users are found.
Create a new user.
token |
Your admin secret token. |
function |
Enter add-user. |
first_name |
The first name of the user. Default: User |
last_name |
The last name of the user. Default: #RANDOM-NUMBER |
|
|
The email of the user. Default: empty. |
profile_image |
The profile picture of the user. Default: |
password |
The password of the user. Default: empty. |
user_type |
The user type of the user. Accepted values: visitor, lead, user, agent, admin. Default: visitor if the email is not provided, otherwise user. |
extra |
Array of additional user details in
JSON format. Any detail is accepted.
Built-in details (IDs):
phone,
city,
language,
country,
birthday,
company,
facebook,
twitter,
linkedin,
website,
ip,
country_code,
browser,
currency,
location,
os,
time_zone,
current_url.
Array syntax: {"ID": ["value", "Name"], "ID": ["value", "Name"], ...}
|
{ "success": true, "response": 123456 }
Other possible responses: ID of the new user on success, otherwise duplicate-email, invalid-user-type, MySQL error message.
Updates the details of an existing user.
token |
Your admin secret token. |
function |
Enter update-user. |
user_id |
The ID of the user to update. |
first_name |
The first name of the user. |
last_name |
The last name of the user. |
|
|
The email of the user. Enter NULL to delete the email. |
profile_image |
The profile picture of the user. |
password |
The password of the user. |
user_type |
The user type of the user. Accepted values: visitor, lead, user, agent, admin. |
settings_extra |
Array of additional user details in
JSON format.
Array syntax: {"ID": ["value", "Name"], "ID": ["value", "Name"], ...}
|
{ "success": true, "response": true }
Other possible responses: duplicate-email, invalid-user-type, MySQL error message.
Deletes a user and all linked conversations and messages.
token |
Your admin secret token. |
function |
Enter delete-user. |
user_id |
The ID of the user to delete. |
{ "success": true, "response": true }
Deletes multiple users and all linked conversations and messages.
token |
Your admin secret token. |
function |
Enter delete-users. |
user_ids |
Array of IDs of the users to delete. Array syntax: [123, 123, 123, ...] |
{ "success": true, "response": true }
Checks if a user is online.
token |
Your admin secret token. |
function |
Enter is-online. |
user_id |
The ID of the user. |
true if online, false if offline.
Gets or sets the current URL of a user or the last visited URL.
token |
Your admin secret token. |
function |
Enter current-url. |
user_id |
The ID of the user |
url |
The URL to set as "Current URL". If this argument is set the function will only set the value and it will not return any URL. |
{ "success": true, "response": "https://board.support" }
Returns {"success":true,"response":false} if the URL is not found. Returns {"success":true,"response":true} if the url argument is set.
Returns the total users' count grouped by user type.
token |
Your admin secret token. |
function |
Enter count-users. |
{ "success": true, "response": { "all": "335", "lead": "288", "user": "15", "visitor": "28" } }
Changes the user type to lead.
token |
Your admin secret token. |
function |
Enter update-user-to-lead. |
user_id |
The ID of the user. |
{ "success": true, "response": true }
Generates the user profile image by using the first letter of first name, and last name, saves the image, and returns the image URL.
token |
Your admin secret token. |
function |
Enter get-avatar. |
first_name |
The first name of the user. |
last_name |
The last name of the user. |
https://example.com/supportboard/uploads/13-04-21/9455859.png
Returns the Support Board bot ID.
123
Checks if a user or agent is typing a message in a conversation. This function will not work if Pusher is active.
token |
Your admin secret token. |
function |
Enter is-typing |
user_id |
The ID of the user, or the agent, to check. |
conversation_id |
The ID of conversation to check. |
Returns true if the user is typing, otherwise, returns false.
Checks if an agent is typing a message in a conversation, and returns the agent details. This function will not work if Pusher is active.
token |
Your admin secret token. |
function |
Enter is-agent-typing |
conversation_id |
The ID of conversation to check. |
{ "id": "", "first_name": "", "last_name": "" }
Returns false if no agents are typing.
Assigns the typing status to a user or agent relative to a conversation.
token |
Your admin secret token. |
function |
Enter set-typing |
user_id |
The ID of the user, or the agent. |
conversation_id |
The ID of the conversation. |
{ "success": true, "response": true }
Logins a user or agent. A user can log in in two ways: via email and password, or via user ID and token.
token |
Your admin secret token. |
function |
Enter login |
|
|
The email of the user to login. If this attribute is set you need to set also the password. Default: empty. |
password |
The password of the user to login. If this attribute is set you need to set also the email. Default: empty. |
user_id |
The ID of the user to login. If this attribute is set you need to set also the token. Default: empty. |
token |
The token of the user to login. If this attribute is set you need to set also the user ID. You can get the token from the Users area by opening the profile box of a user. Default: empty. |
{ "success": true, "response": [ { "id": "913", "profile_image": "https://c.chatbot.inc/user.svg", "first_name": "User", "last_name": "#29902", "email": null, "user_type": "visitor", "token": "9b25351047ee758aa97ee4868d130cc15eb8decf" }, "YXNkWGNSeTdtRTdDYVkxVG8wckN4YWF6V2s0Tk1mczBSVHdQbHBpOWdmejVUTTdOUUxEUENhdUVoYmROWn..." ] }
The last value is the encrypted login data ready to be stored in the sb-login cookie. Use the function SBF.loginCookie(response[1]); to store it. Returns false if login is unsuccessful.
Logouts the logged-in user.
token |
Your admin secret token. |
function |
Enter logout. |
{ "success": true, "response": true }
The sb-login cookie must also be deleted from the user's browser.
Updates the user details of the logged-in user. This function update all the user details, if a detail is not set it will be deleted from the database.
token |
Your admin secret token. |
function |
Enter update-login. |
profile_image |
The profile image URL of the user. Default: empty. |
first_name |
The first name of the user. Default: empty. |
last_name |
The last name of the user. Default: empty. |
|
|
The email of the user. Default: empty. |
department |
Update the department of the user. This setting is used in the admin area. Default: empty. |
YXNkWGNSeTdtRTdDYVkxVG8wckN4YWF6V2s0Tk1mczBSVHdQbHBpOWdmejVUTTdOUUxEUENhdUVoYmROWn...
The response must be saved into the sb-login cookie of the user's browser.
Deletes all leads, including all the linked conversations and messages.
token |
Your admin secret token. |
function |
Enter delete-leads. |
{ "success": true, "response": true }
Updates the profile details of the bot. If the chatbot is not found a new chatbot profile is created.
token |
Your admin secret token. |
function |
Enter update-bot. |
name |
The bot name. |
profile_image |
The bot profile image URL. |
{ "success": true, "response": true }
Returns true on success, false otherwise.
Exports all the users in a CSV file and returns the URL.
token |
Your admin secret token. |
function |
Enter csv-users . |
user_ids |
Array of user IDs. If set, returns only users with the specified user IDs. Defaults: false. |
{ "success": true, "response": "https://c.chatbot.inc/uploads/users.csv" }
Methods to manage conversations and messages.
Returns a conversation and the messages of the conversation.
token |
Your admin secret token. |
function |
Enter get-conversation. |
conversation_id |
The ID of the conversation. |
user_id |
The ID of the user linked to the conversation. |
{ "success": true, "response": { "messages": [ { "id": "2044", "user_id": "802", "message": "Hello!", "creation_time": "2020-05-0410:06:30", "attachments": "", "status_code": "0", "payload": "", "conversation_id": "946", "first_name": "Don", "last_name": "John", "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "lead" }, { "id": "2045", "user_id": "377", "message": "Hello,howcanIhelp?", "creation_time": "2020-05-0410:06:33", "attachments": "", "status_code": "0", "payload": "", "conversation_id": "946", "first_name": "Bruce", "last_name": "Peterson", "profile_image": "https://c.chatbot.inc/agent.svg", "user_type": "agent" } ... ], "details": { "user_id": "802", "first_name": "Don", "last_name": "John", "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "lead", "id": "946", "title": "", "conversation_time": "2020-05-0410:06:30", "conversation_status_code": "3", "department": null } } }
Return {"success":true,"response":{"messages":[],"details":""}} if the conversation is not found.
Returns all the conversations. Each conversation includes the last message of the conversation.
token |
Your admin secret token. |
function |
Enter get-conversations. |
pagination |
Integer from 1 to N to limit the results number. Enter 0 to get the first 100 results, 1 for the results from 101 to 200, etc. |
status_code |
The status code of the returned conversations. Default: all the conversations in the inbox, excluding the conversations in the trash and archive. Status codes: live = 0, waiting answer from user = 1, waiting answer from agent = 2, archive = 3, trash = 4, all = includes all status codes. |
routing |
Set it to true if the queue or routing is active in Settings > Miscellaneous. Default: false. |
routing_unassigned |
Set it to true to also view the conversations not assigned to any agent. Default: false. |
department |
Returns only the conversations assigned to the provided department ID. |
source |
Returns only the conversations created from the provided source. Available sources: em (Email), tk (Ticket), wa (WhatsApp), fb (Facebook Messenger), ig (Instagram), tw (Twitter), wc (WeChat), tx (Text message), gb (Google Business Messages), tg (Telegram), ln (LINE) vb (Viber). |
tag |
Returns only the conversations with the specified tag. |
{ "success": true, "response": [ { "message": "Hello World!", "message_id": "7351", "attachments": "", "payload": "", "message_status_code": "2", "last_update_time": "2023-10-02 16:00:06", "message_user_id": "377", "message_first_name": "Smart Assistant", "message_last_name": "", "message_profile_image": "https://example.com/image.jpg", "message_user_type": "bot", "conversation_id": "4084", "conversation_user_id": "4446", "conversation_status_code": "3", "conversation_creation_time": "2023-10-02 15:59:59", "department": "1", "agent_id": null, "title": "", "source": "tk", "extra": null, "tags": null, "conversation_first_name": "User", "conversation_last_name": "#26147", "conversation_profile_image": "https://example.com/image.jpg", "conversation_user_type": "lead" }, ... ] }
Returns the conversations created after the given date/ID or with a message created after the given date/ID. Each conversation includes the last message of the conversation.
token |
Your admin secret token. |
function |
Enter get-new-conversations. |
datetime |
Conversation ID or date and time in the following format: YYYY-MM-DD HH:MM:SS. E.g. 2020-05-13 13:35:59. You can remove the time and leave only the date. The dates stored in the database are in UTC+0. |
routing |
Set it to true if the queue or routing is active in Settings > Miscellaneous. Default: false. |
routing_unassigned |
Set it to true to also view the conversations not assigned to any agent. Default: false. |
{ "success": true, "response": [ { "message": "Hello World!", "message_id": "7351", "attachments": "", "payload": "", "message_status_code": "2", "last_update_time": "2023-10-02 16:00:06", "message_user_id": "377", "message_first_name": "Smart Assistant", "message_last_name": "", "message_profile_image": "https://example.com/image.jpg", "message_user_type": "bot", "conversation_id": "4084", "conversation_user_id": "4446", "conversation_status_code": "3", "conversation_creation_time": "2023-10-02 15:59:59", "department": "1", "agent_id": null, "title": "", "source": "tk", "extra": null, "tags": null, "conversation_first_name": "User", "conversation_last_name": "#26147", "conversation_profile_image": "https://example.com/image.jpg", "conversation_user_type": "lead" }, ... ] }
Return {"success":true, "response":[]} if no conversations are found.
Returns the conversations of a user. Each conversation includes the last message of the conversation.
token |
Your admin secret token. |
function |
Enter get-user-conversations. |
user_id |
The ID of the user. |
exclude_id |
Exclude a conversation from the results. |
agents |
Set it to true if the user is an agent or admin. Default: false. |
{ "success": true, "response": [ { "message": "Hello World!", "message_id": "7351", "attachments": "", "payload": "", "message_status_code": "2", "last_update_time": "2023-10-02 16:00:06", "message_user_id": "377", "message_first_name": "Smart Assistant", "message_last_name": "", "message_profile_image": "https://example.com/image.jpg", "message_user_type": "bot", "conversation_id": "4084", "conversation_user_id": "4446", "conversation_status_code": "3", "conversation_creation_time": "2023-10-02 15:59:59", "department": "1", "agent_id": null, "title": "", "source": "tk", "extra": null, "tags": null }, ... ] }
Return {"success":true, "response":[]} if no conversations are found.
Returns the user conversations created after the given date/ID or with a message created after the given date/ID. Each conversation includes the last message of the conversation.
token |
Your admin secret token. |
function |
Enter get-new-user-conversations. |
user_id |
The ID of the user. |
datetime |
Conversation ID or date and time in the following format: YYYY-MM-DD HH:MM:SS. E.g. 2020-05-13 13:35:59. You can remove the time and leave only the date. The dates stored in the database are in UTC+0. |
{ "success": true, "response": [ { "message": "Hello World!", "message_id": "7351", "attachments": "", "payload": "", "message_status_code": "2", "last_update_time": "2023-10-02 16:00:06", "message_user_id": "377", "message_first_name": "Smart Assistant", "message_last_name": "", "message_profile_image": "https://example.com/image.jpg", "message_user_type": "bot", "conversation_id": "4084", "conversation_user_id": "4446", "conversation_status_code": "3", "conversation_creation_time": "2023-10-02 15:59:59", "department": "1", "agent_id": null, "title": "", "source": "tk", "extra": null, "tags": null }, ... ] }
Return {"success":true, "response":[]} if no conversations are found.
Returns the conversations matching the search.
token |
Your admin secret token. |
function |
Enter search-conversations. |
search |
The string to search. The search function is capable of searching through attachment names, messages, user email, first name, and last name, tags, agent ID, department ID, conversation title and more. |
{ "success": true, "response": [ { "message": "Hello World!", "message_id": "7351", "attachments": "", "payload": "", "message_status_code": "2", "last_update_time": "2023-10-02 16:00:06", "message_user_id": "377", "message_first_name": "Smart Assistant", "message_last_name": "", "message_profile_image": "https://example.com/image.jpg", "message_user_type": "bot", "conversation_id": "4084", "conversation_user_id": "4446", "conversation_status_code": "3", "conversation_creation_time": "2023-10-02 15:59:59", "department": "1", "agent_id": null, "title": "", "source": "tk", "extra": null, "tags": null, "conversation_first_name": "User", "conversation_last_name": "#26147", "conversation_profile_image": "https://example.com/image.jpg", "conversation_user_type": "lead" }, ... ] }
Return {"success":true, "response":[]} if no conversations are found.
Returns the conversations of the given user ID that matches the search terms.
token |
Your admin secret token. |
function |
Enter search-user-conversations. |
search |
The search function is capable of searching through attachment names, messages, user email, first name, and last name, tags, agent ID, department ID, conversation title and more. |
user_id |
The ID of the user. |
{ "success": true, "response": [ { "message": "Hello World!", "message_id": "7351", "attachments": "", "payload": "", "message_status_code": "2", "last_update_time": "2023-10-02 16:00:06", "message_user_id": "377", "message_first_name": "Smart Assistant", "message_last_name": "", "message_profile_image": "https://example.com/image.jpg", "message_user_type": "bot", "conversation_id": "4084", "conversation_user_id": "4446", "conversation_status_code": "3", "conversation_creation_time": "2023-10-02 15:59:59", "department": "1", "agent_id": null, "title": "", "source": "tk", "extra": null, "tags": null }, ... ] }
Returns {"success":true, "response":[]} if no conversations are found.
Creates a new conversation.
token |
Your admin secret token. |
function |
Enter new-conversation. |
user_id |
The ID of the user linked to the conversation. |
status_code |
The status code to assign to the conversation. Default: 1. Status codes: live = 0, waiting answer from user = 1, waiting answer from agent = 2, archive = 3, trash = 4. |
title |
The title of the conversation. Default: empty. |
department |
The ID of a department. You can get the IDs from Settings > Miscellaneous > Departments. Default: -1. |
agent_id |
The ID of the agent assigned to the conversation. Default: -1. |
source |
Set the conversation source. Default: false. |
extra |
Extra conversation values. Default: false. |
extra_2 |
Extra conversation values. Default: false. |
extra_3 |
Extra conversation values. Default: false. |
tags |
Conversation tags separated by commas. Default: false. |
{ "success": true, "response": { "messages": [], "details": { "user_id": "882", "first_name": "Don", "last_name": "John", "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "lead", "id": "1007", "title": "", "conversation_time": "2020-05-15 12:51:39", "conversation_status_code": "0", "department": null } } }
Other possible responses: Conversation details array on success, otherwise user-not-found, MySQL error message.
Updates the status code of a conversation.
token |
Your admin secret token. |
function |
Enter update-conversation-status. |
conversation_id |
The ID of the conversation. |
status_code |
The status code to assign to the conversation. Status codes: live = 0, waiting answer from user = 1, waiting answer from agent = 2, archive = 3, trash = 4. |
{ "success": true, "response": true }
Returns invalid-status-code if the status code is invalid.
Updates the department of a conversation.
token |
Your admin secret token. |
function |
Enter update-conversation-department. |
conversation_id |
The ID of the conversation to update. |
department |
The ID of a department. You can get the IDs from Settings > Miscellaneous > Departments. The department ID is not validated, so double-check it to make sure it exists. Set it to false to remove the department. |
message |
A string containing a message for the agents notifications. If set, all the agents assigned to the new department will be notified via email, push notification, and SMS. |
{ "success": true, "response": true }
Assigns or update the agent assigned to a conversation.
token |
Your admin secret token. |
function |
Enter update-conversation-agent. |
conversation_id |
The ID of the conversation to update. |
agent_id |
The ID of a agent. Set it to false to remove the agent. |
message |
A string containing a message for the agent notifications. If set, the agent will be notified via email, push notification, and SMS. |
{ "success": true, "response": true }
Assigns a rating to a conversation and optionally updates a message of the conversation.
token |
Your admin secret token. |
function |
Enter set-rating. |
settings |
Enter the following array in JSON format: { "settings" : { "conversation_id": "ID", "rating": "RATING" }}. Replace ID with the ID of the conversation to rate, replace rating with 1 for a positive rating or with 0 for a negative one. |
payload |
The payload of the message in JSON format. |
message_id |
The ID of the message to update. |
message |
The content of the message. |
user_id |
The ID of the user linked to the conversation linked to the message. |
{ "success": true, "response": true }
Gets the ratings of the conversations assigned to an agent.
token |
Your admin secret token. |
function |
Enter get-rating. |
user_id |
The ID of an agent. |
{ "success": true, "response": [4,2] }
The response array: [count of positive ratings, count of negative ratings]. In the example above there are 4 positive ratings and 2 negative ratings.
Returns the messages of a conversation created after the given date/ID.
token |
Your admin secret token. |
function |
Enter get-new-messages. |
user_id |
The ID of the user linked to the conversation. |
conversation_id |
The ID of the conversation. |
datetime |
Message ID or date and time in the following format: YYYY-MM-DD HH:MM:SS. E.g. 2020-05-13 13:35:59. You can remove the time and leave only the date. The dates stored in the database are in UTC+0. |
{ "success": true, "response": [ { "id": "2319", "user_id": "377", "message": "Welcome to our support chat!", "creation_time": "2020-05-12 18:04:50", "attachments": "", "status_code": "0", "payload": "", "conversation_id": "1004", "first_name": "Virtual", "last_name": "Agent", "profile_image": "https://c.chatbot.inc/bot.svg", "user_type": "bot" }, { "id": "2320", "user_id": "877", "message": "Thank you! I need help.", "creation_time": "2020-05-12 18:04:51", "attachments": "", "status_code": "0", "payload": "", "conversation_id": "1004", "first_name": "Don", "last_name": "John", "profile_image": "https://c.chatbot.inc/user.svg", "user_type": "lead" }, ... ] }
Return {"success":true, "response":[]} if no conversations are found.
Returns the last message in a conversation.
token |
Your admin secret token. |
function |
Enter get-last-message. |
conversation_id |
The conversation ID. |
exclude_message |
If set, excludes the message with the specified text. Default: false. |
user_id |
If set, checks only the messages created by the specified user ID. Default: false. |
{ "success": true, "response": { "message": "Welcome to our support chat!", "attachments": "", "payload": "" } }
Adds a new message to an existing conversation.
token |
Your admin secret token. |
function |
Enter send-message. |
user_id |
The ID of the user who sends the message. Use the API 'get-bot-id' to get the ID of the bot. |
conversation_id |
The ID of the conversation. |
message |
The message. |
attachments |
Array of attachments in JSON format. Array syntax: [["name", "link"], ["name", "link"], ...]. Replace name with the name of the attachment and link with the full URL of the attachment. It's up to you to upload attachments to a remote server, this argument only accepts the URL of the files already uploaded. Default: []. |
conversation_status_code |
The status code to assign to the conversation. Status codes: live = 0, waiting answer from user = 1, waiting answer from agent = 2, archive = 3, trash = 4. Set it to skip to leave the current conversation status. |
payload |
Array in JSON format of additional information. You can insert any value. Array syntax: { "key": value, "key": value, ... }. |
queue |
Set it to true if the queue is active in Settings > Miscellaneous > Queue. Default: false. |
recipient_id |
The ID of the user who receive the message. Use this attribute to get the user language. |
{ "success": true, "response": { "status": "success", "message-id": 123456, "queue": false, "notifications": ["sms", "email"], "message": "Text of the message" } }
Other possible responses: invalid-status-code, MySQL error message. The notifications response include the notifications sent to the user or agents.
Updates an existing message.
token |
Your admin secret token. |
function |
Enter update-message. |
message_id |
The ID of the message. |
message |
The content of the message. |
attachments |
Array of attachments in JSON format. Array syntax: [["name", "link"], ["name", "link"], ...]. Replace name with the name of the attachment and link with the full URL of the attachment. It's up to you to upload attachments to a remote server, this argument only accepts the URL of the files already uploaded. Default: []. |
payload |
Array in JSON format of additional information. You can insert any value. Array syntax: { "key": value, "key": value, ... }. |
{ "success": true, "response": true }
Deletes an existing message.
token |
Your admin secret token. |
function |
Enter delete-message. |
message_id |
The ID of the message to delete. |
{ "success": true, "response": true }
Deletes all attachments of a conversation or message, including the ones stored in AWS S3.
token |
Your admin secret token. |
function |
Enter delete-attachments. |
conversation_id |
The ID of the conversation containing the attachments to delete. Default: false. |
message_id |
The ID of the message containing the attachments to delete. Default: false. |
{ "success": true, "response": true }
Updates the status code of multiple messages to read.
token |
Your admin secret token. |
function |
Enter update-messages-status. |
message_ids |
Array of message IDs in JSON format, e.g. [1, 212, 124]. |
user_id |
The ID of the user linked to the messages. Required to update the user's chat if Pusher is active. |
{ "success": true, "response": true }
Returns an array with all the agents with at least one message in the conversation.
token |
Your admin secret token. |
function |
Enter get-agents-in-conversation. |
conversation_id |
The conversation ID. It can be an array of conversation IDs. |
{ "success": true, "response": { "1546": [ { "id": 5463, "first_name": "Don", "last_name": "John", "profile_image": "https://c.chatbot.inc/user.svg", "conversation_id": 1546 }, { "id": 6413, "first_name": "Steven", "last_name": "Travolta", "profile_image": "https://c.chatbot.inc/user.svg", "conversation_id": 1546 }, ... ] } }
Exports a conversation in a CSV or TXT file and returns the URL.
token |
Your admin secret token. |
function |
Enter transcript . |
conversation_id |
The ID of the conversation to export. |
type |
Set it to csv to export the conversation as a CSV file, set it to txt to export the conversation as a text file, set it to false to use the type set in Settings > Admin > Transcript type. Default: false. |
{ "success": true, "response": "https://c.chatbot.inc/uploads/conversation-1021.csv" }
Return {"success":true, "response":false} if the conversation is not found.
Sends a direct chat message. Details here.
token |
Your admin secret token. |
function |
Enter direct-message . |
user_ids |
Array of user IDs, e.g. [45, 89, 65]. |
message |
The message. |
subject |
The subject. Required only for emails. Default: false. |
{ "success": true, "response": true }
Sends a message to the messaging platform linked to the conversation. Available messaging platforms: Facebook Messenger, Instagram, WhatsApp, Twitter, Telegram, Google Business Messages, WeChat, LINE, Viber, Tickets, Emails, Text messages.
token |
Your admin secret token. |
function |
Enter messaging-platforms-send-message. |
conversation_id |
The conversation ID. |
message |
The message. |
attachments |
Array of attachments in JSON format. Array syntax: [["name", "link"], ["name", "link"], ...]. Replace name with the name of the attachment and link with the full URL of the attachment. It's up to you to upload attachments to a remote server, this argument only accepts the URL of the files already uploaded. |
user |
Associative array with { "id": 123, "profile_image": "https://example.com/image.jpg" } as values, or a user ID. |
source |
Associative array with { "source": SOURCE CODE } as value. Available source codes: em (Email), tk (Ticket), wa (WhatsApp), fb (Facebook Messenger), ig (Instagram), tw (Twitter), wc (WeChat), tx (Text message), gb (Google Business Messages), tg (Telegram), ln (LINE) vb (Viber). For Telegram the source must also include { "chat_id": "123456789" }. For Facebook Messenger the source must also include { "page_id": "123456789" }. |
{ "success": true, "response": true }
Counts the number of conversations.
token |
Your admin secret token. |
function |
Enter count-conversations . |
status_code |
If set, only the conversations with the specified status are counted. Status codes: live = 0, waiting answer from user = 1, waiting answer from agent = 2, archive = 3, trash = 4. Default: false. |
{ "success": true, "response": 123456 }
Checks if a list of conversations is assigned to a department or agent and returns only the conversation IDs that are assigned to that agent and/or department.
token |
Your admin secret token. |
function |
Enter check-conversations-assignment. |
conversation_ids |
Array of IDs of the conversations to check, e.g. [45, 565, 68]. |
agent_id |
The agent ID. Default: false. |
department_id |
The department ID. Default: false. |
{ "success": true, "response": [1234, 5, ...] }
Returns the last agent who answered a conversation.
token |
Your admin secret token. |
function |
Enter get-last-agent-in-conversation. |
conversation_id |
The conversation ID. |
{ "success": true, "response": { "id": 123, "first_name": "Don", "last_name": "John", "email": "email@example.com", "password": "$P$BcCpYeU21wYnXKW2LpJj/F9xRdSmLM/" } }
Returns false the conversation has no replies from agents.
Sends a bot message and returns its content.
token |
Your admin secret token. |
function |
Enter execute-bot-message. |
name |
The bot message name. Available values: offline, follow_up, welcome. |
conversation_id |
The ID of the conversation to send the message to. |
last_user_message |
Use it to display different text excerpts in the admin area and chat dashboard. Default: false. |
check |
Set it to false to send the message also if it was already sent less than 10 days ago. Default: true. |
{ "success": true, "response": { "message": "Lorem ipsum dolor", "attachments": [], "id": 123, "settings": { "active": true, "title": "", "message": "" } } }
ID is the ID of the message that was just created.
Functions related to settings, articles, translations and more.
Returns a setting saved in the Settings area.
token |
Your admin secret token. |
function |
Enter get-setting. |
setting |
The setting ID. You can get the IDs of all the settings from the file resources\json\settings.json or with the API function get-settings. |
{ "success": true, "response": { "option": "value", "option": "value", ... } }
Returns a subsetting of another setting.
token |
Your admin secret token. |
function |
Enter get-multi-setting. |
id |
The main setting ID. You can get the IDs of all the settings from the file resources\json\settings.json or with the API function get-settings. |
sub_id |
The subsetting ID. You can get the IDs of all the settings from the file resources\json\settings.json or with the API function get-settings. |
default |
The value to return if the setting is not found. Default: false. |
Returns the value of the subsetting if available, otherwise returns the default value.
Returns an external setting. External settings are saved on a dedicated database row.
token |
Your admin secret token. |
function |
Enter get-external-setting. |
name |
The setting name. |
default |
The value to return if the setting is not found. Default: false. |
Returns the value of the setting if available, otherwise returns the default value.
Returns an array with all the settings.
token |
Your admin secret token. |
function |
Enter get-settings. |
{ "success": true, "response": { "chat-manual-init": [ false, "checkbox" ], "chat-login-init": [ false, "checkbox" ], "init-dashboard": [ true, "checkbox" ], "chat-timetable-disable": [ false, "checkbox" ], "rtl": [ false, "checkbox" ], "front-auto-translations": [ true, "checkbox" ], ... } }
Saves all settings.
token |
Your admin secret token. |
function |
Enter save-settings. |
settings |
The settings array. Get it from get-settings. |
external_settings |
Settings saved to a dedicated row of the table sb_settings of the database. |
external_settings_translations |
Translations of the external settings. |
{ "success": true, "response": true }
Saves an external setting. External settings are saved on a dedicated database row.
token |
Your admin secret token. |
function |
Enter save-external-setting. |
name |
The setting name. |
value |
The setting value. |
{ "success": true, "response": true }
Exports all Support Board settings to a JSON file and return the URL of the file.
token |
Your admin secret token. |
function |
Enter export-settings. |
{ "success": true, "response": "http://example.com/supportboard/uploads/settings_855776223.json" }
Returns the URL of the JSON file containing the settings.
Imports the Support Board settings from a JSON file generated via the export-settings function.
token |
Your admin secret token. |
function |
Enter import-settings. |
file_url |
The URL of the JSON file containing the settings. |
{ "success": true, "response": true }
Returns the Support Board departments.
token |
Your admin secret token. |
function |
Enter get-departments. |
{ "1": { "name": "Example", "color": "yellow", "image": "https://example.com/image.png" }, "2": { "name": "Example", "color": "red", "image": "https://example.com/image.png" }, ... }
Returns an array with all the saved replies.
token |
Your admin secret token. |
function |
Enter saved-replies. |
{ "success": true, "response": [ { "reply-name": "hello", "reply-text": "Hello! How can I help?" }, { "reply-name": "email", "reply-text": "Our email is support@example.com." }, ... ] }
Returns the translations in the given language.
token |
Your admin secret token. |
function |
Enter get-translation. |
language_code |
The two-letter language code. |
{ "name": "Arabic", "front": { "Activities": "أنشطة", "All": "الكل", "All articles": "جميع المقالات", "All fields are required.": "جميع الØقول مطلوبة", ... }, "admin": { "A conversation was started by": "", "Activate": "", "Activation complete! Page reload in progress...": "", "Add a saved reply": "", ... } }
Returns the translations of the back-end and the frond-end, for all the available languages.
token |
Your admin secret token. |
function |
Enter get-translations. |
{ "ar": { "name": "Arabic", "front": { "Activities": "أنشطة", "All": "الكل", "All articles": "جميع المقالات", "All fields are required.": "جميع الØقول مطلوبة", ... }, "admin": { "A conversation was started by": "", "Activate": "", "Activation complete! Page reload in progress...": "", "Add a saved reply": "", ... } }, "da": { "name": "Danish", "front": { "Activities": "Aktiviteter", "All": "Alle", "All articles": "Alle artikler", "All fields are required.": "Alle felter skal udfyldes.", ... }, "admin": { "A conversation was started by": "", "Activate": "", "Activation complete! Page reload in progress...": "", "Add a saved reply": "", ... } }, ... }
Save the translations and overwrite the translations files. Warning! If the given translations array is corrupted you could corrupt the translations files. Make a backup of the translations folder (\resources\languages\) first. Each time a translation is saved a backup is created automatically in the uploads folder.
token |
Your admin secret token. |
function |
Enter save-translations. |
translations |
The translations array with all the translations. Use the method get-translations to get the array. |
{ "success": true, "response": true }
Translates a string in the language of the specified language code. This function works only for front translations.
token |
Your admin secret token. |
function |
Enter translate-string. |
string |
The string to translate. |
language_code |
The two-letter language code. Set it to false to use the active user language. Default: false. |
Returns the translated string if the translation is found, otherwise returns the original string.
Article/Knowledge Base functions.
Returns an array with all the articles or a single article.
token |
Your admin secret token. |
function |
Enter get-articles. |
id |
The ID of the article. The get the articles IDs, execute this method again without arguments. Default: -1. |
count |
The maximum number of returned articles. Default: all. |
full |
Boolean. Set it to true to get full length article contents. Default: false. |
categories |
Set it to true to get the array of all categories, in such a case the response is a double array, first item articles, second item categories. Set it to the category ID to get only the articles of the give category. Default: false. |
articles_language |
Get the articles in the language of the given language code. If there are no articles in the given language code, the articles in the default language are returned instead. Set it to all to get all the translations. Default: false. |
{ "success": true, "response": [ { "id": "6P2Oq", "title": "What's new with the API V2?", "content": "The API V2 is the new iteration of o ...", "link": "https://board.support", "categories": ["K92kl"] }, { "title": "Should I move to the new system?", "content": "Yes. The newest version of the Actions ...", "link": "https://board.support", "id": "qf7kD", "categories": ["ols85"] }, ... ] }
{ "success": true, "response": { "id": "6P2Oq", "title": "What's new with the API V2?", "content": "The API V2 is the new iteration of our developer API. The new API integrates...", "link": "https://board.support", "categories": ["K92kl"] } }
Saves all the articles. This function deletes all the existing articles and replace them with the ones of the given array.
token |
Your admin secret token. |
function |
Enter save-articles. |
articles |
The array with the articles. Use the API
get-articles to get the articles array.
Array syntax:
{"articles": [{"id": "", "title": "", "content": "", "link":"", "categories": []}, ...]}
|
translations |
The array with the articles translations. Use the API
get-articles to get the articles array.
Array syntax:
{ "es": [{"id": "", "title": "", "content": "", "link":"", "categories": []}, ...], "it": [...], ...}
|
{ "success": true, "response": true }
Returns the articles matching the search.
token |
Your admin secret token. |
function |
Enter search-articles. |
search |
The string to search. The search function supports title and content. |
articles_language |
Search only the articles in the language of the given language code. If there are no articles in the given language code, the search returns the articles in the default language. Set it to all to get all the translations. Default: false. |
{ "success": true, "response": [ { "id": "6P2Oq", "title": "What's new with the API V2?p", "content": "The API V2 is the new iteration of o ...", "link": "https://board.support", "categories": ["K92kl"] }, { "title": "Should I move to the new API?", "content": "Yes. The newest version (V2) of the Actions ...", "link": "https://board.support", "id": "qf7kD", "categories": ["K92kl"] }, ... ] }
Returns {"success":true, "response":[]} if no articles are found.
Returns an array with all the articles categories.
token |
Your admin secret token. |
function |
Enter get-articles-categories. |
{ "success": true, "response": [ { "id": "Nv9PG", "title": "Business" }, { "id": "csPVh", "title": "Travel And Tourism" }, { "id": "pl5S7", "title": "Finance" }, ... ] }
Saves or updates the articles categories array.
token |
Your admin secret token. |
function |
Enter save-articles-categories. |
categories |
Array of categories. Array syntax: [ { "id": "123456", "title": "Category name" }, { "id": "123456", "title": "Category name" }, ...]. Get the existing categories array with the method get-articles-categories. |
{ "success": true, "response": true }
Gets the ratings of an article or adds a new rating to it.
token |
Your admin secret token. |
function |
Enter article-ratings. |
article_id |
The ID of the article. |
rating |
The rating to add. Enter 1 for a positive rating or 0 for a negative one. If this argument is set the method adds the rating, otherwise returns the existing ratings. Default: false. |
{ "success": true, "response": "[-1, 1, 1, -1]" }
Returns true if the rating argument is set.
Sends an email to an existing user using the email templates of the Settings > Notifications area.
token |
Your admin secret token. |
function |
Enter send-email. |
recipient_id |
The ID of the user to which send the email. |
sender_id |
The ID of the sender user. |
message |
The message of the email. |
attachments |
Array of attachments in JSON format. Array syntax:[["name", "link"], ["name", "link"], ...]. Replace name with the name of the attachment and link with the full URL of the attachment. It's up to you to upload attachments to a remote server, this argument only accepts the URL of the files already uploaded. Default: []. |
{ "success": true, "response": true }
Other possible responses: missing-user-id-or-message, security-error, user-email-not-found, user-or-sender-not-found.
Sends a generic email to an email address. The sender email and name are the ones set in Settings > Notifications > Email settings.
token |
Your admin secret token. |
function |
Enter send-custom-email. |
to |
The email address. |
subject |
The email subject. |
message |
The message of the email. |
sender_suffix |
Append the provided text to the sender name. Default: empty. |
{ "success": true, "response": true }
Runs the email piping synchronization with Support Board and converts emails to chat messages.
token |
Your admin secret token. |
function |
Enter email-piping. |
force |
Set it to true to the execution of the synchronization, by default the synchronization is executed a maximum of one time per minute. Default: false. |
{ "success": true, "response": true }
Sends a text message to a user or agent. If the template argument is true, the message is translated automatically.
token |
Your admin secret token. |
function |
Enter send-sms. |
message |
The text message. |
to |
The phone number. Include the country code. |
template |
Set it to false to send only the message without the template content. Default: the message is sent within the template of Settings > SMS notifications. |
conversation_id |
Set it if the message contains the URL parameter {conversation_url_parameter}. |
attachments |
Array of attachment. Array syntax: [["name", "link"], ["name", "link"], ...] or ["link", "link", ...]. Replace name with the name of the attachment and link with the full URL of the attachment. It's up to you to upload attachments to a remote server, this argument only accepts the URL of the files already uploaded. Default: false. |
{ "success": true, "response": { "sid": "SM1f0e8ae6ade43cb3c0ce4525424e404f", "date_created": "Fri, 13 Aug 2010 01:16:24 +0000", "date_updated": "Fri, 13 Aug 2010 01:16:24 +0000", "date_sent": null, "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "to": "+15305431221", "from": "+15104564545", "body": "A Test Message", "status": "queued", "flags": [ "outbound" ], "api_version": "2010-04-01", "price": null, "uri": "/2010-04-01/Accounts/ACXXXX/Messages/SM1f004f.json" } }
Sends a Push notification to an agent, a group of agents, or all agents. Push notifications must be enabled in the settings area.
token |
Your admin secret token. |
function |
Enter push-notification. |
title |
The title of the notification. |
message |
The message text. |
interests |
The following values are accepted:
|
conversation_id |
The ID of the conversation to open when the user clicks the notification. |
icon |
The URL of the notification icon. Default: Support Board icon or notifications icon. |
{ "success": true, "response": { "id": "8b1c4e05-5e08-4926-86b0-a56ab7817e25", "external_id": null, "errors": {} } }
Returns false it the Push notifications are disabled in the settings area.
Returns the installed versions of Support Board and the Apps.
token |
Your admin secret token. |
function |
Enter get-versions. |
{ "success": true, "response": { "sb": "3.0.4", "dialogflow": "1.0.2", "slack": "1.0.3" } }
Starts the update of Support Board and all the apps. This method forces the update and always overwrite all plugin and apps files.
token |
Your admin secret token. |
function |
Enter update. |
{ "success": true, "response": "success" }
Starts the synchronization of the WordPress users and imports the new WordPress users into Support Board. This method is available only in the WordPress version.
token |
Your admin secret token. |
function |
Enter wp-synch . |
{ "success": true, "response": true }
Returns the License Key of a Support Board App like the Slack App or the Artificial Intelligence app.
token |
Your admin secret token. |
function |
Enter app-get-key . |
app_name |
The app name. E.g. dialogflow, slack, whatsapp, messenger... |
{ "success": true, "response": "9300AB16-014ZEE12-91E199EA-997CEX40" }
Activates an app, downloads it, and installs it.
token |
Your admin secret token. |
function |
Enter app-activation . |
app_name |
The app name. E.g. dialogflow, slack, whatsapp, messenger... |
key |
The License Key of the App. You can get the key with the function app-get-key. |
{ "success": true, "response": "success" }
Runs the cron jobs. For more details click here.
token |
Your admin secret token. |
function |
Enter cron-jobs |
{ "success": true, "response": true }
Triggers an avent on a Pusher channel.
token |
Your admin secret token. |
function |
Enter pusher-trigger |
channel |
The channel name. |
event |
The event name. |
data |
Array of values. Syntax: [ "name" => "value" ]. |
{ "success": true, "response": true }
Returns the CSS style for the chat colors.
token |
Your admin secret token. |
function |
Enter chat-css |
color_1 |
The first color in RGB or HEX format. Default: the first color saved in the settings area. |
color_2 |
The second color in RGB or HEX format. Default: the second color saved in the settings area. |
color_3 |
The third color in RGB or HEX format. Default: the third color saved in the settings area. |
The CSS code.
Converts the text formatting of chat messages to the equivalent HTML codes and returns the message.
token |
Your admin secret token. |
function |
Enter text-formatting-to-html |
message |
The text message. |
Lorem ipsum dolor <b>sit amet</b>, <i>consectetur adipiscing elit</i>, <code>sed</code> do eiusmod tempor incididunt.
Removes the text formatting from a chat messages.
token |
Your admin secret token. |
function |
Enter clear-text-formatting |
message |
The text message. |
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt.
Returns the internal notes of a conversation.
token |
Your admin secret token. |
function |
Enter get-notes |
conversation_id |
The conversation ID. |
{ "success": true, "response": [ { "id": 98207, "user_id": "1538", "name": "Lorem ipsum dolor sit amet", "message": "Lorem ipsum dolor sit amet, consectetur elit, sed do eiusmod tempor incididunt." }, { "id": 76986, "user_id": "1596", "name": "Lorem ipsum dolor", "message": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor." }, ... ] }
Adds a new note to a conversation.
token |
Your admin secret token. |
function |
Enter add-note |
conversation_id |
The conversation ID to which link the note to. |
user_id |
The ID of the agent or admin who create the note. |
name |
The note name. |
message |
The note message. |
{ "success": true, "response": 33560 }
Returns the node ID.
Deletes a note from a conversation.
token |
Your admin secret token. |
function |
Enter delete-note |
conversation_id |
The ID of the conversation linked to the note. |
note_id |
The note ID. |
{ "success": true, "response": true }
Returns all automations.
token |
Your admin secret token. |
function |
Enter automations-get |
[ { "emails": [ { "id": "0BOaG", "conditions": [ [ "datetime", "is-between", "10/04/2021 - 13/04/2021" ], [ "include_urls", "contains", "https://example.com" ], ... ], "name": "Excepteur sint", "message": "Excepteur sint occaecat cupidatat non proident.", "subject": "Cupidatat non proident" }, ... ], "sms": [ { "id": "vo2sY", "conditions": [ [ "datetime", "is-exactly", "13/04/2021" ] ], "name": "Excepteur sint", "message": "Excepteur sint occaecat cupidatat non caecat cupidatat non proident" }, { "id": "hwkmQ", "name": "Excepteur sint occaecat cupidatat non proident", "message": "Excepteur sint occaecat cupidatat non occaecat cupidatat non proident" }, ... ], "messages": [], "popups": [ { "id": "ckN24", "conditions": [ [ "user_type", "is-user" ], [ "languages", "en" ] ], "name": "s", "message": "Excepteur sint occaecat cupidatat non prcaecat cupidatat non proident", "title": "Excepteur sint occaecat", "profile_image": "https://example.com/image.jpg" }, ... ], "design": [ { "id": "bX1qA", "conditions": [ [ "user_type", "is-user" ] ], "name": "Excepteur sint", "message": "Excepteur sint occaecat cupidatat caecat cupidatat non proident", "title": "", "color_1": "rgb(0, 235, 26)", "color_2": "rgb(255, 0, 0)", "color_3": "rgb(255, 0, 0)", "background": "https://example.com/image.jpg", "brand": "https://example.com/image.jpg", "icon": "https://example.com/image.jpg" }, ... ] }, { "fr": { "messages": [ { "id": "y6hNE", "name": "XXXX", "message": "XXXX" } ] }, ... } ]
Saves all automations.
token |
Your admin secret token. |
function |
Enter automations-save |
automations |
Automations array. Get it from the automations-get function. |
translations |
Automations translations array. Get it from the automations-get function. |
{ "success": true, "response": true }
Validates an automation.
token |
Your admin secret token. |
function |
Enter automations-validate |
automation |
The automation. |
{ "conditions": [ [ "user_type", "is-user" ], ... ], "repeat_id": "" }
Returns only the client-side conditions and invalid server-side conditions that can be validated in a later time. If no conditions are returned, the automation is valid and can be executed. Returns false if the automation is invalid.
Validates all automations, executes the valid ones, and returns the automations with client-side conditions, invalid server-side conditions, and popup, design automations.
token |
Your admin secret token. |
function |
Enter automations-run-all |
[ { "id": "0BOaG", "conditions": [ [ "datetime", "is-between", "10/04/2021 - 13/04/2021" ], [ "include_urls", "contains", "https://example.com" ], ... ], "name": "Excepteur sint", "message": "Excepteur sint occaecat cupidatat non proident.", "subject": "Cupidatat non proident", "type": "emails" }, { "id": "bX1qA", "conditions": [ [ "user_type", "is-user" ] ], "name": "Excepteur sint", "message": "Excepteur sint occaecat cupidatat caecat cupidatat non proident", "title": "", "color_1": "rgb(0, 235, 26)", "color_2": "rgb(255, 0, 0)", "color_3": "rgb(255, 0, 0)", "background": "https://example.com/image.jpg", "brand": "https://example.com/image.jpg", "icon": "https://example.com/image.jpg", "type": "design" }, ... ]
Executes a single automation and optionally validates it before executing it.
token |
Your admin secret token. |
function |
Enter automations-run |
automation |
The automation. |
validate |
Set it to true to validate the automation before executing it. Default: false. |
{ "success": true, "response": true }
Checks if an automation has already been sent to a user.
token |
Your admin secret token. |
function |
Enter automations-is-sent |
user_id |
The ID of the user to check. |
automation |
The automation. It can be ["id" => 123] where 123 is the automation ID. |
repeat_id |
Set it only if the automation can be sent multiple times to the user. Get it from sb_automations_validate. Default: false. |
Returns true if the automation has already been sent, otherwise returns false.
This function performs the following tasks: Deletes visitors older than 24h, deletes messages in trash older than 30 days, archives messages with an agent reply as last message older than 24h.
token |
Your admin secret token. |
function |
Enter clean-data. |
{ "success": true, "response": true }
Returns the the specified reports.
token |
Your admin secret token. |
function |
Enter reports. |
name |
The report name. Available values: conversations, missed-conversations, conversations-time, visitors, leads, users, agents-response-time, agents-conversations, agents-conversations-time, agents-ratings, countries, languages, browsers, os, subscribe, follow-up, registrations, articles-searches, articles-ratings, articles-views-single, articles-views, sms-automations, email-automations, message-automations, direct-sms, direct-emails, direct-messages. |
date_start |
The start date of the reports. Format: dd/mm/yyyy or yyyy-mm-dd. Default: false. |
date_end |
The end date of the reports. Format: dd/mm/yyyy or yyyy-mm-dd. Default: false. |
date_end |
The timezone of the user who is calling this function, e.g. Europe/London. Default: false. |
{ "title": "Conversations count", "description": "Count of new conversations started by users.", "data": { "03/2021": [ 2 ], "04/2021": [ 0 ], "05/2021": [ 0 ], ... }, "table": [ "Date", "Count" ], "table-inverse": true, "label_type": 1, "chart_type": "line" }
Adds a new row to the sb_reports database table.
token |
Your admin secret token. |
function |
Enter reports-update. |
name |
The report name. Available values: conversations, missed-conversations, conversations-time, visitors, leads, users, agents-response-time, agents-conversations, agents-conversations-time, agents-ratings, countries, languages, browsers, os, subscribe, follow-up, registrations, articles-searches, articles-ratings, articles-views-single, articles-views, sms-automations, email-automations, message-automations, direct-sms, direct-emails, direct-messages. |
value |
The row value. Default: false. |
external_id |
An external ID. Default: false. |
extra |
An extr avalue. Default: false. |
{ "success": true, "response": true }
Checks if there are updates available for Support Board and the Support Board apps.
token |
Your admin secret token. |
function |
Enter updates-available. |
{ "success": true, "response": true }
Returns true if at least one update is available, otherwise returns false.
Adds a subscriber to the newsletter service set in Settings > Miscellaneous > Newsletter. The setting Settings > Miscellaneous > Newsletter > Active must be active.
token |
Your admin secret token. |
function |
Enter newsletter. |
|
|
The subscriber email address. |
first_name |
The subscriber first name. Default: empty. |
first_name |
The subscriber last name. Default: empty. |
Returns the newsletter service response.
Returns the Support Board uploads path.
token |
Your admin secret token. |
function |
Enter upload-path. |
url |
Set it to true to get the URL instead. Default: false. |
date |
Set it to true to get also the date folder relative to the current date. Default: false. |
{ "success": true, "response": "\var\www\htdocs\supportboard\uploads\10-03-23" }
{ "success": true, "response": "https://www.example.com/supportboard/uploads/10-03-23" }
Checks if uploading files with the specified file extension is allowed.
token |
Your admin secret token. |
function |
Enter is-allowed-extension. |
extension |
The file extension, e.g. jpg. |
{ "success": true, "response": true }
Returns true if the extension is allowed, otherwise returns false.
Checks if the host machine supports the Support Board system requirements.
token |
Your admin secret token. |
function |
Enter system-requirements. |
{ "success": true, "response": { "php-version": true, "zip-archive": true, "plugin-folder": true, "uploads-folder": true, "apps-folder": true, "languages-folder": true, "ajax": true, "curl": true, "UTF8mb4": true } }
Adds a log message to the log file.
token |
Your admin secret token. |
function |
Enter logs. |
string |
The log message. |
user |
Set it to include the user ID to the log message. This value can be ["id" => 123]. Default: false. |
{ "success": true, "response": true }
Uploads a file to Amazon S3, or delete a file from Amazon S3. Amazon S3 must be active and configured at Settings > Miscellaneous > Amazon S3.
token |
Your admin secret token. |
function |
Enter aws-s3. |
file_path |
The path to the file to upload or the Amazon S3 file URL for deleting a file. |
action |
Set it to PUT to upload a file. Set to DELETE to delete a file. Default: PUT. |
{ "success": true, "response": "https://example.s3.amazonaws.com/example.txt" }
Returns the URL of the Amazon S3 file.
The Artificial Intelligence app is required to use this set of APIs.
Sends a message to Dialogflow and returns the response.
token |
Your admin secret token. |
function |
Enter dialogflow-message. |
conversation_id |
The ID of a conversation. If provided, the response it added to the conversation as a new message. |
message |
The string containing the text of the message. |
attachments |
Array of attachments in JSON format. Array syntax: [["name", "link"], ["name", "link"], ...]. Replace name with the name of the attachment and link with the full URL of the attachment. Dialogflow can read this array. |
language |
The language of the bot. Default: the main bot language. |
event |
Trigger a Dialogflow event. |
parameters |
Array of optional information. Array syntax: { "name": "value", "name": "value", ...}. |
audio |
URL of an audio file for speech recognition. Default: false. |
token |
The Dialogflow access token. For performance reasons always include this token. You will get the token after the first call of this function, from the response. |
{ "success": true, "response": { "token": "ya29.a0AfH6SE4SVIeOPWSfxRVfHNcJIoR-IvRTtrEe4P9VXHa", "messages": [ { "message": "Hi! How are you doing?", "attachments": [] } ], "response": { "responseId": "1a5e30d0-d6d4-4f0c-83e3-2fb9e31c2a5e-e15c53b8", "queryResult": { "queryText": "Hello", "action": "input.welcome", "parameters": [], "allRequiredParamsPresent": true, "fulfillmentText": "Hi! How are you doing?", "fulfillmentMessages": [ { "platform": "ACTIONS_ON_GOOGLE", "simpleResponses": {"simpleResponses": [ { "textToSpeech": "Example"} ]} }, { "text": { "text": [ "Hi! How are you doing?" ] } } ], "intent": { "name": "projects/api-project-657752147/agent/intents/fe27e-f39d-4db3-92c2", "displayName": "Default Welcome Intent" }, "intentDetectionConfidence": 1, "languageCode": "en" }, "alternativeQueryResults": [ { "queryText": "Hello", "languageCode": "en" } ] } } }
Other possible responses: dialogflow-not-active, MySQL, or cURL error message.
Returns the specified Dialogflow Intent or all Intents.
token |
Your admin secret token. |
function |
Enter dialogflow-get-intents . |
intent_name |
The intent name. |
language |
The agent language. Default: the main agent language. |
[ { "name": "projects/example/agent/intents/1655ee2c-8116-45f1-95fu-93700ff32e8d", "displayName": "Default Welcome Intent", "priority": 500000, "mlEnabled": true, "events": [ "WELCOME" ], "trainingPhrases": [ { "name": "43ca0e72-6055-4b88-af13-b0d241", "type": "EXAMPLE", "parts": [ { "text": "just going to say hi" } ] }, { "name": "5159aabc-8524-404f-b679-f2228db1", "type": "EXAMPLE", "parts": [ { "text": "Hello" } ] }, ... ], "action": "input.welcome", "messages": [ { "text": { "text": [ "Hi! How are you doing?", "Hello! How can I help you?" ] } } ] }, ... ]
Creates a new Intent in Dialogflow. The new Intent will be linked the agent synchronized in the admin area.
token |
Your admin secret token. |
function |
Enter dialogflow-create-intent . |
expressions |
Array with the training phrases. Array syntax: ["", "", ...]. |
response |
String containing the response of the bot when the user input matches a user expression. |
agent_language |
The language code of the intent. Default: main agent language. For the languages codes list visit cloud.google.com/dialogflow/docs/reference/language. Default: false. |
{ "success": true, "response": true }
Updates a Dialogflow Intent.
token |
Your admin secret token. |
function |
Enter dialogflow-update-intent . |
intent_name |
The Intent name. Get it with the function dialogflow-get-intents. |
expressions |
Array with the training phrases. Array syntax: ["", "", ...]. |
agent_language |
The language code of the intent. Default: main agent language. For the languages codes list visit cloud.google.com/dialogflow/docs/reference/language. Default: false. |
{ "success": true, "response": true }
Creates a new Entity in Dialogflow. The new Entity will be linked the agent synchronized in the admin area.
token |
Your admin secret token. |
function |
Enter dialogflow-entity . |
entity_name |
The unique Entity name. |
synonyms |
Array of Entity values. Single value syntax: ['value' => '', 'synonyms' => ['', '', ...]]. |
agent_language |
The language code of the intent. For the languages codes list visit cloud.google.com/dialogflow/docs/reference/language. Default: false. Default: false. |
{ "success": true, "response": true }
Returns a Dialogflow Entity, or all Entities of the agent.
token |
Your admin secret token. |
function |
Enter dialogflow-get-entity . |
entity_id |
The ID of the Entity. Leave empty or insert all to get all Entities. Default: all. |
agent_language |
The language code of the intent. For the languages codes list visit cloud.google.com/dialogflow/docs/reference/language. Default: false. |
{ "success": true, "response": { "name":"projects/small-talk-43da7/agent/entityTypes/t5td1425-2k13-16cc-a7bb-f119b8d94112a", "displayName":"woocommerce-products", "kind":"KIND_MAP", "autoExpansionMode":"AUTO_EXPANSION_MODE_DEFAULT", "entities":[ { "value":"Abstract Print Cotton Blouse", "synonyms":[ "Abstract Print Cotton Blouse" ] }, { "value":"Cashmere Carpenter Beanie", "synonyms":[ "Cashmere Carpenter Beanie" ] }, ... ], "enableFuzzyExtraction":true } }
Generates a new Dialogflow Token and returns it. The token is valid for 1 hour.
token |
Your admin secret token. |
function |
Enter dialogflow-get-token . |
{ "success": true, "response": "ya27.a1AfH6SMDu9dn0TfRbNVAIEsSoeJPD1_jr1JpfL15..." }
Returns the details of the Dialogflow agent.
token |
Your admin secret token. |
function |
Enter dialogflow-get-agent . |
{ "success": true, "response": { "parent":"projects/woocommerce-abcde", "displayName": "ABCDE", "defaultLanguageCode": "en", "timeZone": "Europe/Madrid", "enableLogging": true, "matchMode": "MATCH_MODE_HYBRID" , "classificationThreshold": 0.6, "apiVersion": "API_VERSION_V2", "tier": "TIER_STANDARD" } }
Activates a Dialogflow context in the active user session.
token |
Your admin secret token. |
function |
Enter dialogflow-set-active-context . |
context_name |
The context name. |
user_id |
The ID of the user linked to the context. |
parameters |
Array of Dialogflow parameters linked to the context. Example: { "woocommerce-products": "Running Shoes" }. |
life_span |
The context lifespan. Default: 5. |
token |
Dialogflow Session Token(it's not the Refresh Token). Pass it if you have it, otherwise it will be generated. Default: false. |
language |
The agent language. Default: main agent language. |
{ "success":true, "response": { "responseId":"09f2f825-3dbf-4c27-a5bb-6bd0b71e44b9-1d846bd2", "queryResult":{ "queryText":"sb-trigger-context", "parameters":[ ], "outputContexts":[ { "name":"projects/abcde/agent/sessions/208/contexts/abcde", "lifespanCount":4, "parameters":{ "woocommerce-products":"Sampras Vibration Dampener" } } ], "languageCode":"en" } } }
Sends data to Dialogflow. Use this method to submit the queries to Dialogflow.
token |
Your admin secret token. |
function |
Enter dialogflow-curl . |
query |
The Dialogflow query in JSON format. |
language |
The Dialogflow agent language. Default: false. |
type |
The call type. Supported values: POST, GET, PATCH. Default: POST. |
token |
Dialogflow Session Token(it's not the Refresh Token). Pass it if you have it, otherwise it will be generated. Default: false. |
{ "success": true, "response": "..." }
Returns the Dialogflow response. More details at https://cloud.google.com/dialogflow/es/docs/reference/rest/v2-overview
Triggers the Dialogflow human takeover.
token |
Your admin secret token. |
function |
Enter dialogflow-human-takeover . |
conversation_id |
The conversation ID. |
auto_messages |
Set it to true to send also offline, follow_up and subscribe messages if they are active. Default: false. |
{ "success": true, "response": [true, true, ...] }
Returns the smart reply suggestions.
token |
Your admin secret token. |
function |
Enter dialogflow-smart-reply. |
conversation_id |
|
message |
The text message from which generate the suggestions. |
dialogflow_language |
The Dialogflow agent language. Defualt: false. |
token |
The Dialogflow access token. Default: false. |
conversation_id |
Set it to enable the OpenAI suggestions. Default: false. |
{ "suggestions": [ "I would be happy to help!", "What can I do for you?", ... ], "token": "ya29.a0AVvZVsrU7gAannWzuztBR-AphpjdWr0JrPoq9au0Ai", "detected_language": false, "smart_reply": false }
Sends a message to OpenAI and return the response, optionally add the response to an existing conversation as a new message.
token |
Your admin secret token. |
function |
Enter open-ai-message. |
message |
The string containing the text of the message. |
max_tokens |
The max number of OpenAI tokens that can be used to generate the message. This parameter changes the response message length. Default: false. If this parameter is false the default value is the one saved in Settings > Dialoglfow > OpenAI > Max tokens, otherwise, if the active model is gpt-3.5-turbo, default is false, otherwise is 100. |
model |
The OpenAI model. Default: false. If this parameter is false the default value is the one saved in Settings > Dialoglfow > OpenAI > Model, otherwise is gpt-3.5-turbo. |
conversation_id |
The ID of the conversation. It set, the OpenAI response is added to an existing conversation as a new message. Default: false. |
audio |
URL of an audio file for speech recognition. Default: false. |
{ "success": true, "response": [ true, "I am an AI digital assistant. How can I help you today?", false, false ] }
Return an array with the first value set to true on success, false on error. The second value is the OpenAI message on success, or the error message on error.
Calls the OpenAI API (ChatGPT) and return the response.
token |
Your admin secret token. |
function |
Enter open-ai-curl . |
url_part |
The URL part of the API. For example, if you want to call https://api.openai.com/v1/completions, enter only completions. |
post_fields |
The parameters of the API in JSON format. |
type |
The HTTP call type. Allowed values: GET, POST, UPLOAD. |
{ "success": true, "response": "..." }
Returns the openAI response. More details at https://beta.openai.com/docs/api-reference/.
Translates multiple strings via Google Translate.
token |
Your admin secret token. |
function |
Enter google-translate. |
strings |
Array of the strings to translate, e.g. ["Hello world", "How are you?"]. |
language_code |
The two-letter language code of the language you want to translate into. For Traditional Chinese use zt, for Simplified Chinese use zh, for Brazilian Portuguese use pt. |
{ "success": true, "response": [ [ "Ciao mondo", "Come stai?", ...], "ya29.a0AVvZVsqVHw9U7LxFukwIoQEfwA3JyT_2SSRnP2nX4oQ_XyMP9GQk2O" ] }
Detects the language of a text and assign it to a user.
token |
Your admin secret token. |
function |
Enter google-language-detection-update-user. |
string |
The text from which to detect the language. |
user_id |
The user ID. |
{ "success": true, "response": true }
The WhatsApp app is required to use this set of APIs.
Sends a message to a WhatsApp number.
token |
Your admin secret token. |
function |
Enter whatsapp-send-message. |
to |
The recipient's phone number. Include the country code. E.g. +39321305455 |
message |
The message. |
attachments |
Array of attachments in JSON format. Array syntax: [["name", "link"], ["name", "link"], ...]. Replace name with the name of the attachment and link with the full URL of the attachment. It's up to you to upload attachments to a remote server, this argument only accepts the URL of the files already uploaded. Default: []. |
phone_id |
The phone number ID. Get it from Settings > WhatsApp. This setting is required only if you have synched multiple WhatsApp numbers. Default: false. |
{ "success": true, "response": { "messaging_product": "whatsapp", "contacts": [ { "input": "+16315551234", "wa_id": "+16315551234" } ], "messages": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI3N0EyQUJDMjFEQzZCQUMzODMA" } ] } }
The Messenger app is required to use this set of APIs.
Sends a message to Messenger or Instagram.
token |
Your admin secret token. |
function |
Enter messenger-send-message. |
psid |
The PSID. To get this information, the user must first send you a message through Facebook. Get it by using the get-user function. |
facebook_page_id |
The Facebook Page ID. To get this information, the user must first send you a message through Facebook. Get it by using the get-conversation function. The ID is the extra value. |
message |
The message. |
attachments |
Array of attachments in JSON format. Array syntax: [["name", "link"], ["name", "link"], ...]. Replace name with the name of the attachment and link with the full URL of the attachment. It's up to you to upload attachments to a remote server, this argument only accepts the URL of the files already uploaded. Default: []. |
metadata |
Provide the Support Board message ID linked to this message. Always include it when possible to avoid issues. Default: false. |
{ "success": true, "response": { "recipient_id": "89995542233", "message_id": "11445777889" } }
The Telegram app is required to use this set of APIs.
Sends a message to Telegram.
token |
Your admin secret token. |
function |
Enter telegram-send-message. |
chat_id |
The Chat ID. To get this information, the user must first send you a message through Telegram. Get it by using the get-conversation function. The ID is the extra value. |
message |
The message. |
attachments |
Array of attachments in JSON format. Array syntax: [["name", "link"], ["name", "link"], ...]. Replace name with the name of the attachment and link with the full URL of the attachment. It's up to you to upload attachments to a remote server, this argument only accepts the URL of the files already uploaded. Default: []. |
conversation_id |
This setting is required only if you have synched multiple Telegram bots. Default: false. |
{ "success": true, "response": { "ok": true, "result": { "message_id": 2030, "from": { "id": 21202173, "is_bot": true, "first_name": "Support Board", "username": "sb_officialbot" }, "chat": { "id": 148766722, "first_name": "Federico", "last_name": "Schiocchet", "username": "federicoschiocchet", "type": "private" }, "date": 1699621061, "text": "Hello!" } } }
The Viber app is required to use this set of APIs.
Sends a message to Viber.
token |
Your admin secret token. |
function |
Enter viber-send-message. |
viber_id |
The Viber ID. To get this information, the user must first send you a message through Telegram. Get it by using the get-user function. |
message |
The message. |
attachments |
Array of attachments in JSON format. Array syntax: [["name", "link"], ["name", "link"], ...]. Replace name with the name of the attachment and link with the full URL of the attachment. It's up to you to upload attachments to a remote server, this argument only accepts the URL of the files already uploaded. Default: []. |
{ "status":0, "status_message":"ok", "message_token":5741311803571721087, "chat_hostname":"SN-CHAT-05_", "billing_status":1 }
The Google Business Messages app is required to use this set of APIs.
Sends a message to Google Business Messages.
token |
Your admin secret token. |
function |
Enter gbm-send-message. |
google_conversation_id |
The Google ID. To get this information, the user must first send you a message through Google Business Messages. Get it by using the get-user function. |
message |
The message. |
attachments |
Array of attachments in JSON format. Array syntax: [["name", "link"], ["name", "link"], ...]. Replace name with the name of the attachment and link with the full URL of the attachment. It's up to you to upload attachments to a remote server, this argument only accepts the URL of the files already uploaded. Default: []. |
token |
The Google token. Get it from the response of this function. Always include it when possible for performance reasons. Default: false. |
[ "{...}", [ "{...}" ], "5741311803571721087" ]
The first array element is the response, the second element is the response of the attachments sending, if any, the last element is the token.
The LINE app is required to use this set of APIs.
Sends a message to LINE.
token |
Your admin secret token. |
function |
Enter line-send-message. |
line_id |
The LINE ID. To get this information, the user must first send you a message through LINE. Get it by using the get-user function. |
message |
The message. |
attachments |
Array of attachments in JSON format. Array syntax: [["name", "link"], ["name", "link"], ...]. Replace name with the name of the attachment and link with the full URL of the attachment. It's up to you to upload attachments to a remote server, this argument only accepts the URL of the files already uploaded. Default: []. |
{ "sentMessages": [ { "id": "481156985669026149", "quoteToken": "fKOxH1EKOAKYFLW6fe8vFGoKl2I2UZocU6KcoZgwtVrSTQjLbXFVer3Z-UV-aNkxE5BAct3WZOJpHBxEQavyVfkmsVMSou2KBNSFSEwtwuGkDwzEiUNsJ4V9WBR_leJef0KCxvP-OO1Ma5mxmt4rXg" } ] }
The WeChat app is required to use this set of APIs.
Sends a message to WeChat.
token |
Your admin secret token. |
function |
Enter wechat-send-message. |
open_id |
The WeChat ID. To get this information, the user must first send you a message through LINE. Get it by using the get-user function. |
message |
The message. |
attachments |
Array of attachments in JSON format. Array syntax: [["name", "link"], ["name", "link"], ...]. Replace name with the name of the attachment and link with the full URL of the attachment. It's up to you to upload attachments to a remote server, this argument only accepts the URL of the files already uploaded. Default: []. |
token |
The Google token. Get it from the response of this function. Always include it when possible for performance reasons. Default: false. |
[ "{...}", "5741311803571721087" ]
The first array element is the response, the second element is the token.
The Slack app is required to use this set of APIs.
Sends a message to Slack.
token |
Your admin secret token. |
function |
Enter send-slack-message. |
user_id |
The ID of the user linked to the message. |
full_name |
The name of the sender, it will appear in Slack on the left of the message. It should be an agent's name if the message is from an agent, otherwise the user's name. |
profile_image |
The profile image of the sender, it will appear in Slack on the left of the message. It should be an agent's profile image if the message is from an agent, otherwise the user's profile image. Supported formats: PNG and JPG. Default: |
message |
The content of the message. |
attachments |
Array of attachments in JSON format. Array syntax: [["name", "link"], ["name", "link"], ...]. Replace name with the name of the attachment and link with the full URL of the attachment. It's up to you to upload attachments to a remote server, this argument only accepts the URL of the files already uploaded. Default: []. |
channel |
The Slack channel linked to the message. For performance reasons always include the channel. You will get the channel after the first call of this function, from the response (example: C011JFFGSKY). |
{"success":true,"response":["C011JFFGSKY"]}
Other possible responses: slack-not-active, MySQL or cURL error message.
Archives all the Slack channels. If you have a lot of channels, this operation may take a long time to complete and you could need to execute it again multiple times. Important: All of your slack channels will be archived.
token |
Your admin secret token. |
function |
Enter archive-slack-channels. |
{ "success": true, "response": true }
Returns the agents-slack members' connection information.
token |
Your admin secret token. |
function |
Enter slack-users. |
{ "success": true, "response": { "slack_users": [ { "id": "U328T701Z", "name": "Support Schio" }, { "id": "UR5F0GK7T", "name": "Robert Pitt" } ... ], "agents": [ { "id": "2", "name": "Alex Smith" }, { "id": "445", "name": "Federico Schiocchet" }, { "id": "724", "name": "Alberto Prade" } ... ], "saved": { "U328T701Z": "445", "UR5F0GK7T": "2" ... } } }
Checks if a Slack agent is online, or if at least one agent is online, or returns all the online users.
token |
Your admin secret token. |
function |
Enter slack-presence. |
agent_id |
The ID of the agent to check. Default: false. |
list |
Set it to true to return all online users. Default: false. |
{ "success": true, "response": online }
Returns online or offline for single agent check. Returns an array of user IDs for multiple users check.
Returns the list of all Slack channels, including archived channels.
token |
Your admin secret token. |
function |
Enter slack-channels. |
{
"ok": true,
"channels": [
{
"id": "C012AB3CD",
"name": "general",
"is_channel": true,
"is_group": false,
"is_im": false,
"created": 1449252889,
"creator": "U012A3CDE",
"is_archived": false,
"is_general": true,
"unlinked": 0,
"name_normalized": "general",
"is_shared": false,
"is_ext_shared": false,
"is_org_shared": false,
"pending_shared": [],
"is_pending_ext_shared": false,
"is_member": true,
"is_private": false,
"is_mpim": false,
"updated": 1678229664302,
"topic": {
"value": "Company-wide announcements and work-based matters",
"creator": "",
"last_set": 0
},
"purpose": {
"value": "This channel is for team-wide communication and announcements. All team members are in this channel.",
"creator": "",
"last_set": 0
},
"previous_names": [],
"num_members": 4
},
{
"id": "C061EG9T2",
"name": "random",
"is_channel": true,
"is_group": false,
"is_im": false,
"created": 1449252889,
"creator": "U061F7AUR",
"is_archived": false,
"is_general": false,
"unlinked": 0,
"name_normalized": "random",
"is_shared": false,
"is_ext_shared": false,
"is_org_shared": false,
"pending_shared": [],
"is_pending_ext_shared": false,
"is_member": true,
"is_private": false,
"is_mpim": false,
"updated": 1678229664302,
"topic": {
"value": "Non-work banter and water cooler conversation",
"creator": "",
"last_set": 0
},
"purpose": {
"value": "A place for non-work-related flimflam, faffing, hodge-podge or jibber-jabber you'd prefer to keep out of more focused work-related channels.",
"creator": "",
"last_set": 0
},
"previous_names": [],
"num_members": 4
}
],
"response_metadata": {
"next_cursor": "dGVhbTpDMDYxRkE1UEI="
}
}
Webhook sent when a message is sent to Slack.
{ "function": "slack-message-sent", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": { "message": "Hi! How are you doing?", "conversation_id": "1057", "slack_channel": "C028BGU6TTT" } }
The WooCommerce app is required to use this set of APIs.
Returns the details of a WooCommerce customer.
token |
Your admin secret token. |
function |
Enter woocommerce-get-customer . |
session_key |
Get it with the method woocommerce-get-session-key. |
{ "success": true, "response": { "customer_id": "1", "user_id": null, "username": "", "first_name": "Don", "last_name": "John", "email": "email@example.com", "date_last_active": "2020-08-03 07:21:18", "date_registered": null, "country": "UK", "postcode": "E14HR", "city": "London", "state": "London" } }
Returns an array with the orders summary of the user.
token |
Your admin secret token. |
function |
Enter woocommerce-get-user-orders . |
user_id |
The user ID. |
{ "success": true, "response": [ { "id": "603", "date": "2020-10-22 14:58:11", "total": "19", "status": "wc-processing" }, { "order_id": "602", "date": "2020-10-19 14:02:35", "total": "19", "status": "wc-on-hold", }, ... ] }
Returns the details of an order.
token |
Your admin secret token. |
function |
Enter woocommerce-get-order . |
order_id |
The order ID. |
{ "success": true, "response": { "id": "601", "date": "2020-10-19 14:02:10", "total": "19", "status": "wc-on-hold", "products": [ { "name": "Sony Play Station 5", "id": "53", "quantity": "1", "price": "199" } ], "billing_address": "Don John\\n501 Baker Street\\nEW578H London, UK", "shipping_address": "", "currency_symbol": "€" } }
Returns the details of a product.
token |
Your admin secret token. |
function |
Enter woocommerce-get-product . |
product_id |
The product ID. |
{ "success": true, "response": { "id": "53", "name": "Sony Play Station 5", "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elite...", "price": "19", "image": "https://example.com/image.jpg", "rating": "", "url": "https://example.com/?p=53" } }
Returns the products matching the given query if any, otherwise returns all products.
token |
Your admin secret token. |
function |
Enter woocommerce-get-products . |
filters |
Array of filters. Syntax:
[ "filter" => "value", "filter" => "value", ... ].
Use filters to only get products that match specific criteria. Available filters:
|
pagination |
Limit the number of results to 100. Set it to 0 to get the products from 1 to 100, to 1 to get the products from 101 to 200... |
language |
The products language code. Default: false. |
{ "success": true, "response": [ { "id": "53", "name": "Sony Play Station 5", "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elite...", "date": "2020-08-03 07:06:25", "price": "19", "image": "https://example.com/image.jpg", "rating": "", "url": "https://example.com?p=53" }, { "id": "54", "name": "Xbox Series X", "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elite...", "date": "2020-08-03 07:08:19", "price": "59", "image": "https://example.com/image.jpg", "rating": "", "url": "https://example.com?p=54" }, ... ] }
Returns the products matching the search.
token |
Your admin secret token. |
function |
Enter woocommerce-search-products . |
search |
The search string. |
{ "success": true, "response": [ { "id": "53", "name": "Sony Play Station 5", "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elite...", "date": "2020-08-03 07:06:25", "price": "19", "image": "https://example.com/image.jpg", "rating": "", "url": "https://example.com?p=53" }, { "id": "54", "name": "Xbox Series X", "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elite...", "date": "2020-08-03 07:08:19", "price": "59", "image": "https://example.com/image.jpg", "rating": "", "url": "https://example.com?p=54" }, ... ] }
Returns the WooCommerce product categories or tags.
token |
Your admin secret token. |
function |
Enter woocommerce-get-taxonomies . |
type |
Enter category or tag. |
language |
The language code of the taxonomies. Default: false. |
{ "success": true, "response": [ { "id": "33", "name": "Clothes", "slug": "clothes" }, { "id": "34", "name": "Accessories", "slug": "accessories" }, ... ] }
Returns the WooCommerce product attributes and attribute terms.
token |
Your admin secret token. |
function |
Enter woocommerce-get-attributes . |
type |
Set it to terms to get only the terms name of all attributes, and to attribute to get only the attributes name. Default: all. |
language |
The language code of the attributes. Default: false. |
{ "success": true, "response": { "colors": { "id": "1", "name": "Color", "slug": "pa_color", "terms": { "red": "Red", "yellow": "Yellow", "green": "Green", ... } }, ... } }
{ "success": true, "response": [ { "name": "Red" }, { "name": "Yellow" }, { "name": "Small" }, { "name": "Medium" }, { "name": "Large" }, ... ] }
{ "success": true, "response": [ { "id": "1", "name": "Color", "slug": "pa_color" }, { "id": "2", "name": "Size", "slug": "pa_size" }, ... ] }
Searches for a product by name and returns its ID.
token |
Your admin secret token. |
function |
Enter woocommerce-get-product-id-by-name . |
name |
The product name. |
{ "success": true, "response": 123 or false }
Returns an array with the images of a product.
token |
Your admin secret token. |
function |
Enter woocommerce-get-product-images . |
product_id |
The product ID. |
{ "success": true, "response": [ "https://example.com/image.jpg", "https://example.com/image.jpg", ... ] }
Returns the categories and tags of a product.
token |
Your admin secret token. |
function |
Enter woocommerce-get-product-taxonomies . |
product_id |
The product ID. |
{ "success": true, "response": [ { "term_id": "34", "name": "Red", "slug": "red", "term_group": "0", "taxonomy": "product_cat" }, { "term_id": "35", "name": "Summer Edition", "slug": "summer-edition", "term_group": "0", "taxonomy": "product_tag" }, ... ] }
Returns the attribute of an attribute term.
token |
Your admin secret token. |
function |
Enter woocommerce-get-attribute-by-term . |
term_name |
The term name. |
{ "success": true, "response": { "id": "1", "name": "Color", "slug": "pa_color" } }
Searches for an attribute by its name and returns it.
token |
Your admin secret token. |
function |
Enter woocommerce-get-attribute-by-name . |
name |
The attribute name. |
{ "success": true, "response": { "id": "1", "name": "Color", "slug": "pa_color" } }
Checks if a product is in stock.
token |
Your admin secret token. |
function |
Enter woocommerce-is-in-stock . |
product_id |
The product ID. |
{ "success": true, "response": true or false }
Generates a coupon and returns the coupon code.
token |
Your admin secret token. |
function |
Enter woocommerce-coupon . |
discount |
Discount percentage. Enter a value from 1 to 100. |
expiration |
Coupon expiration. Example: 3 days, 1 minutes, 60 seconds. |
product_id |
String of IDs separated by commas. Example: 11,53,63. If setted the coupon is valid only for the products with the given IDs. |
user_id |
If setted the coupon is valid only for the user with the given ID. |
{ "success": true, "response": [ "fxsocl3490oq", "50" ] }
[ coupon code, discount value ]
Check sif there are coupons linked to the given user.
token |
Your admin secret token. |
function |
Enter woocommerce-coupon-check . |
user_id |
The user ID. |
{ "success": true, "response": true or false }
Returns true if there are coupons linked to the user, otherwise returns false.
Deletes all expired coupons. This function runs automatically every hour via cron jobs.
token |
Your admin secret token. |
function |
Enter woocommerce-coupon-delete-expired . |
{ "success": true, "response": true }
Returns a WooCommerce URL.
token |
Your admin secret token. |
function |
Enter woocommerce-get-url . |
type |
The URL type to get. Accepted values: tag, category, cart, shop, , checkout. |
name |
The name of the category or link. |
language |
The language of the page of the URL. Default: false. |
{ "success": true, "response": "https://example.com/checkout" }
Returns the session variable of a user. The session variable contains the user cart details and more.
token |
Your admin secret token. |
function |
Enter woocommerce-get-session . |
session_key |
The session key of a user. Get it with the method woocommerce-get-session-key. |
{ "success": true, "response": { "cart": { "d82c8d1619ah8176d665453cfb2e66f0": { "key": "d82c8d1619ah8176d665453cfb2e66f0", "product_id": 53, "variation_id": 0, "variation": [], "quantity": 3, "data_hash": "b5c1d6ca8bae6d4896jf1807cdf713f0", "line_tax_data": { "subtotal": [], "total": [] }, "line_subtotal": 57, "line_subtotal_tax": 0, "line_total": 57, "line_tax": 0 } }, "cart_totals": { "subtotal": "57.00", "subtotal_tax": 0, "shipping_total": "0.00", "shipping_tax": 0, "shipping_taxes": [], "discount_total": 0, "discount_tax": 0, "cart_contents_total": "57.00", "cart_contents_tax": 0, "cart_contents_taxes": [], "fee_total": "0.00", "fee_tax": 0, "fee_taxes": [], "total": "57.00", "total_tax": 0 }, "applied_coupons": "a:0:{}", "coupon_discount_totals": "a:0:{}", "coupon_discount_tax_totals": "a:0:{}", "removed_cart_contents": "a:0:{}", "customer": { "id": "1", "date_modified": "2020-08-20T09:33:03+00:00", "postcode": "", "city": "", "address_1": "", "address": "", "address_2": "", "state": "", "country": "", "shipping_postcode": "", "shipping_city": "", "shipping_address_1": "", "shipping_address": "", "shipping_address_2": "", "shipping_state": "", "shipping_country": "", "is_vat_exempt": "", "calculated_shipping": "", "first_name": "", "last_name": "", "company": "", "phone": "", "email": "", "shipping_first_name": "", "shipping_last_name": "", "shipping_company": "" } } }
Returns the session key of a user.
token |
Your admin secret token. |
function |
Enter woocommerce-get-session-key . |
user_id |
The user ID. |
{ "success": true, "response": "f96ab7c6da236e6754d" }
Returns the available payment methods of the shop.
token |
Your admin secret token. |
function |
Enter woocommerce-payment-methods . |
{ "success": true, "response": [ "Direct bank transfer", "Check payments", "Cash on delivery", "Alipay", "Multibanco", "Credit Card (Stripe)" ] }
Returns the shop shipping locations, or checks if the shop ships to a specific location.
token |
Your admin secret token. |
function |
Enter woocommerce-shipping-locations . |
country_code |
A country code. If provided checks if the shop ships to the country of the given given code. Default: false. |
{ "success": true, "response": [ "Australia, Italy, United States, ...", [ [ "Australia", "AU" ], [ "Italy", "IT" ], [ "United States", "US" ], ... ], false ] }
The last array value is true if the shop does not ship to the returned countries.
Webhooks are automated messages sent from Support Board to a URL when something happens. They contain custom data and are sent to a unique URL defined by you.
Do you need a Webhook that is not yet available? Contact us and we will add it!
Webhook sent when a new message is sent by a user or an agent.
{ "function": "message-sent", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": { "user_id": "947", "conversation_user_id": "947", "conversation_id": "1057", "conversation_status_code": "2", "conversation_source": "wa", "message_id": "2574", "message": "Hello! How are you?", "attachments": [["name","https://example.com/image.png"],["name","https://example.com/file.txt"]] } }
Webhook sent when a notification email is sent to a user or to an agent.
{ "function": "email-sent", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": { "recipient_id": "957", "message": "Hello! How can I help you?", "attachments": [["name","https://example.com/image.png"],["name","https://example.com/file.txt"]] } }
Webhook sent when a new text message is sent by a user or an agent.
{ "function": "sms-sent", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": { "recipent_id": "947", "message": "Hello! How are you?", "Body": "Hello! How are you?", "From": "+15104564545", "To": "+15305431221", "response": { "sid": "SM1f0e8ae6ade43cb3c0ce4525424e404f", "date_created": "Fri, 13 Aug 2010 01:16:24 +0000", "date_updated": "Fri, 13 Aug 2010 01:16:24 +0000", "date_sent": null, "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "to": "+15305431221", "from": "+15104564545", "body": "A Test Message", "status": "queued", "flags":["outbound"], "api_version": "2010-04-01", "price": null, "uri": "/2010-04-01/Accounts/ACXXXX/Messages/SM1f004f.json" } } }
Webhook sent when new messages are received in the chat widget or the admin area.
{ "function": "new-messages", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": { "details": { "message": "Hello world!", "message_id": "10231", "attachments": "", "payload": "", "message_status_code": "0", "last_update_time": "2024-04-02 16:57:19", "message_user_id": "1964", "message_first_name": "Don", "message_last_name": "John", "message_profile_image": "https://example.com/image.jpg", "message_user_type": "admin", "department": null, "agent_id": null, "title": "", "source": null, "extra": null, "tags": null, "id": "4607", "user_id": "4747", "creation_time": "2024-04-02 16:57:17", "status_code": "1" }, "messages": [ { "details": { "message": "Hello world!", "attachments": "", "payload": {}, "status_code": "0", "id": "10231", "profile_image": "https://example.com/image.jpg", "first_name": "Don", "last_name": "John", "user_id": "1964", "user_type": "admin", "full_name": "Don John", "creation_time": "2024-04-02 16:57:19" } } ] } }
Webhook sent when the Dialogflow send a reply to a user message.
{ "function": "dialogflow-message", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": { "response": { "token": "ya29.a0Afkjh8MADFYeT4BgCy3917xqSDdVvw4mgVHrgrLDcgRk9ajWoQAgdjv5e...", "messages": [ { "message": "Hi! How are you doing?" } ], "response": { "responseId": "46d2c208-2a7f-4ca2-bd7d-6636982b8bee-0f0e27e1", "queryResult": { "queryText": "hi", "action": "input.welcome", "allRequiredParamsPresent": "true", "fulfillmentText": "Hi! How are you doing?", "fulfillmentMessages": [ { "text": { "text": [ "Hi! How are you doing?" ] } } ], "outputContexts": [ { "name": "projects/api-project-655517752147/agent/sessions...", "lifespanCount": "1", "parameters": { "no-input": "0", "no-match": "0" } } ], "intent": { "name": "projects/api-project-655517752147/agent/intents...", "displayName": "Default Welcome Intent" }, "intentDetectionConfidence": "1", "languageCode": "en" }, "alternativeQueryResults": [ { "queryText": "hi", "outputContexts": [ { "name": "projects/api-project-655517752147/agent...", "parameters": { "no-match": "1", "no-input": "0" } } ], "languageCode": "en" } ] } }, "message": "Hello", "conversation_id": 123456 } }
Webhook sent when a message is deleted.
{ "function": "message-deleted", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": "2595" }
The data key contains the ID of the deleted message.
Webhook sent when the user press the submit button and the values entered in the Rich Message are sent to Support Board. All Rich Messages that require the submitting of data fire this Webhook, some of them are the follow-up email form, the registration form, the buttons.
{ "function": "rich-message", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": { "result": true, "data": { "type": "inputs", "result": { "name": [ "Don Jhon", "Name" ], "your-email": [ "example@gmail.com", "Your Email" ], "site-url": [ "www.example.com", "Site URL" ] } }, "id": "example" } }
Webhook sent when a new conversation is received in the user's chat widget.
{ "function": "new-conversation-received", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": { "messages": [ { "id": "10222", "user_id": "4746", "message": "Hi there!", "creation_time": "2024-04-02 07:26:18", "attachments": "", "status_code": "0", "payload": "", "conversation_id": "4605", "first_name": "User", "last_name": "#19332", "profile_image": "https://example.com/image.png", "user_type": "lead" }, { "id": "10223", "user_id": "377", "message": "How are you?", "creation_time": "2024-04-02 07:26:22", "attachments": "", "status_code": "2", "payload": "{\"follow_up_message\":true,\"preview\":\"Preview text!\"]\"}", "conversation_id": "4605", "first_name": "Smart Assistant", "last_name": "", "profile_image": "https://example.com/image.png", "user_type": "bot" } ], "details": { "user_id": "4746", "first_name": "User", "last_name": "#19332", "profile_image": "https://example.com/image.png", "user_type": "lead", "id": "4605", "title": "", "status_code": "0", "creation_time": "2024-04-02 07:26:17", "department": null, "agent_id": null, "source": null, "extra": null, "extra_2": null, "extra_3": null, "tags": null, "busy": false } } }
Webhook sent when a new conversation is created.
{ "function": "new-conversation-created", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": { "messages": [ { "id": "10222", "user_id": "4746", "message": "Hi there!", "creation_time": "2024-04-02 07:26:18", "attachments": "", "status_code": "0", "payload": "", "conversation_id": "4605", "first_name": "User", "last_name": "#19332", "profile_image": "https://example.com/image.png", "user_type": "lead" }, { "id": "10223", "user_id": "377", "message": "How are you?", "creation_time": "2024-04-02 07:26:22", "attachments": "", "status_code": "2", "payload": "{\"follow_up_message\":true,\"preview\":\"Preview text!\"]\"}", "conversation_id": "4605", "first_name": "Smart Assistant", "last_name": "", "profile_image": "https://example.com/image.png", "user_type": "bot" } ], "details": { "user_id": "4746", "first_name": "User", "last_name": "#19332", "profile_image": "https://example.com/image.png", "user_type": "lead", "id": "4605", "title": "", "status_code": "0", "creation_time": "2024-04-02 07:26:17", "department": null, "agent_id": null, "source": null, "extra": null, "extra_2": null, "extra_3": null, "tags": null, "busy": false } } }
Webhook sent when the status code of a conversation changes.
{ "function": "conversation-status-updated", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": { "conversation_id": "1057", "status_code": "0" } }
Status codes: live = 0, waiting answer from user = 1, waiting answer from agent = 2, archive = 3, trash = 4.
Webhook sent when a user login successfully from the login form of the chat. This Webhook is sent only if the login is successful.
{ "function": "login", "key": "xxxxxxxx", "data": { "details": { "id": "18", "profile_image": "https://schiocco.s3.amazonaws.com/3045506.png", "first_name": "Fede", "last_name": "", "email": "fede@fede.com", "user_type": "user", "token": "ec83c134e5d53be98abd0025145473eec0ff814e", "url": "https://sandbox.cloud.board.support\/script", "password": "$2y$10$vYtwWDEqOt7jMSBcCmPigOrqw06tdD8ZSFm70L6c1PLEQ8j938l2W", "conversation_id": "false" } }, "sender-url": "http:\/\/localhost\/" }
Webhook sent when a user registers successfully from the registration form of the chat. This Webhook is sent only if the registration is successful. This Webhook is sent also if the registration is updated via the registration form of a Rich Message.
{ "function": "registration", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": { "id": "example", "conversation_id": "123", "user": { "profile_image": [ "https://c.chatbot.inc/user.svg", "Profile image" ], "first_name": [ "Don", "First name" ], "last_name": [ "John", "Last name" ], "email": [ "example@email.com", "Email" ], "password": [ "12345678", "Password" ], "password-check": [ "12345678", "Repeat password" ], "user_type": [ "user", "" ] }, "extra": { "phone": [ "+02123456789", "Phone" ], "city": [ "London", "City" ] } } }
Webhook sent when a user is deleted.
{ "function": "user-deleted", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": "951" }
The data key contains the ID of the deleted user.
Webhook sent when a user register his email via follow-up message, subscribe message, or email rich message.
{ "function": "new-email-address", "key": "xxxxxxxx", "sender-url": "https://example.com", "data": { "name": "John Doe", "email": "email@example.com" } }