Skip to Content

Changes for page CRM Widget

Last modified by superadmin on 2021/09/09 20:56
From version 8.1
edited by michaely
on 2021/09/09 18:01
Change comment: Import
To version 9.1
edited by michaely
on 2021/09/09 18:01
Change comment: Import

Summary

Details

Page properties
Content
... ... @@ -4,16 +4,20 @@
4 4  
5 5  {{toc/}}
6 6  
7 -The CRM widget allows users to open specified URLs on incoming call activity. This widget is useful if you wish to open web based CRM or other records based on incoming call information. Although this widget is called the CRM widget it can be used to open any type of web page.
7 +The CRM widget allows users to open specified URLs on incoming call activity, and allows web pages to be embedded in the iSymphony client interface. This widget is useful if you wish to open web based CRM or other records based on incoming call information, or create your own custom widget for use within the panel. Although this widget is called the CRM widget it can be used to open any type of web page.
8 8  
9 9  {{info}}
10 -By default the CRM widget will want to open the URL in an embedded iframe inside the widget. Some web pages specify X-Frame-Options which prevent themselves from being embeddable in an iframe. This issue is identified by a blank page showing in the CRM widget when it should be populated by the web page. If you cannot modify the destination webpage's X-Frame-Options to allow embedding from the iSymphony application you will have to use the **Open URL in new window** option.
10 +By default the CRM widget will want to open the URL in an embedded iframe inside the widget. Some web pages specify X-Frame-Options which prevent themselves from being embeddable in an iframe. This issue is identified by a blank page showing in the CRM widget, when it should be populated by the web page. If you cannot modify the destination webpage's X-Frame-Options to allow embedding from the iSymphony application you will have to use the **Open URL in new window** option. Another workaround to this issue is to proxy the website with an HTTP proxy, like NGINX.
11 11  {{/info}}
12 12  
13 13  = Open URL On Demand =
14 14  
15 -If you do not wish to open a URL on call events but wish to open them on demand you can use the CRM button in the My Stream Widget. See [[doc:My Stream Widget]] for more information.
15 +If you do not wish to open a URL on call events, but wish to open them on demand, you can use the CRM button in the My Stream Widget. See [[doc:My Stream Widget]] for more information.
16 16  
17 +{{info}}
18 +CRM Widgets, with a setting of open **Always,** are not accessible via the CRM button, as they are not related to call information.
19 +{{/info}}
20 +
17 17  = Settings =
18 18  
19 19  Settings for the CRM Widget can be access by clicking the cog icon in the top right hand corner of the CRM Widget. The settings dialog will also open automatically when adding the CRM Widget to the dashboard for the first time.
... ... @@ -26,26 +26,40 @@
26 26  )))
27 27  |(% class="highlight-grey" data-highlight-colour="grey" %)(% class="highlight-grey" data-highlight-colour="grey" %)
28 28  (((
29 -**Open On:**
33 +**Open:**
30 30  )))|(((
31 31  (% style="color: rgb(34,34,34);" %)Specifies when to open the specified URL.
32 32  
33 -* (% style="color: rgb(34,34,34);" %)**Never: **(% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)Disable this CRM widget.(% style="color: rgb(34,34,34);" %)
37 +* (% style="color: rgb(34,34,34);" %)**On Demand: **(% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)The URL will only be opened when the user selects the CRM button, in the My Stream Widget.(% style="color: rgb(34,34,34);" %)
34 34  
35 -* (% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)**Ring**: Open when you have an incoming ringing call.
36 -* (% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)**Answer**: Open when you answer an incoming call.
39 +* (((
40 +**Always:** The URL will always be open.
41 +
42 +{{info}}
43 +Variables related to call state will not be available in the URL, when the **Always** open method is selected. See URL below, for more information.
44 +{{/info}}
37 37  )))
46 +* (% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)**On Ring**: Open when you have an incoming ringing call.
47 +* (% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)**On Answer**: Open when you answer an incoming call.
48 +)))
38 38  |(% class="highlight-grey" data-highlight-colour="grey" %)(% class="highlight-grey" data-highlight-colour="grey" %)
39 39  (((
40 40  **Open URL in new window:**
41 41  )))|(((
42 -(% style="color: rgb(34,34,34);" %)When checked the specified URL will open in a new browser popup window instead of inside the widget. This can be used for web pages that do now allow themselves to be embedded in iframes.
53 +(% style="color: rgb(34,34,34);" %)When checked the specified URL will open in a new browser popup window instead of inside the widget. This can be used for web pages that do not allow themselves to be embedded in iframes.
43 43  )))
44 44  |(% class="highlight-grey" data-highlight-colour="grey" %)(% class="highlight-grey" data-highlight-colour="grey" %)
45 45  (((
46 46  **Open on calls from internal extensions:**
47 47  )))|(((
48 -(% style="color: rgb(34,34,34);" %)When checked the specified URL will open on calls from internal extensions.
59 +(% style="color: rgb(34,34,34);" %)When checked, the specified URL will open on calls from internal extensions.
60 +
61 +{{info}}
62 +This option is disabled when the open method is set to **Always.**
63 +{{/info}}
64 +
65 +(% style="color: rgb(34,34,34);" %)
66 +
49 49  )))
50 50  |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)
51 51  (((
... ... @@ -52,11 +52,25 @@
52 52  **URL:**
53 53  )))|(% colspan="1" %)(% colspan="1" %)
54 54  (((
55 -(% style="color: rgb(34,34,34);" %)The URL to open. The following variables can be used in the URL which will be replaced with information from the call.
73 +(% style="color: rgb(34,34,34);" %)The URL to open. The following variables can be used in the URL, which will be replaced with information from the call, or the user.
56 56  
57 -* (% style="color: rgb(34,34,34);" %)**${CALLER_ID_NAME}: **(% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)The caller ID name of the incoming call.
75 +(% style="color: rgb(34,34,34);" %)
76 +
77 +
78 +(% style="color: rgb(34,34,34);" %)**URL Variables:**
79 +
80 +* (% style="color: rgb(34,34,34);" %)**${USER}: **The username of the current user.
81 +* **${USER_ID}: **The id of the current user.
82 +* **${USER_LOGIN_ID}:** The id of the current user's client login.(% style="color: rgb(34,34,34);" %)**
83 +**
84 +
85 +{{info}}
86 +The variables below will only be available if the open method is set to **On Demand, On Ring, **or **On Answer.**
87 +{{/info}}
88 +
89 +* (% style="color: rgb(34,34,34);" %)**${CALLER_ID_NAME}: **The caller ID name of the incoming call.(% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)**
90 +**
58 58  * (% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)**${CALLER_ID_NUMBER}: **(% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)The caller ID number of the incoming call.
59 59  * (% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)**${DID}: **(% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)The phone number this call initially dialed to enter the phone system.
60 -* (% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)**${USER}: **(% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)The username of the current user.
61 -* (% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)**${PBX(//key//)}:**(% style="color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34); color: rgb(34, 34, 34)" %)The phone system variable with the given key that is attached to the incoming call. If the variable does not exist on the incoming call the value will be set to a blank string.
93 +* (% style="color: rgb(34,34,34);line-height: 1.4285715;" %)**${PBX(//key//)}:**(% style="color: rgb(34,34,34);" %)The phone system variable with the given key that is attached to the incoming call. If the variable does not exist on the incoming call the value will be set to a blank string.
62 62  )))