SOP-003: Connect Bots to AutoSolve
Aging Last updated: February 2022| Document Control | |
|---|---|
| SOP ID | SOP-003 |
| Version | 2.0 |
| Status | Active |
| Source | AYCD Zendesk |
Purpose
Configure a supported bot to send captcha requests to AutoSolve by providing the Access Token and unique Bot API Key.
Prerequisites
- [x] SOP-001 completed (AutoSolve enabled)
- [x] SOP-002 completed (Bot API Key created)
- [x] Supported bot installed (see Supported Bots)
Credentials Overview
┌─────────────────────────────────────────────────────────────────────────────────┐
│ AUTOSOLVE CREDENTIALS │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ YOUR AUTOSOLVE ACCOUNT │
│ ┌─────────────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ ACCESS TOKEN (Same for all bots) │ │
│ │ ┌─────────────────────────────────────────────────────────────────┐ │ │
│ │ │ xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx │ │ │
│ │ └─────────────────────────────────────────────────────────────────┘ │ │
│ │ └── Identifies YOUR AutoSolve account │ │
│ │ └── Copy from Dashboard: aycd.io/account#autosolve │ │
│ │ │ │
│ │ BOT API KEYS (Unique per bot instance) │ │
│ │ ┌─────────────────────────────────────────────────────────────────┐ │ │
│ │ │ Cybersole-Main ───► abc123-unique-key-for-this-bot │ │ │
│ │ │ NSB-Main ───► def456-unique-key-for-this-bot │ │ │
│ │ │ Wrath-Primary ───► ghi789-unique-key-for-this-bot │ │ │
│ │ └─────────────────────────────────────────────────────────────────┘ │ │
│ │ └── Routes captcha responses to the CORRECT bot │ │
│ │ └── Created in SOP-002 │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────────┘Connection Architecture
┌─────────────────────────────────────────────────────────────────────────────────┐
│ BOT TO AUTOSOLVE CONNECTION │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ YOUR BOT AUTOSOLVE ONECLICK │
│ ┌────────────┐ SERVER ┌──────────────┐ │
│ │ │ ┌──────┐ │ │ │
│ │ Captcha │ Access Token │ │ Request │ Solver │ │
│ │ Request │─────────────────►│ │──────────────────►│ Browser │ │
│ │ │ + API Key │ │ │ │ │
│ │ │ │ │ │ │ │
│ │ │◄─────────────────│ │◄──────────────────│ Token │ │
│ │ Receives │ Captcha Token │ │ Solved Token │ Generated │ │
│ │ Token │ (routed by key) │ │ │ │ │
│ │ │ │ │ │ │ │
│ └────────────┘ └──────┘ └──────────────┘ │
│ │
│ The API Key ensures the solved token goes back to the CORRECT bot! │
│ │
└─────────────────────────────────────────────────────────────────────────────────┘Procedure Flow
┌─────────────────────────────────────────────────────────────────────────────────┐
│ CONNECT BOT TO AUTOSOLVE │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ START │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 1. Open AutoSolve Dashboard │ │
│ │ aycd.io/account#autosolve │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 2. Copy Access Token │ │
│ │ [Copy Access Token] button │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 3. Copy Bot API Key │ │
│ │ Select key > [Copy] │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 4. Open Your Bot │ │
│ │ Find AutoSolve/Captcha │ │
│ │ settings section │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 5. Paste Access Token │ │
│ │ In "Access Token" field │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 6. Paste API Key │ │
│ │ In "API Key" field │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 7. Save Bot Settings │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 8. Verify Connection │ │
│ │ Check OneClick Connections │ │
│ │ tab │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ SUCCESS │
│ │
└─────────────────────────────────────────────────────────────────────────────────┘Step-by-Step Instructions
Step 1: Open AutoSolve Dashboard
Navigate to: aycd.io/account#autosolve
Or from OneClick: AutoSolve tab > Go To Dashboard
Step 2: Copy Access Token
Click [Copy Access Token] button:
┌─────────────────────────────────────────────────────────────────┐
│ Access Token │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌───────────────────────────────────────────────────────────┐ │
│ │ a1b2c3d4-e5f6-7890-abcd-ef1234567890 │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │
│ [Copy Access Token] ◄── Click this │
│ │
└─────────────────────────────────────────────────────────────────┘Step 3: Copy Bot API Key
Select and copy the key for THIS bot:
┌─────────────────────────────────────────────────────────────────┐
│ AutoSolve Bot API Keys │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Select Key: [ Cybersole-Main ▼ ] [Copy] ◄── Click │
│ │
└─────────────────────────────────────────────────────────────────┘Step 4: Open Bot Settings
Locate the AutoSolve configuration in your bot. Common locations:
| Bot | Settings Location |
|---|---|
| Cybersole | Settings > Captcha |
| NSB | Settings > AutoSolve |
| Wrath | Settings > Captcha Solver |
| Dashe | Settings > AutoSolve |
| Most bots | Settings or Config section |
Step 5 & 6: Paste Credentials
Enter both values in your bot:
┌─────────────────────────────────────────────────────────────────┐
│ [Your Bot] - AutoSolve Settings │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Access Token: │
│ ┌───────────────────────────────────────────────────────────┐ │
│ │ a1b2c3d4-e5f6-7890-abcd-ef1234567890 │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │
│ API Key: │
│ ┌───────────────────────────────────────────────────────────┐ │
│ │ xyz-unique-key-for-cybersole-main │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │
│ [Save] │
│ │
└─────────────────────────────────────────────────────────────────┘Step 7: Save Settings
Click Save or Apply in your bot's settings.
Step 8: Verify Connection
Check that your bot is connected:
- Open OneClick
- Go to AutoSolve tab
- Click on Connections view
- Your bot's API Key should appear when:
- The bot is opened, OR
- The first captcha request is sent
┌─────────────────────────────────────────────────────────────────┐
│ AutoSolve > Connections │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Name API Key Connected At │
│ ──────────────────────────────────────────────────────────────│
│ Cybersole-Main xyz...abc 2024-01-15 10:30:00 │
│ NSB-Main def...ghi 2024-01-15 10:31:00 │
│ │
│ [Refresh] [Reset Connection] │
│ │
└─────────────────────────────────────────────────────────────────┘Testing the Connection
Run a test task to verify everything works:
┌─────────────────────────────────────────────────────────────────────────────────┐
│ CONNECTION TEST PROCEDURE │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ 1. Ensure OneClick has AutoSolve started │
│ (Accounts with "AutoSolve Enabled" status) │
│ │
│ 2. In your bot, create a TEST task: │
│ - Use any site that requires captcha │
│ - Can use fake billing info (just testing) │
│ │
│ 3. Start the task │
│ │
│ 4. Watch OneClick: │
│ - AutoSolve > Tasks view should show incoming request │
│ - A solver should activate and attempt to solve │
│ │
│ 5. Check bot receives token: │
│ - Task should progress past captcha step │
│ - (May fail at checkout with fake info, that's OK) │
│ │
│ ✓ If token received = Connection successful! │
│ │
└─────────────────────────────────────────────────────────────────────────────────┘Bot-Specific Setup Guides
For detailed setup with specific bots, see these guides:
| Bot | Setup Guide |
|---|---|
| Cybersole | Zendesk Guide |
| NSB | Zendesk Guide |
| Wrath | Zendesk Guide |
| Dashe | Zendesk Guide |
| Full List | Supported Bots |
Troubleshooting
Bot Not Appearing in Connections
┌─────────────────────────────────────────────────────────────────┐
│ TROUBLESHOOTING: Bot Not Connecting │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 1. Verify Access Token is correct │
│ - Recopy from Dashboard │
│ - No extra spaces │
│ │
│ 2. Verify API Key is correct │
│ - Must be YOUR key, not someone else's │
│ - Recopy from Dashboard │
│ │
│ 3. Bot must send a request to connect │
│ - Some bots connect on open │
│ - Others connect on first captcha request │
│ - Try running a test task │
│ │
│ 4. Check bot has AutoSolve enabled │
│ - Some bots require enabling AutoSolve option │
│ │
└─────────────────────────────────────────────────────────────────┘Solves Not Delivering to Correct Bot
Cause: Same API Key used in multiple bots
Solution:
- Create unique API Keys for each bot instance
- Update each bot with its own unique key
- Restart bots after updating
Verification Checklist
┌─────────────────────────────────────────────────────────────────┐
│ VERIFICATION CHECKLIST │
├─────────────────────────────────────────────────────────────────┤
│ │
│ □ Access Token copied from Dashboard │
│ □ Unique API Key copied for this bot │
│ □ Both pasted into bot's AutoSolve settings │
│ □ Bot settings saved │
│ □ Bot appears in OneClick Connections (after request) │
│ □ Test task successfully received captcha token │
│ │
│ Ready to start using AutoSolve! │
│ │
└─────────────────────────────────────────────────────────────────┘