Skip to main content

​
Account & Authentication Issues

Possible solutions:
  1. Verify your credentials
    • Double-check your email address for typos
    • Ensure Caps Lock is off when entering your password
    • Remember that passwords are case-sensitive
  2. Reset your password
    • Click “Forgot Password” on the login page
    • Check your email for the reset link
    • Check your spam folder if you don’t see the email
  3. Check account status
    • Your account may be inactive or pending verification
    • Contact support if you believe this is an error
  4. Clear browser cache
    • Clear cookies and cached data
    • Try using an incognito/private browsing window
    • Try a different browser
If you continue to experience login issues, contact our support team with your registered email address.
Steps to resolve:
  1. Check your spam/junk folder - verification emails sometimes get filtered
  2. Wait a few minutes - email delivery can be delayed
  3. Verify email address - ensure you entered the correct email during registration
  4. Request a new verification email - look for a “Resend verification” option
  5. Check email settings - ensure your email provider isn’t blocking emails from kinconecta.com
If none of these work, contact support with:
  • Your registered email address
  • The date/time you registered
  • Any error messages you received
Common causes and solutions:
  • Browser settings: Ensure cookies are enabled in your browser
  • Multiple devices: Logging in from another device may end your current session
  • Inactive sessions: Sessions expire after a period of inactivity for security
  • Browser extensions: Ad blockers or privacy extensions may interfere - try disabling them temporarily
To maintain your session:
  • Don’t clear cookies while logged in
  • Avoid using “private/incognito” mode for extended sessions
  • Keep your browser updated

​
Profile & Search Issues

Troubleshooting steps:
  1. Check required fields
    • Ensure all mandatory fields are completed
    • Look for red validation messages
  2. Verify data formats
    • Phone numbers should be in correct format
    • Email addresses must be valid
    • Text fields may have character limits
  3. Check file uploads
    • Profile images must be under size limit
    • Use supported formats (JPG, PNG)
    • Ensure stable internet connection during upload
  4. Try these fixes
    • Click “Save” button explicitly (changes may not auto-save)
    • Refresh the page and try again
    • Clear browser cache
    • Try a different browser
If profile updates continue to fail, note which specific fields are problematic and contact support.
Why this might happen:For Tourists:
  • Your profile may be incomplete - the matching algorithm needs information to work with
  • No guides available in your selected destination
  • Your preferences may be very specific - try broadening your criteria
  • Guides in your area may not have complete profiles yet
For Guides:
  • Your guide profile may be incomplete or not verified
  • Your expertise areas may not match current tourist demand
  • Your service locations may be too limited
  • Few tourists are currently searching in your region
To improve matching:
  • Complete all profile sections thoroughly
  • Add multiple interests/expertise areas
  • Include all languages you speak
  • For guides: Create diverse tour plans
  • Try searching with broader filters
Improve your search results:
  1. Check your filters
    • Review all active filters (location, interests, categories)
    • Try removing some filters to broaden results
    • Verify spelling in search terms
  2. Location-based issues
    • Try searching nearby cities or regions
    • Some areas may have limited guide coverage
    • Check if you’re using the correct state/city names
  3. Clear and retry
    • Reset all filters and start fresh
    • Refresh the page
    • Try using different keywords
  4. Understanding match scores
    • Lower scores don’t mean bad guides - just different preferences
    • Review profiles even with moderate match scores
    • Match scores are based on your profile completeness
Common photo issues:Upload failures:
  • File size too large (check maximum size limit)
  • Unsupported file format (use JPG or PNG)
  • Slow or unstable internet connection
  • Browser extensions blocking uploads
Display issues:
  • Clear browser cache and refresh
  • Wait a few minutes - image processing can take time
  • Check if images display in a different browser
  • Ensure images aren’t corrupted
Best practices:
  • Use JPG format for photographs
  • Compress large images before uploading
  • Use landscape orientation for cover photos
  • Use square aspect ratio for profile avatars
  • Recommended minimum resolution: 800x600 pixels

​
Tour & Booking Issues

Common issues:
  1. Verification status
    • Your guide profile must be verified to create tours
    • Check your account status in settings
    • Contact support if verification is pending too long
  2. Required fields
    • All mandatory tour fields must be completed
    • Title, description, destination, and category are required
    • Price and duration must be specified
  3. Technical issues
    • Ensure stable internet connection
    • Try saving as draft first, then publishing
    • Check for browser console errors
    • Try a different browser
  4. Content restrictions
    • Descriptions must meet length requirements
    • Avoid prohibited content or spam keywords
    • Include appropriate category selections
Possible reasons:
  • Booking not confirmed - check trip status
  • Filter settings - adjust date range or status filters
  • Browser cache - refresh the page or clear cache
  • Sync delay - wait a few minutes and refresh
For Tourists:
  • Verify you received confirmation from the guide
  • Check if you’re looking in the correct date range
  • Ensure you’re logged into the correct account
For Guides:
  • Check if the tourist completed the booking process
  • Review all trip statuses (pending, confirmed, cancelled)
  • Verify the booking date is within your current view range
If the booking is genuinely missing, contact support with:
  • Tourist/Guide names involved
  • Tour name
  • Expected booking date
  • Any confirmation emails received
Current limitations:Kin Conecta’s integrated messaging system is planned for future versions. Currently:
  • Contact information may be shared through profiles
  • Some guides include contact details in their tour descriptions
  • Email addresses may be visible to facilitate direct communication
