{"id":39814079,"url":"https://github.com/codeforequity-at/botium-connector-agentforce","last_synced_at":"2026-01-18T12:46:42.029Z","repository":{"id":311575524,"uuid":"1041286678","full_name":"codeforequity-at/botium-connector-agentforce","owner":"codeforequity-at","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-03T07:06:45.000Z","size":71,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-03T09:08:52.678Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codeforequity-at.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-20T09:05:22.000Z","updated_at":"2025-08-29T11:42:27.000Z","dependencies_parsed_at":"2025-08-25T10:55:31.995Z","dependency_job_id":"7f598563-cccc-4711-af86-4d00c1775885","html_url":"https://github.com/codeforequity-at/botium-connector-agentforce","commit_stats":null,"previous_names":["codeforequity-at/botium-connector-agentforce"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codeforequity-at/botium-connector-agentforce","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-connector-agentforce","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-connector-agentforce/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-connector-agentforce/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-connector-agentforce/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codeforequity-at","download_url":"https://codeload.github.com/codeforequity-at/botium-connector-agentforce/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-connector-agentforce/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28536060,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T10:13:46.436Z","status":"ssl_error","status_checked_at":"2026-01-18T10:13:11.045Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-18T12:46:41.896Z","updated_at":"2026-01-18T12:46:41.990Z","avatar_url":"https://github.com/codeforequity-at.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Botium Connector for Salesforce Agentforce\n\nA professional Botium connector for testing Salesforce Agentforce chatbots using the real Agent API.\n\n## Installation\n\n```bash\nnpm install botium-connector-agentforce\n```\n\n## Configuration\n\n### Required Capabilities\n\n| Capability | Type | Required | Description |\n|------------|------|----------|-------------|\n| `AGENTFORCE_INSTANCE_URL` | string | Yes | Salesforce org URL (e.g., https://myorg.my.salesforce.com) |\n| `AGENTFORCE_CLIENT_ID` | string | Yes | Connected App Consumer Key from Salesforce |\n| `AGENTFORCE_CLIENT_SECRET` | secret | Yes | Connected App Consumer Secret from Salesforce |\n| `AGENTFORCE_AGENT_ID` | string | Yes | Agentforce Agent ID (18-character ID starting with 0Xx) |\n\n### Optional Capabilities\n\n| Capability | Type | Default | Description |\n|------------|------|---------|-------------|\n| `AGENTFORCE_API_VERSION` | string | v61.0 | Salesforce API version |\n\n## Setup Instructions\n\n### 1. Create Salesforce Connected App\n\n1. In Salesforce Setup, navigate to **App Manager**\n2. Click **New Connected App**\n3. Fill in basic information:\n   - Connected App Name: `Botium Agentforce Connector`\n   - API Name: `Botium_Agentforce_Connector`\n   - Contact Email: Your email address\n4. Enable **OAuth Settings**:\n   - Callback URL: `https://login.salesforce.com/services/oauth2/success`\n   - Selected OAuth Scopes: Add required scopes\n5. Save the Connected App\n6. After saving, click **Edit** and enable **Client Credentials Flow**\n7. Set **Run As** to your user account\n8. Note the **Consumer Key** (Client ID) and **Consumer Secret**\n\n### 2. Configure Agentforce Agent\n\n1. Ensure Agentforce is enabled in your Salesforce org\n2. Create or configure your Agentforce agent\n3. Publish and activate the agent\n4. Copy the 18-character Agent ID from the agent URL\n\n### 3. Botium Box Configuration\n\nConfigure the following capabilities in your Botium Box project:\n\n```json\n{\n  \"CONTAINERMODE\": \"agentforce\",\n  \"AGENTFORCE_INSTANCE_URL\": \"https://your-org.my.salesforce.com\",\n  \"AGENTFORCE_CLIENT_ID\": \"your_consumer_key\",\n  \"AGENTFORCE_CLIENT_SECRET\": \"your_consumer_secret\",\n  \"AGENTFORCE_AGENT_ID\": \"0XxXXXXXXXXXXXXXXX\"\n}\n```\n\n## Testing Authentication\n\nUse the provided test file to verify your configuration:\n\n```bash\nnode prove-authentication.js\n```\n\nUpdate the configuration in the test file with your actual credentials before running.\n\n## Features\n\n- **Real API Integration**: Connects directly to Salesforce Agent API\n- **OAuth2 Authentication**: Secure Client Credentials Flow\n- **Session Management**: Automatic session creation and cleanup\n- **Message Processing**: Full support for text and rich content\n- **Intent Recognition**: NLP intent and entity extraction\n- **Error Handling**: Comprehensive error reporting\n\n## Supported Message Types\n\n### Text Messages\nStandard text message exchange between user and agent.\n\n### Rich Content\n- **Cards**: Title, subtitle, and image support\n- **Buttons**: Interactive button responses\n- **Entities**: Extracted entities with confidence scores\n- **Intents**: Recognized intents with confidence levels\n\n## Example Usage\n\n```javascript\nconst AgentForceConnector = require('./index.js').PluginClass;\n\nconst connector = new AgentForceConnector({\n  queueBotSays: (botMsg) =\u003e {\n    console.log('Agent Response:', botMsg.messageText);\n  },\n  caps: {\n    AGENTFORCE_INSTANCE_URL: 'https://your-org.my.salesforce.com',\n    AGENTFORCE_CLIENT_ID: 'your_consumer_key',\n    AGENTFORCE_CLIENT_SECRET: 'your_consumer_secret',\n    AGENTFORCE_AGENT_ID: '0XxXXXXXXXXXXXXXXX'\n  }\n});\n\nasync function testBot() {\n  try {\n    await connector.Validate();\n    await connector.Build();\n    await connector.Start();\n    \n    await connector.UserSays({ messageText: 'Hello' });\n    \n    await connector.Stop();\n  } catch (error) {\n    console.error('Error:', error.message);\n  }\n}\n\ntestBot();\n```\n\n## Troubleshooting\n\n### Authentication Issues\n- Verify Connected App Consumer Key and Secret are correct\n- Ensure Client Credentials Flow is enabled in the Connected App\n- Check that the Run As user has appropriate permissions\n\n### Session Creation Issues\n- Verify the Agent ID is the correct 18-character ID\n- Ensure the Agentforce agent is published and active\n- Check that your Salesforce org has Agent API access enabled\n\n### API Availability\n- Agent API may not be available in all Salesforce editions\n- Developer Edition orgs may have limited API access\n- Contact Salesforce Support if APIs are not available in your org\n\n## Requirements\n\n- Salesforce org with Agentforce enabled\n- Connected App with Client Credentials Flow\n- Published Agentforce agent\n- Node.js and npm\n\n## License\n\nMIT License","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeforequity-at%2Fbotium-connector-agentforce","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodeforequity-at%2Fbotium-connector-agentforce","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeforequity-at%2Fbotium-connector-agentforce/lists"}