Troubleshooting Guide

Troubleshooting Guide

Solve common issues quickly and get your flows running smoothly. From lead rejections to integration errors, find practical solutions and debugging strategies.

🔍 Common Issues

[Lead Rejection Analysis](./lead-rejection-analysis.md)

Understanding why leads fail and how to fix acceptance rates.

• Time: 15 minutes
• Level: Beginner
• Tags: beginner, troubleshooting, analytics

[Integration Connection Errors](./integration-errors.md)

Fixing authentication, timeout, and delivery failures.

• Time: 20 minutes
• Level: Intermediate
• Tags: intermediate, troubleshooting, integrations

[Field Mapping Issues](./field-mapping-issues.md)

Solving data transformation and mapping problems.

• Time: 15 minutes
• Level: Intermediate
• Tags: intermediate, troubleshooting, mappings-focused

[Performance Optimization](./performance-issues.md)

Identifying and fixing slow flow processing.

• Time: 25 minutes
• Level: Advanced
• Tags: advanced, troubleshooting, performance-optimization

🎯 Specific Scenarios

[Facebook Lead Ads Issues](./facebook-lead-ads-issues.md)

Common Facebook integration problems and solutions.

• Time: 20 minutes
• Level: Intermediate
• Tags: intermediate, troubleshooting, integrations

[TrustedForm Certificate Errors](./trustedform-errors.md)

Debugging certificate validation and retention issues.

• Time: 15 minutes
• Level: Intermediate
• Tags: intermediate, troubleshooting, compliance

[Duplicate Lead Problems](./duplicate-issues.md)

Managing and preventing duplicate submissions.

• Time: 15 minutes
• Level: Intermediate
• Tags: intermediate, troubleshooting, data-management

[Volume Cap Troubleshooting](./volume-cap-issues.md)

Fixing cap calculation and reset problems.

• Time: 10 minutes
• Level: Intermediate
• Tags: intermediate, troubleshooting, business-logic

🛠️ Debugging Tools

[Using Events for Debugging](./using-events.md)

Master the Events system to diagnose issues.

• Time: 20 minutes
• Level: Beginner
• Tags: beginner, how-to, events-focused

[Testing Strategies](./testing-strategies.md)

Build test flows and use test mode effectively.

• Time: 15 minutes
• Level: Intermediate
• Tags: intermediate, best-practices, troubleshooting

📊 By Problem Type

For Vendor Issues

• Start with Lead Rejection Analysis
• Review Field Mapping Issues
• Check Using Events for vendor debugging

For System Integration

• Begin with Integration Connection Errors
• Platform-specific: Facebook Lead Ads Issues
• Compliance: TrustedForm Certificate Errors

For Data Quality

• Duplicate Lead Problems
• Field Mapping Issues
• Lead Rejection Analysis

For Performance

• Performance Optimization
• Volume Cap Troubleshooting
• Testing Strategies

🚨 Emergency Checklist

When everything seems broken:

1. Check System Status

   • Look for platform announcements
   • Verify external services are up

2. Review Recent Changes

   • What was modified in last 24 hours?
   • Did any integrations change?

3. Check Events

   • Find a failed lead in Events
   • Trace through each step
   • Look for error messages

4. Test with Simple Data

   • Create minimal test lead
   • Remove optional fields
   • Isolate the problem

5. Contact Support

   • Email: support@activeprospect.com
   • Include flow ID and event IDs
   • Describe what changed

💡 Troubleshooting Principles

Start with Events: Events tell you exactly what happened. Always check there first.

Isolate Variables: Change one thing at a time when debugging.

Test with Known Good Data: Use data that previously worked to identify what changed.

Check the Obvious: Is the flow active? Are credentials valid? Did something expire?

Document Solutions: When you fix something, write down what worked for next time.

🔍 Quick Diagnosis Guide

Symptom: No leads coming through

• Check: Source is active?
• Check: Authentication working?
• Check: Vendor sending to correct URL?

Symptom: All leads rejected

• Check: Acceptance criteria too strict?
• Check: Required fields being sent?
• Check: Field mappings correct?

Symptom: Delivery failing

• Check: Destination credentials valid?
• Check: Required fields mapped?
• Check: Destination system accepting data?

Symptom: Slow processing

• Check: Enhancement timeouts?
• Check: Complex rules?
• Check: Large field data?

📚 Related Documentation

• Events Reference - Understanding event data
• Integration Reference - Technical specifications
• Rules Reference - Rule debugging

🔧 Fix It Fast: Great troubleshooting is about systematic investigation, not guesswork. These guides help you diagnose issues quickly and get back to processing leads!