If you can’t reach someone:
  • Check if their profile includes contact information
  • Ensure you’re logged in to view full profile details
  • Verify the user’s account is active
  • Try creating a support ticket to request assistance with communication
The upcoming chat/messaging feature will streamline communication between tourists and guides directly within the platform.
For Guides managing trip status:
  1. Manual updates required
    • Trip status must be manually updated through the dashboard
    • Status changes are not automatic
  2. Valid status transitions
    • Ensure you’re using valid status values
    • Common statuses: pending, confirmed, in-progress, completed, cancelled
  3. Permission issues
    • Only the guide can update trip status
    • Ensure you’re logged in with the correct guide account
  4. Check status history
    • View trip status history to see all changes
    • Verify the latest update was saved
For Tourists checking status:
  • Status updates depend on guide action
  • Refresh your dashboard to see latest changes
  • Contact your guide if status seems incorrect

​
Technical Issues

Performance troubleshooting:
  1. Check your connection
    • Test your internet speed
    • Try connecting via different network
    • Close bandwidth-heavy applications
  2. Browser optimization
    • Clear browser cache and cookies
    • Close unnecessary browser tabs
    • Disable heavy browser extensions temporarily
    • Update browser to latest version
  3. Device performance
    • Close other applications
    • Restart your device
    • Ensure adequate available memory
  4. Try alternatives
    • Use a different browser
    • Try on a different device
    • Access during off-peak hours
If performance issues persist across multiple devices and connections, there may be platform maintenance occurring. Check back later or contact support.
Common error types:“Server Error” or “500 Error”
  • Temporary server issue - wait a few minutes and try again
  • Refresh the page
  • Clear cache and retry
  • If persistent, report to support with error details
“Not Found” or “404 Error”
  • The page may have been moved or deleted
  • Check the URL for typos
  • Use navigation menu to find the correct page
  • Report broken links to support
“Unauthorized” or “403 Error”
  • You may not have permission for that action
  • Ensure you’re logged in
  • Verify your account type (tourist vs. guide)
  • Check if your account is verified
“Bad Request” or “400 Error”
  • Invalid data submitted in a form
  • Check all required fields
  • Verify data formats (dates, phone numbers, etc.)
  • Try simplifying your input
When reporting errors:
  • Screenshot the error message
  • Note what action you were trying to perform
  • Include your browser and device information
  • Mention if the error is reproducible
General troubleshooting checklist:
  • Clear browser cache and cookies
  • Try using incognito/private browsing mode
  • Test in a different browser (Chrome, Firefox, Safari, Edge)
  • Disable browser extensions temporarily
  • Update your browser to the latest version
  • Try on a different device
  • Check if JavaScript is enabled
  • Verify you have a stable internet connection
  • Log out and log back in
  • Check if platform maintenance is scheduled
If issues persist after trying these steps, document:
  • Specific feature that isn’t working
  • Steps to reproduce the problem
  • Expected vs. actual behavior
  • Browser, device, and OS information
  • Screenshots or screen recordings
Then contact support with this information.

​
Database & API Issues (Developers)

For developers integrating with Kin Conecta:
  1. Authentication issues
    • Verify your API credentials
    • Check authentication headers
    • Ensure tokens haven’t expired
  2. Request format
    • Verify HTTP method (GET, POST, PUT, DELETE)
    • Check request headers (Content-Type: application/json)
    • Validate JSON payload structure
    • Ensure required parameters are included
  3. Endpoint issues
    • Verify the API endpoint URL
    • Check API version if applicable
    • Ensure proper URL encoding
  4. Rate limiting
    • Check if you’ve exceeded rate limits
    • Implement proper request throttling
    • Use pagination for large data sets
Test APIs using tools like Postman to isolate issues.
For local development setup:
  1. Check MySQL server 
    # Verify MySQL is running
sudo systemctl status mysql
# Or on Windows:
# Check Services app for MySQL service
  2. Verify connection settings in application.properties:
    • spring.datasource.url - correct host and port
    • spring.datasource.username - valid MySQL user
    • spring.datasource.password - correct password
    • Database kin_conecta exists
  3. Common fixes
    • Restart MySQL server
    • Verify MySQL user permissions
    • Check firewall settings
    • Ensure correct port (default: 3306)
  4. Schema issues
    • Run the schema SQL: kinConnect.sql
    • Load seed data: seed_kinconecta_5_registros.sql
    • Check hibernate ddl-auto setting
See the Development Guide for detailed setup instructions.
For developers working with the matching system:
  1. Profile completeness
    • Matching quality depends on complete profiles
    • Verify tourist/guide profiles have all fields populated
    • Check that language, interests, and preferences are set
  2. Score calculation
    • Review the scoring rules in matching README
    • Verify field weights are configured correctly
    • Check that bonus points are applying properly
  3. Database data
    • Ensure test data includes diverse profiles
    • Verify foreign key relationships are intact
    • Check that profile tables are properly populated
  4. API parameters
    • Verify limit and offset for pagination
    • Ensure correct user_id in request
    • Check role-specific endpoints (tourist vs guide)
Test endpoints:
# Get matched guides for tourist
GET /api/matching/tourist/{touristId}/guides?limit=10&offset=0

# Get matched tourists for guide
GET /api/matching/guide/{guideId}/tourists?limit=10&offset=0
See /workspace/source/socialNetwork/src/main/java/org/generation/socialNetwork/matching/README.md for detailed matching documentation.

​
Still need help?

Contact Support

Submit a support ticket for personalized assistance

FAQ

Check our frequently asked questions

Build docs developers (and LLMs) love

Get started for freeTalk to us