widget_options.json

{
  "widget": {
    "type": "bubble",
    "position": "right",
    "enabled": true
  },
  "button": {
    "translations": [
      {
        "language": 1,
        "name": "Help"
      }
    ],
    "size": "medium",
    "colors": {
      "background": "#62ad8c",
      "text": "#ffffff"
    }
  },
  "chat": {
    "request_user_info": true,
    "proactive": true,
    "popup": {
      "translations": [
        {
          "language": 1,
          "title": "Customer Support",
          "message": "Need help? Just reply to start a live chat with one of our team.",
          "heading": "Ask us a question!",
          "subheading": "Our team are online and ready to help with your enquiries. Send us a message to get started."
        }
      ],
      "style": "agent_text_button"
    },
    "begin_mode": "conversation",
    "allow_department_selection": false,
    "waiting_timeout": 150
  },
  "ticket": {
    "select_department": "custom",
    "default_department": null,
    "select_subject": "custom",
    "default_subject": ""
  }
}

widget

Basic widget options.

type - widget view type (column, bubble)
position - widget position location (left, right)
enabled - is widget enabled (true, false)

button

Widget button options.

translations - list of button word translations (language - DeskPRO language id, name - button word translation text)
size - button size (small, medium, large)
colors - background and text colors for widget button and start chat popup (hex).

chat

Widget live chat options.

request_user_info - require user to provide its (name, email, department, custom fields) info before the chat starts
proactive - displays widget chat popup that encourages users to chat with you
popup - chat popup view type (agent_text_button, agents_button, text_button, widget_button_agent)
begin_mode - begin chat form view type (conversation, form)
allow_department_selection - displays department selectbox (true, false)
waiting_timeout - timeout in seconds before ticket form link will be displayed Sorry! It’s taking longer than expected to find an agent to take your chat. Would you like to submit a ticket instead?

ticket

Widget ticket form options.

select_department - allows user to select department (true, false)
default_department - if select_department is false then you need to define a default DeskPRO department id
select_subject - (custom - Ask user for a subject, message - select_subject, default - Set a subject)
default_subject - if select_subject is set to default then it specifies pre defined subject