Troubleshooting Guide

If your agent isn't receiving webhook data:

1. Verify the webhook URL is correct

   Copy the URL from Dashboard → Your Agent → Webhook URL

2. Check agent status is "Active"

   Paused agents don't receive webhooks

3. Test with our webhook tester

   Dashboard → Your Agent → "Test Webhook" button

4. Check your source is sending data

   Use a tool like webhook.site to verify your form/app is sending

If you're getting authentication errors:

• • If using API Key auth, include X-API-Key header
• • Check that the API key hasn't been rotated or revoked
• • Verify the key has permission for the agent you're calling

Webhooks timeout after 30 seconds. If your agent takes longer:

• • Enable "Async Mode" in your agent settings - we'll return 202 immediately and process in background
• • Configure a callback URL to receive results when processing completes

Common causes for failed executions:

1. Check execution logs

   Dashboard → Your Agent → Executions → Click any execution to see step-by-step logs

2. Verify input data

   The "Input" tab shows exactly what data the agent received

3. Check configuration

   Review your agent settings - scoring thresholds, routing rules, output actions

4. Test with sample data

   Use the "Test" button to run with known good data

If agents are running slowly:

• • Check integration latency - Some APIs (enrichment services, AI processing) naturally take 5-10 seconds
• • Review parallel vs sequential steps - Agents with many sequential API calls will be slower
• • Check our status page - We post about any platform-wide performance issues

OAuth tokens can expire. To fix:

1. Go to Dashboard → Integrations
2. Find the integration showing the error
3. Click "Reconnect" or "Re-authorize"
4. Complete the OAuth flow again

Pro tip: Some services (like Google) require re-authorization every few weeks if you don't use them regularly.

• 1. Verify the Inteliworks app is installed in your Slack workspace
• 2. Check the bot is invited to the target channel (/invite @Inteliworks)
• 3. Verify the channel name/ID in your agent config is correct
• 4. For private channels, ensure the bot has been invited

• • Ensure your HubSpot account has the required scopes (crm.objects.contacts.write)
• • Check for duplicate contacts - HubSpot may reject if email already exists
• • Verify field mapping matches your HubSpot properties

• • Try the "Forgot Password" flow at /forgot-password
• • Clear your browser cache and cookies
• • Try an incognito/private browser window
• • If using SSO, contact your IT admin to verify your account is provisioned

• • Payment failed: Update your card at Dashboard → Billing → Payment Methods
• • Need invoice: All invoices are available at Dashboard → Billing → Invoices
• • Cancel subscription: Dashboard → Billing → Cancel Plan
• • Refund request: Email support@inteliworks.io within 30 days

When you hit your execution or agent limit:

• • Agents will continue to run with overage charges ($0.02/execution)
• • Set hard caps at Dashboard → Settings → Usage Limits to prevent overages
• • Upgrade your plan for more included executions