Changelog

This document is the record of all the changes in the Configuration API starting from version 3.0. What you won't find here is the list of changes between versions 2.0 and 3.0 of the Configuration API.

Switching from v2.0 to v3.0 was more than an upgrade - it was rather a migration. That's why some parts of the configuration, such as managing canned responses or greetings, can be done only via the Configuration API v2, while other, like managing webhooks or properties, via the Configuration API v3.

Since the migration is still ongoing, different parts will be successively moved from the Configuration API v2.0 to v3.x.

[v3.2] - 2020-06-18

Agents

• There are new methods for managing Agents:
  • Create Agent
  • Get Agent
  • List Agents
  • Update Agent
  • Delete Agent
  • Suspend Agent
  • Unsuspend Agent
  • Request Agent Unsuspension
  • Approve Agent

Bots

• The Create Bot Agent method was renamed to Create Bot.
• The Create Bot method no longer accepts the status parameter. The initial value is now __offline__.
• The Update Bot Agent method was renamed to Update Bot.
• The Update Bot method no longer accepts the status parameter. To change the Bot's status, use Set Routing Status from the Agent Chat API.
• You can now update another Bot within the same license. To do that, call the Update Bot method; requires the agents-bot--all:rw scope.
• Other method renames include:
  • Get Bot Agent Details -> Get Bot
  • Get Bot Agents -> List Bots
  • Create Bot Agent -> Create Bot
  • Remove Bot Agent -> Delete Bot

Groups

• There are new methods for managing Groups:
  • Create Group
  • Update Group
  • Delete Group
  • List Groups
  • Get Group

Properties

• It's possible to define properties in new locations: license and group.
• Method renames include:
  • Get Property Configs -> List Registered Properties
  • Create Properties -> Register Properties
• There are new methods:
  • Update License Properties
  • List License Properties
  • Delete License Properties
  • Update Group Properties
  • List Group Properties
  • Delete Group Properties

Webhooks

• There's a new field, license_id, in all webhooks.
• The agent_ids filter was added to the agent_deleted webhook.
• The agent_status_changed webhook was replaced with routing_status_set.
• The access_granted webhook was renamed to chat_access_granted. It no longer includes the resource parameter.
• The access_revoked webhook was renamed to chat_access_revoked. It no longer includes the resource parameter.
• Other method and webhook renames include:
  • Get Webhooks Config -> List Registered Webhooks
  • chat_thread_properties_updated -> thread_properties_updated
  • chat_thread_properties_deleted -> thread_properties_deleted
  • thread_closed -> chat_deactivated
  • incoming_chat_thread -> incoming_chat
  • chat_thread_tagged -> thread_tagged
  • chat_thread_untagged -> thread_untagged
  • chat_user_added -> user_added_to_chat
  • chat_user_removed -> user_removed_from_chat
• There's a new webhook, follow_up_requested.
• The agent_status_changed webhook was removed.
• The access_set webhook was removed.

[v3.1] - 2019-09-17

Changed

• The data field in webhooks was renamed to payload.