Documentation/Troubleshooting
Troubleshooting

Troubleshooting

Common SMTP, IMAP, static file, and billing debugging paths.

Email connection issues

SMTP timeout

Check whether the current network allows the SMTP port. Some ISPs block or intermittently throttle mail ports.

Test-NetConnection smtp.gmail.com -Port 465 Test-NetConnection smtp.gmail.com -Port 587

Connection unexpectedly closed

This usually means the port/security mode is wrong. Use SSL/TLS for port 465 and STARTTLS for port 587.

IMAP works but SMTP fails

IMAP and SMTP use different ports and provider rules. A working inbox test does not guarantee the network allows outbound SMTP.

Static UI looks stale

Hard refresh the browser after static CSS or JavaScript changes during local development.

Reply fetch issues

  • If reply fetching appears to load forever, check inbox size and IMAP response time.
  • Sonar should scan from the campaign's first successful send date rather than crawling the full inbox.
  • If replies are not matched, confirm that the reply arrived after the campaign send date and that the email address matches a campaign lead.

Billing issues

  • If checkout redirects back but verification fails, run checkout sync and inspect the Dodo subscription status.
  • If a plan change fails because of payment or provider-side issues, keep the local subscription on the previous verified plan.
  • Do not depend on webhooks until a public domain is available.