chore: add detail steps about ivr menu key press (#3)

Author: embbnux

.gitignore

@@ -159,4 +159,6 @@ cython_debug/
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 #.idea/
 
+.DS_Store
+
 *~

docs/img/automator-ivr-menu-b-import.png

@@ -0,0 +1,90 @@
+{
+  "name": "SMS sent when call received",
+  "nodes": [
+    {
+      "id": "trigger",
+      "position": {
+        "x": 250,
+        "y": 80
+      },
+      "type": "trigger",
+      "data": {
+        "description": "",
+        "rules": [],
+        "label": "Call received",
+        "type": "callReceived",
+        "nextNodes": [
+          "action-1717500598278"
+        ],
+        "matchType": "and"
+      }
+    },
+    {
+      "id": "action-1717500598278",
+      "position": {
+        "x": 250,
+        "y": 280
+      },
+      "type": "action",
+      "data": {
+        "paramValues": "{\"toPhoneNumbers\":[{\"phoneNumber\":\"{trigger.caller.phoneNumber}\"}],\"fromPhoneNumber\":\"$$PARAM$$\",\"messageText\":\"$$PARAM$$\"}",
+        "parentNodeId": "trigger",
+        "label": "Send SMS",
+        "type": "sendSMS",
+        "parentNodeBranch": "default",
+        "nextNodes": [
+          "action-exit-1717500488442"
+        ]
+      }
+    },
+    {
+      "id": "action-exit-1717500488442",
+      "position": {
+        "x": 250,
+        "y": 480
+      },
+      "type": "action",
+      "data": {
+        "paramValues": "{}",
+        "parentNodeId": "action-1717500598278",
+        "label": "Exit",
+        "type": "exit",
+        "parentNodeBranch": "default",
+        "nextNodes": []
+      }
+    }
+  ],
+  "params": [
+    {
+      "id": "action-params-action-1717500598278-fromPhoneNumber",
+      "name": "Select the phone number your SMS will be sent from",
+      "type": "option",
+      "options": [],
+      "remote": true,
+      "remoteOptionKey": "fromPhoneNumbers",
+      "validator": "^\\+[1-9]\\d{1,14}$",
+      "noOptionsMessage": "noSMSPermission",
+      "supportedVariables": [
+        "trigger.recipient.phoneNumber"
+      ],
+      "supportedVariablesForTrigger": "newSMS",
+      "nodeId": "action-1717500598278",
+      "nodeLabel": "Send SMS",
+      "paramId": "fromPhoneNumber",
+      "forAction": "sendSMS"
+    },
+    {
+      "id": "action-params-action-1717500598278-messageText",
+      "name": "Enter your SMS message text",
+      "type": "text",
+      "limitLength": 500,
+      "helperText": "Tip: type \"#\" to see a list of variables you can insert into the message",
+      "nodeId": "action-1717500598278",
+      "nodeLabel": "Send SMS",
+      "paramId": "messageText",
+      "forAction": "sendSMS",
+      "requiredActionOutputs": []
+    }
+  ],
+  "version": 1
+}

docs/img/automator-ivr-menu-b.png

@@ -20,3 +20,42 @@ One can use the "Call end reason" variable to determine if a caller ended the ca
 
 For now, there is no way to detect specific key a user pressed in an IVR menu, but we can make some reasonable inferrences depending upon what extensions an IVR menu might direct a user to. For example, if an IVR menu directs someone to a extension 203, and if the IVR menu is the only way a user could navigate to that extension, then one could place a "Call received" trigger on extension 203 - thereby detecting that someone previously selected it via an IVR menu. 
 
+### Step 1: Setup IVR menus in RingCentral admin portal
+
+We will have two IVR menus. 
+
+![ivr-menus](../img/ivr-menus.png)
+
+First menu is the IVR menu that you want caller to press keys to trigger automation. Let's call the first extension "IVR Menu 1".
+
+Let's set prompt to say "Press 1 get to a link by SMS":
+
+![ivr-menu-a-prompt](../img/ivr-menu-a-prompt.png)
+
+In Key presses, let's make Key 1 connect to IVR Menu B.
+
+![ivr-menu-a-keys](../img/ivr-menu-a-keys.png)
+
+In IVR Menu B, let's set prompt to say "A SMS is sent to you with link":
+
+![ivr-menu-b-prompt](../img/ivr-menu-b-prompt.png)
+
+### Step 2: Setup automation in Automator
+
+Login into RingCentral Automator with admin account. Then **go to IVR Menu B's page**:
+
+![automator-ivr-menu-b](../img/automator-ivr-menu-b.png)
+
+Import following automation template file n for IVR Menu B:
+
+![automator-ivr-menu-b-import](../img/automator-ivr-menu-b-import.png)
+
+[:fontawesome-solid-download: Download automation](ivr-menu-key-press.json){: download .md-button }
+
+After imported, You can also update the automation to setup other actions and logics for call received trigger.
+
+**Enable** the automation, then all DONE. When call to IVR Menu A, then caller press 1. Caller will be redirect to IVR Menu B. Then a SMS will be sent.
+
+### Step 3: Other key presses
+
+To setup other key press, you need to create a new IVR Menu C. Then setup key 2 connect to IVR Menu C in IVR Menu A. Then import other automation for IVR Menu C in Automator.

docs/img/automator-ivr-menu-new-automation.png

@@ -142,7 +142,7 @@
     },
     {
       "id": "action-params-action-sms-messageText",
-      "name": "Enter your auto-reply's message test",
+      "name": "Enter your auto-reply's message text",
       "type": "text",
       "limitLength": 500,
       "helperText": "Tip: type \"#\" to see a list of variables you can insert into the message",