> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zonely.gen.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# Email, SMTP and Discord Bot Problems

> Troubleshoot email delivery, SMTP, SPF/DKIM and role or support-channel problems with the Zonely Discord connection.

Check SMTP settings for account verification and password reset emails. Discord roles and support use the central Zonely bot; you do not need to create a separate bot or enter a bot token.

***

## Most Frequently Asked Problems and Solutions

> [accordion] Account activation or password reset emails are not available to users
>
> SMTP and delivery problems that are frequently encountered in support requests:
>
> * **1. Port and Encryption (TLS/ SSL) Dispute:**
>   * **Port 587:** Encryption Type **TLS** or **STARTTLS** Selected.
>   * **Port 465:** Encryption Type **SSL** Selected.
>   * The encryption protocol with port is connected timeout when matches each other (`SMTP connect() failed`).
> * **2. Defending SPF and DKIM DNS Records:**
>   Although emails are sent, the SPF registration of your domain is missing if direct recipients fall into Spam/Gerek-free box or completely blocked by Gmail/Outlook.
>   * Add this SPF record in TXT type to your Cloudflare DNS management:
>     ```text title="Example SPF TXT Record" theme={"theme":"css-variables"}
>     v=spf1 include:_spf.mail-provider.example ~all
>     ```
> * **3. Verification with Test Email:**
>   Zonely Management Panel -> **Settings → Email Settings** *"Send Your Email"* button in the section, verify that your server can skip email to out.

> [accordion] Discord bot is connected to the server but does not give roles or unopen the support channel
>
> **The central Zonely bot is used**
>
> Do not create an application in the Discord Developer Portal for this connection. You are not asked to configure your own bot token or Gateway Intents. Check the connection in the Discord section of your Zonely dashboard.
>
> **Check the account and server connection**
>
> Make sure the correct Discord account and server are connected. Complete any pending role selection or verification step, then try again.
>
> **Check role order and channel permissions**
>
> If you manage the server, place the Zonely bot’s role above the roles it must assign. Check the permissions to view channels, send messages and manage the required support channels. Do not grant unnecessary Administrator access.
>
> **Open a support request if the problem continues**
>
> Send the error message and the relevant server and channel details to support. Do not share passwords, bot tokens or other secrets.

> [accordion] Discord Webhook notifications not working
>
> * **Unvalid Webhook URL:** Copying Webhook address `https://discord.com/api/webhooks/...` Make sure that the address is complete and there is no space at the beginning/end.
> * **Channel Permissions:** Bot or on Discord text channel connected by Webhook `@everyone` *"Send Message"* and *" Confirm that the Link is Opened (Embed Links)"* permissions.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.