Chatva

Search documentation

Search titles, instructions and image captions. Use ↑ ↓ to choose a result, Enter to open, Esc to close.

Enter a channel name or describe the step you need.

    Documentation: Email

    Email

    Updated October 11, 2026

    On this page

    To both receive email and reply from Chatva, connect a mailbox through Yandex, Mail.ru or custom IMAP. Forwarding is a separate mode for receiving mail only.

    Before you connect

    • Access to the mailbox and its security settings.
    • For Yandex and Mail.ru, a dedicated app password. For a custom server, the IMAP hostname, login and password.
    • A separate email address for testing; do not send the test from the connected mailbox to itself.

    Open the correct workspace in Chatva → Channels → the channel card → Connect. On first connection, use Next to go through the introductory steps. In the mobile app, the same guide is available during onboarding and under Channels.

    Choose a method

    Yandex: enable IMAP and create an app password

    1. Open email client settings

      Sign into the intended mailbox and open Email clients. Enable IMAP and App passwords and OAuth tokens, then save your changes.

    2. Create a dedicated Chatva password

      Open Yandex ID App passwords. The manual path is Security → Access to your data → App passwords. Choose Mail, name the password Chatva and press Next.

    3. Copy the password from the new window

      Paste it into the password field when connecting Yandex in Chatva. It is shown once; if you close the window, create a new one. Yandex ID instructions.

    Yandex uses imap.yandex.ru:993 for incoming mail and smtp.yandex.ru:465 for outgoing mail over an encrypted connection. Chatva fills these in for the Yandex preset. Server settings and checks.

    Mail.ru: phone, access and app password

    1. Check the linked phone

      Check that a phone is linked in Mail ID contacts; it is required to create an app password.

    2. Allow IMAP and SMTP

      Open Settings → All settings → Security → External services. Check that access to mail via IMAP, POP and SMTP is enabled.

    3. Create the password and choose access

      In App passwords, choose Create, name it Chatva and continue. Choose Full access to Mail for both receiving and sending. Mail instructions.

    4. Copy the generated password

      Use it in Chatva instead of the mailbox's normal password. If you lose it, create a new one. Official guide with video.

    Illustration · Mail's official illustration shows the access choices. Choose Full access to Mail for receiving and replying; read-only access cannot send messages.

    Source: Mail blog: app passwords ↗

    Illustration · Mail's official illustration shows the access choices. Choose Full access to Mail for receiving and replying; read-only access cannot send messages.

    Source: Mail blog: app passwords ↗
    Mail illustration: Full access to Mail includes SMTP, IMAP and POP3

    Mail.ru servers: imap.mail.ru:993 and smtp.mail.ru:465 with SSL/TLS. Mail Help. If sign-in is blocked, check external-service access settings.

    Connect Yandex, Mail.ru or IMAP

    1. Enable mail client access with your provider

      Enable IMAP if it is disabled. Create a Chatva app password following your provider’s instructions. Your normal account password may not work.

    2. Choose the provider in Chatva

      Choose Yandex, Mail.ru or Custom IMAP. Enter the mailbox address and login; the login is usually the full address.

    3. Enter the app password

      For custom IMAP, also enter the hostname and port (usually 993). Remove whitespace introduced when copying the password.

    4. Press Next → Connect

      Chatva checks mailbox sign-in before saving. If the check fails, correct the login, password or IMAP access and retry.

    Forwarding: incoming only

    1. Choose Forwarding and enter your mailbox address

      Press Next to see your workspace’s individual inbound email address.

    2. Copy the address and save the channel

      The address has the form inbox-xxxxxxxx@in.chatva.app. Copy it from the form rather than constructing it. Press Connect before your provider sends a verification email.

    3. Configure forwarding with your mail provider

      Create a forwarding rule to the copied address in your mailbox settings. If verification is required, find the provider’s email in Chatva’s inbox and follow its instructions.

    4. Send a test email from another mailbox

      Write to your normal support address and confirm its text appears in Chatva. To reply to customers, switch the connection method to Yandex, Mail.ru or IMAP.

    Gmail: configure forwarding to Chatva

    1. Open Gmail settings on a computer

    In Gmail, choose the gear → See all settings → Forwarding and POP/IMAP (or Forwarding) → Add a forwarding address.

    Gmail forwarding tab and Add a forwarding address button. Frame from Google's official guide; the address in the image is Google's example.

    Source: Gmail Help: automatic forwarding ↗

    Gmail forwarding tab and Add a forwarding address button. Frame from Google's official guide; the address in the image is Google's example.

    Source: Gmail Help: automatic forwarding ↗
    Gmail forwarding tab and Add a forwarding address button

    2. Enter and verify your Chatva address

    Paste Chatva's inbound address → Next → Proceed → OK. Find Gmail's email in Chatva's inbox and open its verification link.

    Gmail dialog for pasting Chatva's inbound address. Frame from Google's official guide; the address in the image is Google's example.

    Source: Gmail Help: automatic forwarding ↗

    Gmail dialog for pasting Chatva's inbound address. Frame from Google's official guide; the address in the image is Google's example.

    Source: Gmail Help: automatic forwarding ↗
    Gmail dialog for pasting Chatva's inbound address

    3. Enable forwarding after verification

    Refresh Gmail settings, select forwarding to the added address, keep Gmail's copy in the inbox, then save at the bottom. Google's full guide.

    Enable forwarding in Gmail settings after verification. Frame from Google's official guide; the address in the image is Google's example.

    Source: Gmail Help: automatic forwarding ↗

    Enable forwarding in Gmail settings after verification. Frame from Google's official guide; the address in the image is Google's example.

    Source: Gmail Help: automatic forwarding ↗
    Enable forwarding in Gmail settings after verification

    For selective forwarding, configure a filter using Google's guide; messages in Spam are not forwarded automatically.

    Check incoming and outgoing mail

    1. Write from an external mailbox

      Send a message containing “Email test” to the connected address. IMAP is checked approximately once a minute, so delivery to the inbox may not be immediate.

    2. Check the sender and text in the inbox

      Unread mail may be loaded on the first IMAP connection. Use a separate new test message to distinguish it from existing mail.

    3. For IMAP, send a reply

      Reply from Chatva and check the external mailbox, including Spam. Forwarding mode does not support this step.

    How email is handled

    IMAP-channel replies are sent from the connected mailbox through its mail server. Chatva groups messages by sender address, not individual email subject. The channel currently transfers email text; email attachment import and full email thread preservation are not supported.

    Troubleshooting

    What happenedWhat to check
    Mailbox sign-in failedCheck the full login, app password and IMAP permission. For a custom server, verify hostname and port.
    Email has not appeared yetAllow for the next IMAP check; inspect the provider’s Inbox and Chatva’s inbox filters.
    Mail arrives but replies failMake sure you chose IMAP rather than forwarding. Check SMTP permission and custom-server compatibility with the settings above.
    Sign-in required after a password changeCreate a new app password and update the Chatva connection.