Download templates for solving reCaptcha here(you can change to your site to test):
SolveReCaptcha_Geckofx.dat
SolveReCaptcha_Chrome.dat
solve_recaptcha_sample.dat
How to use 2Captcha plugin?
We had added a plugin named 2Captcha, it can solve the common captcha and google reCAPTCHA. You must do the following steps before use this plugin to solve google reCAPTCHA:
1. Get your 2Captcha API key
2. Get the SiteKey of the page which you are trying to visit and has a reCAPTCHA.
You also can click this link to see how to find the SiteKey. https://youtu.be/ZqTMqCnY77Q
3. Get the page url which you are visiting.
4. Drag the 2Captcha plugin to your module, select "SolveRecaptchaV2" function and set the parameters.
5. After you get the recaptcha response, you need find a "textarea" control on the page by using following seek conditions, and set the recaptcha response as its "innerHtml" value.
Read more information from 2captcha.com
How to use NewCaptcha action? (There is some problem while using NewCaptcha action via 2Captcha or DeathByCaptcha, and we are solving it, so you only use it manually.)
The NewCaptcha also can solve the reCAPTCHA, you can use 2Captcha or DeathByCaptcha to solve them automatically. There are 2 tips you should know:
1. Fill your account information in Captcha Settings form.
2. When you set the action, you should select the image with description as the captcha image, just like this.
There are 2 samples for the NewCaptcha.
newcaptcha sample1 newcaptcha sample2
Note:
When you use 2Captcha in NewCaptcha action to solve the reCaptcha, you must change some settings here: https://2captcha.com/setting/edit
Change the "Priority api settings" option from "From here" to "From my software"
Because of the wrong task settings, many users from TAP4 cannot run their task normally. Here we suggest the users who know how to set correct task settings share your correct task settings. So other users can download it to use directly and also learn how to set the task correctly.
Here are some tips that you need to be care when you share your task:
1. What is the function of your task? That is to say what your task will do. It will be much better for others to learn if you can give the detailed description of each module's function you add.
2. How many accounts do you use when you run the task? The number of the accounts you use has a direct impact on the number of set in modules, so when other users are using your task, he can modify the settings according to their own situation.
3. Tag your task name when you upload your task data. When other users import your task to TAP, it will be easy for them to find the corresponding task to edit its settings.
Now, we will give you a sample:
Task Name: dm20160314
Task Function: Send DM to new followers
Run Accounts: 1 - all
Following is the steps:
1. Add a "GetContent" module, set the DM content you want to send to your followers.
2. Add a "AccountRunThread" module, select the accounts you want to do the DM operation.
3. Add a "Search" module under the "AccountRunThread" module, select "Importing a list of people"->"Use current account" option, then select "Search my followers" and "Search the newest followers" option. Now this module can search your new followers.
4. Add a "DirectMessage" module behind "Searh" module. Select "Search" module as people source and choose "Remove from data list" option. Select "GetConent" module as content source and choose "Move to the last of the data list" option because your content maybe need to be loop used.
Here is the task file: DM20160314
If you are not familiar with TAP4, please check the below link to view the tap4 document (suggest read it carefully) and some related tutorials. http://www.whitehatbox.com/bbs/BBSPost?postid=1795
There is a task analysis section in each of sample task. The purpose of it is to show you how to divide your task demand into a small step, and then create module to complete corresponding step. So that even complex tasks can easily be created success.
There are a few things that we need to explain before creating the sample tasks:
1. Search module is using Mobile page to search data, and the operation method you select on Basic Settings has no effect on it. So if you have select Desktop site as the Follow/Follow Back operation method, Search module won’t search data from Desktop site but from Mobile page.
2. When using the same keyword to search in Search keyword or Advanced search option. On the Search module’s settings interface, there are two types of search result you can select on the option "Type of search result". One is "People", and the other is "Tweets", and they get data from two different search pages. For "People", the searched out data is user. For "Tweets", the searched out data is tweet. Our customers always complain that when they use the Advanced search function to search People in TAP, the searched out results are different from the results which are searched out on their browser, that is because the default search result in your browser is tweet. You need to switch to Account page to search, and then you will get the same search result as TAP.
3. When we are creating the sample task, we just make an explanation to the options we enabled. And you can check the document (http://tweetattackspro.com/document/tap4_document.html) to know the detailed description of other options(we are working on it).
4. When creating the sample task, almost all the settings we used are default. But you can make a reasonable change according to the number of accounts you used to run your task.
5. The task analysis step is not always corresponding with the adding module step when creating task. For some analytical steps, you need to add multiple modules.
Sample task 1: use keywords to search users, and then follow them directly.
Task analysis: this task is to complete the follow operation. So first we need to search some users. And the demand of the task is using keywords to search users, and then do the follow operation without doing any filter operation for the searched out users. So, we can divide the task into two steps: 1. Use keywords to search users. 2. Do the follow operation.
Step 1. Add a Search module. On its settings interface, use this option (Keyword search) to search. Input the search keywords (notice: for multiple keywords, please use comma to separate them). On the option “Type of search result”, select “People”, and which means the searched out data will be users.
Step 2. We have searched out the users on step 1, so now we just need to follow them. We need to add a AccountRunThread module, because all the operation of follow/unfollow/tweet on TAP4 only can run below the AcountRunThread. On the AccountRunThread module, select account to do the operation.
Step 3. Add a Follow module below the AccountRunThread module. On its settings interface, select the Search module from step 1 as this module’s data source.
task file: sample_task_01.dat
Sample task 2: use keywords to search tweets, and then follow these tweets’ authors.
Task analysis: the difference between sample task 1 and sample task 2 is the searched out result. On sample task 2, we are using keywords to search tweets, and then search these tweets’ authors, and finally follow the authors. So this task steps will be different from sample task 1. We can divide it into 3 steps: 1. Use keywords to search tweets. 2. Search the tweets’ authors. 3. Do the follow operation.
Step 1. Add a Search module. On its settings interface, use this option (Keyword search) to search, and then input the keywords. On the option “Type of search result”, select “Tweet” (the selection of this option is different from sample task 1), and which means the searched out data will be tweets.
Step 2. Add another Search module. On its settings interface, select these two options: “Importing a list of tweet urls” and “From other module”. Select the Search module from step 1 as this module’s data source. On the option “Type of search result”, select “People”, and the “Get the author of tweets” option will be selected automatically, and which means the searched out data will be the tweets’ authors.
Step 3. We have got the authors on step 2, so now we just need to follow them. Add a AccountRunThread module, select account to do the operation.
Step 4. Add a Follow module below the AccountRunThread module. On its setting interface, select the Search module from step 2 as this module’s data source.
task file: sample_task_02.dat
Sample task 3: use the advanced search option to search users, and then follow them directly.
Task analysis: the difference between sample task 1 and this sample task is the search method. This sample task is using the Advanced search option to search. So we only need to do a little bit of modification on the basis of sample task 1: 1. Use the advanced search option to search users. 2. Do the follow operation. The interface of the advanced search between TAP4 and Twitter is the same. So if you do not know how to fill in the search information for getting the users or tweets in TAP4, you can visit Twitter’s advanced search page (https://twitter.com/search-advanced) in your browser first, then test the filled in information and then fill in the correct information in TAP4’s advanced search option.
Step 1. Add a Search module. On its settings interface, select “Advanced search” option, and then click the “Click to set advanced settings” option to open the advanced search interface, finish filling in the information for it. On the option “Type of search result”, select “People” and which means the searched out data will be users.
Step 2. Add a AccountRunThread module. On its settings interface, select account to do the follow operation.
Step 3. Add a Follow module below the AccountRunThread module. On its setting interface, select the Search module from step 1 as this module’s data source.
task file: sample_task_03.dat
Sample task 4: use the advance search option to search tweets, and then follow these tweets’ authors.
Task analysis: the difference between sample task 2 and this sample task is the search method. This sample task is using the Advanced search option to search. So here we only need to do a little bit of modification on the basis of sample task 2: 1. Use the Advanced search option to search tweets. 2. Search the tweets’ authors. 3. Do the follow operation.
Step 1. Add a Search module. On its settings interface, select “Advanced search” option, and then click the “Click to set advanced settings” option to open the advanced search interface, finish filling in the information for it. On the option “Type of search result”, select “Tweet” and which means the searched out data will be tweets.
Step 2. Add another Search module. On its settings interface, select these two options: “Importing a list of tweet urls” and “From other module”, and then select the Search module from step 1 as this module’s data source. On the option “Type of search result”, select “People”, and the “Get the author of tweets” option will be selected automatically, and which means the searched out data will be the tweets’ authors.
Step 3. We have got the authors on step 2, so now we just need to follow these authors. Add a AccountRunThread module, and on its settings interface, select account to do the operation.
Step 4. Add a Follow module below the AccountRunThread module. On its settings interface, select the Search module from step 2 as this module’s data source.
task file: sample_task_04.dat
Sample task 5: import a list of users, and then follow them.
Task analysis: this sample task is the most easily one on the follow task. We have known the users we want to follow, so we do not need to use any search method to search users. However, in TAP4 we still need to add a Search module to import these users, and then they can be used by other modules. Because the data used to these operation modules (follow/unfollow/tweet) can only be derived from other modules, and only the Search module and GetContent module can get data from outside directly. So here we also need two steps to finish the task: 1. Import the list of users to a Search module. 2. Do the follow operation.
Step 1. Add a Search module. On its settings interface, select these two options: “Importing a list of people” and “Import from a list”. Click the “Import” option to open the interface, and you can select “Add” or “Import” button to input users. On the option “Type of search result”, select “People”.
Step 2. Add a AccountRunThread module, and then select account to do the follow operation.
Step 3. Add a Follow module below the AccountRunThread module. On its settings interface, select the Search module from step 1 as this module’s data source.
task file: sample_task_05.dat
Sample task 6: import a list of tweets, and then follow these tweets’ authors.
Task analysis: comparing with sample task 2, we can know that the demands of this task do not need to do the search process, so this task steps will be simpler: 1. Search the tweets’ authors. 2. Do the follow operation.
Step 1. Add a Search module. On its settings interface, select these two options: “Importing a list of tweet urls” and “From other module”. Click the “Import” option to open the interface, and you can select “Add” or “Import” button to input urls. On the option “Type of search result”, select “People”, and then the “Get the author of tweets” option will be selected automatically, and which means the searched out data will be the tweets’ authors.
Step 2. Add a AccountRunThread module, and then select account to do the follow operation.
Step 3. Add a Follow module below the AccountRunThread module. On its settings interface, select the Search module from step 1 as this module’s data source.
task file: sample_task_06.dat
Summary 1:
1. On the Follow and Addtolist task, both of them are getting a list of users first and then doing the follow or addtolist operation, so the settings of Search module for getting users can be used by each other commonly. That is to say, you can add a AddToList module to replace the Follow module above the follow tasks.
2. When set the setting for Follow or AddToList task, both need to do the operations for users, so the data source option “Type of search result” (Search module) we selected is always “People” on the Follow module.
Sample task 7: use keywords to search users, and then follow these users’ followers who do not use default avatar, have more than 50 followers, and do not have protected tweets.
Task analysis: comparing with sample task 1, this task is to follow the searched out users’ followers, and also we need to do some filter operation for these followers. So we only need to add extra two steps for this sample on the basis of sample task 1. 1. Search users’ followers. 2. Do the filter operation for the followers.
Step 1. Add a Search module. On its settings interface, select “Keyword search” option, and then input the keywords to search (use comma to separate multiple keywords). On the option “Type of search result”, select “People” (Default option).
Step 2. Add another Search module. On its settings interface, select these two options: “Importing a list of people” and “From other module”, and then select the Search module from step 1 as this module’s data source. On the option “Type of search result”, select “People”, and also check this option “Search people’s followers” on, so now the user’s followers can be searched out. Besides, on this option “Search amount from one account per time”, you can set how many followers it will search out for each user. In addition, you can set the order for each user to search followers.
Step 3. We have searched out the users’ followers on step 2, so now we need to do some filter operation for the followers. On the search module, the searched out information for the followers only includes their usernames, so we need to add a GetDetails module to get more detailed information before doing the filter operation. Add a GetDetails module. On its settings interface, select the Search module from step 2 as this module’s data source. On this option “Select one account for getting details information”, you can select one account, and then the program will get the follow and followed relationship between the account you select and the followers searched out on step 2. The default value for this option is none. If the amount of the data source is larger, you can set a higher value for this option “The thread amount when scraping detail information”.
Step 4. Add a Filter module. On its settings interface, select the GetDetails module from step 3 as this module’s data source, and then check these three options on “The people with default avatar”, “The people which is a protected account”, and “The people whose followers is less than X” (“The people who is already followed by me” and “The people who already follow back me” option are disabled). According to the demand of the task, the follower that is fit with the three options won’t be followed (The description of the three options is different from the demand of the task, and what we need to do is to remove the followers). So we need to check these two options on “Only need to fit any of three selected options” and “Remove”, now the follower will be removed who is fit for one of the three options, and the rest followers are what we need.
Step 5. Add a AccountRunThread module, and then select account to do the follow operation.
Step 6. Add a Follow module below the AccountRunThread module. On its settings interface, select the Search module from step 4 as this module’s data source.
task file: sample_task_07.dat
Sample task 8: use the advanced search option to search users, and then follow the users’ following which are not followed by me, have been active in 7 days, and do not in my blacklist.
Task analysis: this sample task is the expand version of sample task 3. This task we need to follow the searched out users’ followings but not the users. Besides there are some filter conditions for the followings. So we only need to add two extra steps for this task on the basic of sample task 3: 1. Search the users’ followings. 2. Do the filter operation for the followings.
Step 1. Add a Search module. On its settings interface, select the Advanced search option, and then click the “Click to set advanced settings” button to set search value. On the option “Type of search result”, select “People” (Default option).
Step 2. Add another Search module. On its settings interface, select these two options: “Importing a list of people” and “From other module”, and then select the Search module from step 1 as this module’s data source. On the option “Type of search result”, select “People”, and also check this option “Search people’s following” on, so now the user’s followings can be searched out. Besides, on this option “Search amount from one account per time”, you can set how many followings it will search out for each user. In addition, you can set the order for each user to search followings’ accounts.
Step 3. We have searched out the users’ followings on step 2, so now we need to do some filter operation for the followings. We have learned of the function of GetDetail and Filter module on sample task 7. On this sample module, the usage of these two modules will be a little difference. In the demand of the task, we need to follow the following which is not in the blacklist, and the searched out users’ following on the search module only includes following’s username which is enough for us to judge if the following is in the blacklist. So we only need to add a Filter module. On its settings interface, select the Search module from step 2 as this module’s data source, and then import the blacklist accounts in the Black & White list(Data included in this list will be removed) option. Now the following which is included in the blacklist will be removed from the searched out result first, and then use the default settings for these options: (“The people who is already followed by me” and “The people who already follow back me” are disabled)
Step 4. Here, we also need to do the filter operation for the rest followings in step 3. Add a AccountRunThread module, and then select account to do the follow operation.
Step 5. Add a GetDetails module below the AccountRunThread module. On its settings interface, select the Filter module from step 3 as this module’s data source. Behind the “Select one account for getting details information” option, the default setting is Current account, and it cannot be edit. The Current account is the account to do the follow operation, and it used to get the follow and followed relationship between the searched out following and the account.
Step 6. Add a Filter module behind the AccountRunThread module. On its settings interface, select the GetDetails module from step 5 as this module’s data source. Now, these two options “The people who is already followed by me” and “The people who already follow back me” are enabled. However, if the filter module do not below the AccountRunThread module, that means the filter module is used as Global module, and these two options are useless, so we disabled them. According to the demand of the task, we need to check these two options on: “The people who is already followed by me” and “The people without new tweets in X days”, and then select these two options: “Only need to fit any of the selected options” and “Remove”.
Step 7. Add a Follow module below the AccountRunThread module, and then select the Filter module from step 6 as this module’s data source.
task file: sample_task_08.dat
Summary 2:
1. Before adding the Filter module, we need to add a GetDetails module to get the details first. If you need to use these two options: “The people who is already followed by me” and “The people who already follow back me”, the GetDetails module and Filter module need to be added below the AccountRunThread module.
2. In the sample task 8, only there is one user needed to run, the GetDetails module from step 5 can be added outside the AccountRunThread module. That is to say step 5 can be added behind step 3, but you need to select the current run task account in the option “Select one account for getting details information”.
Here is a simple example of using Html UI, we will add another one which contains some JS functions later.
Download example here: HtmlUI_example1.zip, it contains a project file and html folder, please put the 'MyHtmlFiles' folder in your computer's D disk.
Some notes you need to read first:
1. If you use local Html resources, please DO NOT use 'iframe' in your html files.
2. You should add 'id' attribute to the tags that you want to operate.
2. When you want to use 'Html Attribute Operate' action, you can't select any html control. So you should edit this form first, and use 'Analysis Controls' function to load all tags and their id of the html page.
Image Recognition action is to find the one on the opened window range on BotChief by screenshot, and then click the screenshot section to visit the page you need. And the photo/text inside the screenshot is usually anchor text/photo. And it also can work with the common text/photo inside the screenshot, but it is meaningless to click it.
Steps about how to use this action:
1. Right click any action to add an Image Recognition action.
2. On its settings, click the Select Image button to make a screenshot on the current shown window on BotChief, and then double click when you move your mouse inside the screenshot, and then the screenshot you made will be below the Select image part.
3. When you click the Recognize test button, and then you can see the max similarity degree for the screenshot on current shown window.
4. Here you can custom a value for the similarity, but if the similarity you input is larger than the test result, then it means it cannot find out the screenshot on the current shown window.
5. When it matches the screenshot success, then it will click the screenshot. Here are two options you can select. The difference for them is one of them can work with the debug window hide.
6. Once you finished all, then you can click the Save button to save the settings. Right click this step to test it. See it jumpts to another page.
Notice:
1. These parts’ value will change by the current shown window’s size on BotChief. And you can ignore these settings.
2. You’d better not make the screenshot be too large. Just focus on the one you need.
Example module: ImageRecognitionExample.dat
Lock action is to lock the running threads, and only allow one thread to run these actions below the lock action per time when you run your module with multiple threads. So this action solved the previous problem which cannot run the module with multiple threads when there are these actions in your module: Upload File, Mouse Emulation(web), KeyStrokes Emulation, Flash Action, New Captcha.
In order to show you a better presentation, here we will run the two sample modules (Lock_001, Lock_002) on BotChief Runner. Notice: module Lock_001 does not have the Lock action, module Lock_002 has the Lock action, and we put the Show Variable action below the Lock action.
When you create task on Botchief Runner, please do not forget to check this option. Else it won’t run with multiple threads. Check the screenshot:
First, let’s check the task Lock_001, and set the running threads to 2. Click Start button, and set the running times to 2.
Check the screenshot, two debug windows and two show variables have shown up.
Use the same settings for task Lock_002. Check the screenshot, here two debug windows but only one show variable shown up. The reason is the Show variable action is below the Lock action, and each time only one thread can run. After this thread finished sucess, the next thread will run.
Example module: Lock_001 Lock_002
I'm sorry to tell you that you can't use some old data of TAP3 directly because the data structure of TAP4 is modified. But you can still use these data of TAP3>>
1. Accounts data: Use the "Export Accounts" function in TAP3 and save your accounts to a .csv file, then use "Import Accounts" function to import the data in TAP4
2. Use the old data saved in "save1" folder
3. Use the old data saved in "save" folder. You should rename some files:
GBL.dat -> GBlackWhiteList.dat
ML.dat -> GMessageList.dat
VL.dat -> GVariableList.dat
How to get your serial number of TAP3? There are two methods>>
1. Run TAP3 in WhiteHatBox, you can get the serial number on the Login form if you didn't set "Autologin"
2. Browse to local folder of TAP3, find the file named "user.inf" and open it with "Notepad", then you can find your serial number in this file.
Click here to upgrade to TAP4>>
http://license.domarketup.com/license/upgradetotap4.aspx
Videos of TAP4>>
http://www.whitehatbox.com/bbs/BBSPost?postid=1795
zhoucongcq 
zhoucongcq 
zhoucongcq 
zhoucongcq 
zhoucongcq