🔍 Quick Diagnostic

Start here to identify your issue:

Webhook not triggering?

Agent isn't receiving data

Agent errors?

Executions failing or incomplete

Integration problems?

Can't connect or sync data

Account issues?

🔗 Webhook Issues

Webhook not receiving data

If your agent isn't receiving webhook data:

Verify the webhook URL is correct
Copy the URL from Dashboard → Your Agent → Webhook URL
Check agent status is "Active"
Paused agents don't receive webhooks
Test with our webhook tester
Dashboard → Your Agent → "Test Webhook" button
Check your source is sending data
Use a tool like webhook.site to verify your form/app is sending

Test with cURL:

curl -X POST https://agents.inteliworks.com/webhook/YOUR_WEBHOOK_ID -H "Content-Type: application/json" -d '{"test": "data"}'

Authentication error (401/403)

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

Webhook timeout errors

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

🤖 Agent Errors

"Execution failed" error

Common causes for failed executions:

Missing required input

Check that your webhook payload includes all required fields. View the expected schema in your agent's "Input Schema" tab.

Integration disconnected

Go to Dashboard → Integrations and reconnect any that show "Disconnected" status.

Rate limit exceeded

If you're hitting API rate limits on connected services (Slack, HubSpot, etc.), the agent will fail. Check execution logs for details.

Agent running but not doing what I expect

Check execution logs
Dashboard → Your Agent → Executions → Click any execution to see step-by-step logs
Verify input data
The "Input" tab shows exactly what data the agent received
Check configuration
Review your agent settings - scoring thresholds, routing rules, output actions
Test with sample data
Use the "Test" button to run with known good data

Slow execution times

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

🔌 Integration Issues

"Connection expired" or "Access denied"

OAuth tokens can expire. To fix:

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

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

Slack messages not sending

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

HubSpot contacts not syncing

• 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

👤 Account Issues

Can't log in

• 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

Billing or subscription issues

• 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

Exceeded plan limits

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

Common Error Codes

Code	Meaning	Solution
E001	Invalid webhook payload	Check JSON format and required fields
E002	Authentication failed	Verify API key or reconnect OAuth
E003	Agent paused	Activate agent in dashboard
E004	Integration error	Check integration connection status
E005	Rate limited	Wait and retry, or upgrade plan
E006	Timeout	Enable async mode for long operations

Still Need Help?

Our support team typically responds within 2 hours during business hours.

Email Support View FAQ

Pro & Enterprise customers: Use the in-app chat for priority support

Essential Cookies

Functional Cookies

Analytics Cookies

Marketing Cookies