Common Errors and Solutions #
This comprehensive troubleshooting guide helps you quickly resolve common issues encountered while using Flowmatix.
Authentication Errors #
Invalid API Key (401 Unauthorized) #
Error: “Invalid API key or token expired”
Solutions:
- Verify API key is correctly copied from account settings
- Check if API key has expired and generate a new one
- Ensure API key has proper permissions for the operation
- Verify the Authorization header format is correct
Account Suspended #
Error: “Account access suspended”
Solutions:
- Check email for suspension notifications
- Review account billing status
- Contact support for account reactivation
- Ensure compliance with platform policies
WhatsApp Integration Issues #
Message Delivery Failures #
Error: “Message failed to deliver”
Common Causes:
- Invalid phone number format
- Recipient has blocked the business number
- WhatsApp Business account restrictions
- Template message not approved
Solutions:
- Verify phone number includes country code
- Check WhatsApp Business account status
- Use approved message templates only
- Test with different recipient numbers
Webhook Connection Errors #
Error: “Webhook verification failed”
Solutions:
- Ensure webhook URL is publicly accessible
- Verify SSL certificate is valid
- Check webhook verification token
- Review server logs for error details
Workflow Execution Problems #
Workflow Not Triggering #
Possible Issues:
- Trigger conditions not met
- Workflow is disabled or paused
- Integration connection issues
- Insufficient permissions
Debugging Steps:
- Check workflow status and logs
- Verify trigger configuration
- Test with manual trigger
- Review integration connection status
Action Execution Failures #
Error: “Action failed to execute”
Solutions:
- Check action configuration and parameters
- Verify required fields are populated
- Test integration connection
- Review error logs for specific details
Integration Connection Issues #
Third-Party Service Unavailable #
Error: “Service temporarily unavailable”
Solutions:
- Check third-party service status page
- Retry the operation after some time
- Verify service credentials are current
- Contact service provider if issue persists
Rate Limit Exceeded #
Error: “Rate limit exceeded”
Solutions:
- Reduce request frequency
- Implement exponential backoff
- Upgrade to higher rate limit plan
- Distribute requests across time
Data Synchronization Issues #
Duplicate Records #
Problem: Multiple records for same contact
Solutions:
- Review duplicate detection rules
- Use merge contact functionality
- Implement unique identifier mapping
- Clean up existing duplicates
Data Mapping Errors #
Error: “Field mapping failed”
Solutions:
- Verify field names and data types
- Check for required field constraints
- Update mapping configuration
- Test with sample data
Performance Issues #
Slow Response Times #
Possible Causes:
- High system load
- Large data processing
- Network connectivity issues
- Complex workflow logic
Optimization Tips:
- Simplify workflow logic
- Use pagination for large datasets
- Implement caching where appropriate
- Monitor system performance metrics
Getting Help #
If you can’t resolve the issue:
- Check our status page for known issues
- Search the knowledge base for solutions
- Contact support with error details
- Include relevant logs and screenshots
