소스 검색

update call block document (#233)

* update call block images

* ...

* Update call_block.rst
Alex 1 년 전
부모
커밋
41547023ca
3개의 변경된 파일40개의 추가작업 그리고 16개의 파일을 삭제
  1. BIN
      source/_static/images/fusionpbx_call_block.jpg
  2. BIN
      source/_static/images/fusionpbx_call_block1.jpg
  3. 40 16
      source/applications/call_block.rst

BIN
source/_static/images/fusionpbx_call_block.jpg


BIN
source/_static/images/fusionpbx_call_block1.jpg


+ 40 - 16
source/applications/call_block.rst

@@ -2,29 +2,53 @@
 Call block
 ##############
 
-A list of numbers from which to block calls.
+The Call Block application can be used to block *inbound* or *outbound* calls, based on the Caller ID Name and/or Number (for inbound calls), or the Destination Number (for outbound calls).
 
+Creating a New Call Block
+^^^^^^^^^^^^^^^^^
 
-.. image:: ../_static/images/fusionpbx_call_block1.jpg
+To create a new Call Block, click the **Add** button at the top-right of the Call Block list page.  A simple form will be presented...
+
+.. image:: ../_static/images/fusionpbx_call_block.jpg
         :scale: 85%
 
+**Field Descriptions**
 
-*  To block a call click on the **plus** icon on the right
-*  Fill out the fields with pertinent information
-|   Action:
-|   **Reject-** Will reject the call
-|   **Busy-** Will send a busy signal
-|   **Hold-** Will put the call on hold
-|   **Voicemail-** Will send the call to the specified voicemail box
-|
+**Direction** - Select the direction of the calls you wish to block (*Inbound* or *Outbound*)
 
+**Extension** - Select which extension (if any) the Call Block should affect.
 
-.. image:: ../_static/images/fusionpbx_call_block.jpg
-        :scale: 85%
+**Name** - Enter the Caller ID Name that should be blocked.  (Note: An **exact, case-sensitive** match is necessary, but this field can be considered optional if a Number is specified.)
+
+**Number** - Enter the Country Code (eg. US = '1') and the number to block.  For *Inbound* calls, enter the calling party's number.  For *Outbound* calls, enter the Destination Number.  (Note: An *exact match* is necessary, but this field can be considered optional if a Number is specified.)
+
+**Action** - The action to take if the Name and/or Number is matched: Reject the call, play a busy signal, transfer to a specific extension, or voicemail box, etc.
+
+**Enabled** - True or False
+
+**Description** - The reason for blocking the number (? - you decide ;).
+
+*Note: Call Blocks can also be added in bulk using the Recent Calls list below the form.*
 
-**Enhanced call-blocking introduced in Master branch 2.5.0:**
-Call-blocking does an exact match on the inbound caller-id number by default. 
-This behaviour can be changed to use SQL "like" comparison or regex based comparison by adding the following variable to the Default Settings:
+Outbound Call Blocking
+^^^^^^^^^^^^^^^^^
 
-.. image:: ../_static/images/fusionpbx_call_block_matching.jpg
+
+Outbound call blocking requires an additional dialplan entry. 
+
+If one doesn't exist already, add a new **call-direction** Outbound Route to set `call_direction=outbound`...
+
+.. image:: ../_static/images/fusionpbx_call_block1.jpg
         :scale: 85%
+
+**Be sure to set *Continue* to True, or dialplan execution will never reach your existing Outbound Routes!**
+
+*Note: The screen capture example above could be for 10-digit numbers, such as those in the U.S, so you may want to adjust the regular expression used to match the destination number format being used in your current Outbound Routes.*
+
+
+Troubleshooting
+^^^^^^^^^^^^^^^^^
+
+Its usually sufficient to add the Number (Caller ID Number) to block and leave the Name (Caller ID Name) empty.
+
+^^^^^^^^^^^^^^^^^