# Whatsapp
Let's consider an example of a robot that allows automatic messaging via Whatsapp.
The robot project consists of three diagrams and two files in xlsx and txt formats.
The main diagram of the project is called **“WhatsappSend”** and looks like this (for convenience, the blocks of the diagram are numbered):
1. **Block “Start”** (any diagram begins with this block).
2. **Block “Process”** allows creating scenarios consisting of multiple diagrams. The execution of the scenario will continue from the “Start” block of the specified project diagram. The execution of the scenario will return to the current block and continue in the current diagram as soon as the “End” block in the external diagram is reached. For the “Process” block, the property “Diagram Name” is specified (the name of the diagram file where the scenario will continue execution).
3. **Block “Condition”** checks the specified condition for truth, after which the execution of the scenario continues towards the “Yes” exit (if the condition is met) or towards the “No” exit (if the condition is not met).
The condition is written in the format: “variable” equals (==)/ greater than (>)/ less than (<) “value”.
For example: $a == “Hello”, that is, if the value of the variable $a is equal to “Hello”, then the exit is “Yes”, otherwise – the exit is “No”.
$Result > 5, that is, if the value of the variable $Result is less than 5, then the exit is “Yes”, otherwise – the exit is “No”.
In this case, the condition is set as: $StartWork. That is, if the variable $StartWork (which is a boolean variable) is equal to $true, then we go down.
4. **Block “Launch Chrome”** allows launching Google Chrome. For this block, the following properties are specified:
* URL (the address of the page to be opened when launching Google Chrome);
* Current tab (if the flag is set, the page will open in the currently selected tab of the browser);
* Wait time (the time to wait for the application to launch and the tab to load in seconds).
5. **Block “Wait for Appearance”** waits for the appearance of a user interface element on the screen added to the diagram using the [User Action Recording Tool](https://docs.sherparpa.ru/en/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/osnovnoe-menyu/panel-razrabotka/menyu-zapis/zapis-deistvii-polzovatelya).
6. **Block “Log”** allows outputting arbitrary messages and/or variable values to the log during the execution of the robot's scenario. For this block, the property “Value” is specified. A text constant is indicated in quotes, and the variable name starts with the symbol $. That is, it outputs the log message “Connection error. The phone may be out of reach...”.
7. **Block “Assign Value to Variable”** sets new values for one or more variables. In this case, two values are specified in the properties to be assigned to two variables, respectively.
8. **Block “Open Document”** allows opening an Excel document. For this block, the property “File Path” is specified (the path to the Excel document that needs to be opened).
9. **Block “Assign Value to Variable”** sets new values for one or more variables. In this case, one value is specified in the properties to be assigned to one variable, respectively.
10. **Block “Get Cell Value”** allows reading a value from a cell in an Excel document. For this block, the following properties are specified:
* Document Reference (a reference to the document currently being worked on);
* Sheet (the ordinal number of the sheet where the required cell is located, numbering starts from 1);
* Row (the row number where the required cell is located, numbering starts from 1);
* Column (the column number where the required cell is located, numbering starts from 1).
11. **Block “Get Cell Value”** allows reading a value from a cell in an Excel document. For this block, the following properties are specified:
* Document Reference (a reference to the document currently being worked on);
* Sheet (the ordinal number of the sheet where the required cell is located, numbering starts from 1);
* Row (the row number where the required cell is located, numbering starts from 1);
* Column (the column number where the required cell is located, numbering starts from 1).
12. **Block “Condition”** checks the specified condition for truth, after which the execution of the scenario continues towards the “Yes” exit (if the condition is met) or towards the “No” exit (if the condition is not met).
The condition is written in the format: “variable” equals (==)/ greater than (>)/ less than (<) “value”.
For example: $a == “Hello”, that is, if the value of the variable $a is equal to “Hello”, then the exit is “Yes”, otherwise – the exit is “No”.
$Result > 5, that is, if the value of the variable $Result is less than 5, then the exit is “Yes”, otherwise – the exit is “No”.
In this case, the condition is set as: $ValuePhone.Trim().Length==0. That is, the length of the string is equal to 0.
13. **Block “Condition”** checks the specified condition for truth, after which the execution of the scenario continues towards the “Yes” exit (if the condition is met) or towards the “No” exit (if the condition is not met).
The condition is written in the format: “variable” equals (==)/ greater than (>)/ less than (<) “value”.
For example: $a == “Hello”, that is, if the value of the variable $a is equal to “Hello”, then the exit is “Yes”, otherwise – the exit is “No”.
$Result > 5, that is, if the value of the variable $Result is less than 5, then the exit is “Yes”, otherwise – the exit is “No”.
In this case, the condition is set as: $ValueFIO.Trim().Length==0. That is, the length of the string is equal to 0.
14. **Block “Assign Value to Variable”** sets new values for one or more variables. In this case, one value is specified in the properties to be assigned to one variable, respectively.
15. **Block “Condition”** checks the specified condition for truth, after which the execution of the scenario continues towards the “Yes” exit (if the condition is met) or towards the “No” exit (if the condition is not met).
The condition is written in the format: “variable” equals (==)/ greater than (>)/ less than (<) “value”.
For example: $a == “Hello”, that is, if the value of the variable $a is equal to “Hello”, then the exit is “Yes”, otherwise – the exit is “No”.
$Result > 5, that is, if the value of the variable $Result is less than 5, then the exit is “Yes”, otherwise – the exit is “No”.
In this case, the condition is set as: $countempty>5. That is, the number of empty messages must be greater than five.
16. **Block “Save Document”** allows saving an Excel document. For this block, the following properties are specified:
* Excel Reference (a reference to the process of handling the Excel document. The variable name in this property must match the variable name in the “Excel Reference” property of the “Create Document” or “Open Document” blocks from the Excel group that were previously used to create or open this document);
* Document Reference (a reference to the document that needs to be saved. The variable name in this property must match the variable name in the “Document Reference” property of the “Create Document” or “Open Document” blocks from the Excel group that were previously used to create or open this document);
* File Path (the path to the Excel document).
**Note:** *to save the document in the same file, leave the value empty. Otherwise, enter a new file path. If the specified file exists, it will be overwritten. Available formats: ".xlsx", ".xlsm", ".xls", ".csv", ".pdf", ".xml"*
17. **Block “Assign Value to Variable”** sets new values for one or more variables. In this case, one value is specified in the properties to be assigned to one variable, respectively.
18. **Block “Condition”** checks the specified condition for truth, after which the execution of the scenario continues towards the “Yes” exit (if the condition is met) or towards the “No” exit (if the condition is not met).
The condition is written in the format: “variable” equals (==)/ greater than (>)/ less than (<) “value”.
For example: $a == “Hello”, that is, if the value of the variable $a is equal to “Hello”, then the exit is “Yes”, otherwise – the exit is “No”.
$Result > 5, that is, if the value of the variable $Result is less than 5, then the exit is “Yes”, otherwise – the exit is “No”.
In this case, the condition is set as: $ValuePhone.Trim().Length>0. That is, the length of the string is equal to 0.
19. **Block “Condition”** checks the specified condition for truth, after which the execution of the scenario continues towards the “Yes” exit (if the condition is met) or towards the “No” exit (if the condition is not met).
The condition is written in the format: “variable” equals (==)/ greater than (>)/ less than (<) “value”.
For example: $a == “Hello”, that is, if the value of the variable $a is equal to “Hello”, then the exit is “Yes”, otherwise – the exit is “No”.
$Result > 5, that is, if the value of the variable $Result is less than 5, then the exit is “Yes”, otherwise – the exit is “No”.
In this case, the condition is set as: $ValueFIO.Trim().Length>0. That is, the length of the string is equal to 0.
20. **Block “Substring Replacement”** allows replacing one substring with another in the text. For this block, the following properties are specified:
* Text (input string);
* Search substring (the string that needs to be replaced);
* Inserted substring (the string to replace all occurrences of the search substring).
21. **Block “Assign Value to Variable”** sets new values for one or more variables. In this case, two values are specified in the properties to be assigned to two variables, respectively.
22. **Block “Process”** allows creating scenarios consisting of multiple diagrams. The execution of the scenario will continue from the “Start” block of the specified project diagram. The execution of the scenario will return to the current block and continue in the current diagram as soon as the “End” block in the external diagram is reached. For the “Process” block, the property “Diagram Name” is specified (the name of the diagram file where the scenario will continue execution).
23. **Block “Condition”** checks the specified condition for truth, after which the execution of the scenario continues towards the “Yes” exit (if the condition is met) or towards the “No” exit (if the condition is not met).
The condition is written in the format: “variable” equals (==)/ greater than (>)/ less than (<) “value”.
For example: $a == “Hello”, that is, if the value of the variable $a is equal to “Hello”, then the exit is “Yes”, otherwise – the exit is “No”.
$Result > 5, that is, if the value of the variable $Result is less than 5, then the exit is “Yes”, otherwise – the exit is “No”.
In this case, the condition is set as: $IndexSaveResult>=0. That is, the index of saving results must be greater than zero.
24. **Block “Condition”** checks the specified condition for truth, after which the execution of the scenario continues towards the “Yes” exit (if the condition is met) or towards the “No” exit (if the condition is not met).
The condition is written in the format: “variable” equals (==)/ greater than (>)/ less than (<) “value”.
For example: $a == “Hello”, that is, if the value of the variable $a is equal to “Hello”, then the exit is “Yes”, otherwise – the exit is “No”.
$Result > 5, that is, if the value of the variable $Result is less than 5, then the exit is “Yes”, otherwise – the exit is “No”.
In this case, the condition is set as: $SendSuccess. That is, the boolean variable = $true.
25. **Block “Write Value to Cell”** allows writing a value to a cell in an Excel document. For this block, the following properties are specified:
* Document Reference (a reference to the document currently being worked on. The variable name in this property must match the variable name in the “Document Reference” property of the “Create Document” or “Open Document” blocks from the Excel group that were previously used to create or open this document);
* Sheet (the ordinal number of the sheet where the required cell is located, numbering starts from 1);
* Row (the row number where the required cell is located, numbering starts from 1);
* Column (the column number where the required cell is located, numbering starts from 1);
* Value (constant, variable, or result of calculations that need to be written to the required cell).
26. **Block “Assign Value to Variable”** sets new values for one or more variables.
27. **Block “Write Value to Cell”** allows writing a value to a cell in an Excel document. For this block, the following properties are specified:
* Document Reference (a reference to the document currently being worked on. The variable name in this property must match the variable name in the “Document Reference” property of the “Create Document” or “Open Document” blocks from the Excel group that were previously used to create or open this document);
* Sheet (the ordinal number of the sheet where the required cell is located, numbering starts from 1);
* Row (the row number where the required cell is located, numbering starts from 1);
* Column (the column number where the required cell is located, numbering starts from 1);
* Value (constant, variable, or result of calculations that need to be written to the required cell).
28. and 29. **Blocks “End”** (these blocks complete the execution of the scenario or return the subprocess diagram to the main process).
**Diagram “Load Settings”**
1. **Block “Start”** (any diagram begins with this block).
2. **Block “Open File”** displays a dialog box allowing the user to open a file. For this block, the following properties are specified:
* Title (the text that will be displayed in the title of the dialog box);
* Filter (file filter for each parameter filtering string, the filter description is followed by a vertical bar (|) and the filter pattern. Lines for different filtering parameters are separated by a vertical bar).
3. **Block “Text Input Window”** shows a modal dialog box designed to obtain information from the user. For this block, the following properties are specified:
* Title (the text that will be displayed in the title of the dialog box);
* Message (the text that will be displayed inside the dialog box).
4. **Block “Condition”** checks the specified condition for truth, after which the execution of the scenario continues towards the “Yes” exit (if the condition is met) or towards the “No” exit (if the condition is not met).
The condition is written in the format: “variable” equals (==)/ greater than (>)/ less than (<) “value”.
For example: $a == “Hello”, that is, if the value of the variable $a is equal to “Hello”, then the exit is “Yes”, otherwise – the exit is “No”.
$Result > 5, that is, if the value of the variable $Result is less than 5, then the exit is “Yes”, otherwise – the exit is “No”.
In this case, the condition is set as: \[int]::TryParse($Result, \[ref] $IndexPhone). This method converts text to a number and gives a boolean result, which is checked against $true.
5. **Block “Text Input Window”** shows a modal dialog box designed to obtain information from the user. For this block, the following properties are specified:
* Title (the text that will be displayed in the title of the dialog box);
* Message (the text that will be displayed inside the dialog box).
6. **Block “Condition”** checks the specified condition for truth, after which the execution of the scenario continues towards the “Yes” exit (if the condition is met) or towards the “No” exit (if the condition is not met).
The condition is written in the format: “variable” equals (==)/ greater than (>)/ less than (<) “value”.
For example: $a == “Hello”, that is, if the value of the variable $a is equal to “Hello”, then the exit is “Yes”, otherwise – the exit is “No”.
$Result > 5, that is, if the value of the variable $Result is less than 5, then the exit is “Yes”, otherwise – the exit is “No”.
In this case, the condition is set as: \[int]::TryParse($Result, \[ref] $IndexFIO). This method converts text to a number and gives a boolean result, which is checked against $true.
7. **Block “Text Input Window”** shows a modal dialog box designed to obtain information from the user. For this block, the following properties are specified:
* Title (the text that will be displayed in the title of the dialog box);
* Message (the text that will be displayed inside the dialog box).
8. **Block “Execute Expression”** starts the execution of one or more expressions in a language compatible with PowerShell. In this case, one expression is used.
9. **Block “Open File”** displays a dialog box allowing the user to open a file. For this block, the following properties are specified:
* Title (the text that will be displayed in the title of the dialog box);
* Filter (file filter for each parameter filtering string, the filter description is followed by a vertical bar (|) and the filter pattern. Lines for different filtering parameters are separated by a vertical bar).
10. **Block “Read File”** allows reading the contents of a text file into a variable. For this block, the following properties are specified:
* File Name (the name of the text file whose contents need to be read);
* Encoding (the encoding of the file).
11. **Block “Assign Value to Variable”** sets new values for one or more variables. In this case, one value is specified in the properties to be assigned to one variable, respectively.
12. * 16. **Blocks “End”** (these blocks complete the execution of the scenario or return the subprocess diagram to the main process).
**Diagram “Send Message”**
1. **Block “Start”** (any diagram begins with this block).
2. **Block “Assign Value to Variable”** sets new values for one or more variables. In this case, two values are specified in the properties to be assigned to two variables, respectively.
3. **Block “Loop”** allows repeating a chain of actions (blocks) several times while counting the number of iterations of the loop, recording the current count in a special variable (specified in the “Loop” property), which can then be used in other blocks. Upon first entering the block, the value of the variable from the “Loop” property is set to “Initial Value” (in this case, it is equal to zero), and then the execution of the scenario continues towards the “Loop” exit of this block (to the so-called “body of the loop”). As soon as the execution of the scenario reaches this block again, the value of the “Loop” variable will increase by the “Step” value (in this case, it is 1), and the transition to the “Loop” exit will occur again. As soon as the value of the “Loop” variable becomes greater than or equal to the “Final Value” (in this case, it is set to the variable $Phone.Length), the execution of the scenario will continue towards the lower exit of the block. Do not forget to connect the exit of the last block in the body of the loop to the entrance of this block or any of the preceding blocks.
4. **Block “Condition”** checks the specified condition for truth, after which the execution of the scenario continues towards the “Yes” exit (if the condition is met) or towards the “No” exit (if the condition is not met).
The condition is written in the format: “variable” equals (==)/ greater than (>)/ less than (<) “value”.
For example: $a == “Hello”, that is, if the value of the variable $a is equal to “Hello”, then the exit is “Yes”, otherwise – the exit is “No”.
$Result > 5, that is, if the value of the variable $Result is less than 5, then the exit is “Yes”, otherwise – the exit is “No”.
In this case, the condition is set as: \[char]::IsDigit($Phone\[$indchar]). That is, it checks that every character in the string is a number.
5. **Block “Assign Value to Variable”** sets new values for one or more variables. In this case, one value is specified in the properties to be assigned to one variable, respectively.
6. **Block “Get Substring”** allows extracting a substring from the source text. For this block, the following properties are specified:
* Text (input string);
* Start Index (the index of the starting character, numbering starts from 0. If a value less than zero is specified, the starting index is counted from the end of the string);
* Number of Characters (the number of characters. If an empty value or a count of zero is specified, the string will be extracted from the specified index to the end of the string).
7. **Block “Get Substring”** allows extracting a substring from the source text. For this block, the following properties are specified:
* Text (input string);
* Start Index (the index of the starting character, numbering starts from 0. If a value less than zero is specified, the starting index is counted from the end of the string);
* Number of Characters (the number of characters. If an empty value or a count of zero is specified, the string will be extracted from the specified index to the end of the string).
8. **Block “Assign Value to Variable”** sets new values for one or more variables. In this case, three values are specified in the properties to be assigned to three variables, respectively.
9. **Block “Condition”** checks the specified condition for truth, after which the execution of the scenario continues towards the “Yes” exit (if the condition is met) or towards the “No” exit (if the condition is not met).
The condition is written in the format: “variable” equals (==)/ greater than (>)/ less than (<) “value”.
For example: $a == “Hello”, that is, if the value of the variable $a is equal to “Hello”, then the exit is “Yes”, otherwise – the exit is “No”.
$Result > 5, that is, if the value of the variable $Result is less than 5, then the exit is “Yes”, otherwise – the exit is “No”.
In this case, the condition is set as: $normalizednumber.Length==11. That is, the length of the string must be equal to 11.
10. **Block “Log”** allows outputting arbitrary messages and/or variable values to the log during the execution of the robot's scenario. For this block, the property “Value” is specified, and the flag “Display in Status” is set. A text constant is indicated in quotes, and the variable name starts with the symbol $. That is, it outputs the log message “Sending message to number:” and the number itself and displays this message in the status.
11. **Block “URL Encode String”** encodes a string for transmission in a URL. For this block, one property “Text” (input string) is specified.
12. **Block “Launch Chrome”** allows launching Google Chrome. For this block, the following properties are specified:
* URL (the address of the page to be opened when launching Google Chrome);
* Current tab (if the flag is set, the page will open in the currently selected tab of the browser);
* Wait time (the time to wait for the application to launch and the tab to load in seconds).
13. **Block “Wait for Appearance”** waits for the appearance of a user interface element on the screen added to the diagram using the user action recording tool.
14. **Block “Check Element Presence”** checks for the presence of a specified element on the web page. If the element is found, the execution of the scenario will continue through the “Yes” exit, otherwise - through the “No” exit. For this block, the following properties are specified:
* Selector (identifier of the browser window and the web page element);
* Process ID (a variable that stores the process and tab ID of the browser used by this block).
15. **Block “Click Mouse”** performs a click on the specified application element added to the diagram using the user action recording tool. More about it *here*.
16. **Block “Log”** allows outputting arbitrary messages and/or variable values to the log during the execution of the robot's scenario. For this block, the property “Value” is specified, and the flag “Display in Status” is set. A text constant is indicated in quotes, and the variable name starts with the symbol $. That is, it outputs the log message “Message sent” and displays it in the status.
17. **Block “Assign Value to Variable”** sets new values for one or more variables. In this case, one value is specified in the properties to be assigned to one variable, respectively.
18. **Block “Check Element Presence”** checks for the presence of a specified element on the web page. If the element is found, the execution of the scenario will continue through the “Yes” exit, otherwise - through the “No” exit. For this block, the following properties are specified:
* Selector (identifier of the browser window and the web page element);
* Process ID (a variable that stores the process and tab ID of the browser used by this block).
19. **Block “Log”** allows outputting arbitrary messages and/or variable values to the log during the execution of the robot's scenario. For this block, the property “Value” is specified, and the flag “Display in Status” is set. A text constant is indicated in quotes, and the variable name starts with the symbol $. That is, it outputs the log message “Cannot send message to the number” and displays it in the status.
20. **Block “Assign Value to Variable”** sets new values for one or more variables. In this case, one value is specified in the properties to be assigned to one variable, respectively.
21. **Block “Log”** allows outputting arbitrary messages and/or variable values to the log during the execution of the robot's scenario. For this block, the property “Value” is specified, and the flag “Display in Status” is set. A text constant is indicated in quotes, and the variable name starts with the symbol $. That is, it outputs the log message “Message sending error.” and displays it in the status.
22. **Block “Assign Value to Variable”** sets new values for one or more variables. In this case, one value is specified in the properties to be assigned to one variable, respectively.
23. **Block “Condition”** checks the specified condition for truth, after which the execution of the scenario continues towards the “Yes” exit (if the condition is met) or towards the “No” exit (if the condition is not met).
The condition is written in the format: “variable” equals (==)/ greater than (>)/ less than (<) “value”.
For example: $a == “Hello”, that is, if the value of the variable $a is equal to “Hello”, then the exit is “Yes”, otherwise – the exit is “No”.
$Result > 5, that is, if the value of the variable $Result is less than 5, then the exit is “Yes”, otherwise – the exit is “No”.
In this case, the condition is set as: $attempts<4. That is, the number of attempts must be less than 4.
24. **Block “Log”** allows outputting arbitrary messages and/or variable values to the log during the execution of the robot's scenario. For this block, the property “Value” is specified, and the flag “Display in Status” is set. A text constant is indicated in quotes, and the variable name starts with the symbol $. That is, it outputs the log message "Resending. Attempt No. " and the attempt number and displays it in the status.
25. **Block “Log”** allows outputting arbitrary messages and/or variable values to the log during the execution of the robot's scenario. For this block, the property “Value” is specified. A text constant is indicated in quotes, and the variable name starts with the symbol $. That is, it outputs the log message “Critical error...”
26. * 28. **Blocks “End”** (these blocks complete the execution of the scenario or return the subprocess diagram to the main process).
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.sherparpa.ru/en/sherpa-rpa/sherpa-designer/primery-robotov/whatsapp.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
