Messaging Integrations

Talk to Aiven through Gmail, Telegram, and WhatsApp.

Messaging integrations are different from data connectors. While data connectors passively import your activity to build your AI Soul, messaging integrations let Aiven actively participate in your conversations — reading your emails, drafting replies, chatting with you on Telegram, and more.

Gmail

Connect your Gmail account and let Aiven handle your email. He reads incoming messages, understands the context, and either drafts replies for your approval or sends them automatically — all written in your personal voice.

How It Works

Gmail integration connects Aiven directly to your inbox via Google's API. When a new email arrives, Aiven:

1. Reads the incoming email content (sender, subject, body)
2. Checks it against safety filters
3. Generates a personalised reply using your AI Soul and communication style
4. Either saves it as a draft for your approval, or sends it automatically

Two Modes

Mode	How it works	Best for
Copilot	Aiven drafts replies and waits for your approval before sending. You can edit, approve, or reject each draft.	Users who want oversight on every email. This is the default mode.
Autopilot	Aiven reads and replies to emails automatically, without waiting for approval.	Users who trust Aiven's judgement and want hands-free email management. Opt-in only.

Credits

Email actions consume credits. Each email that Aiven processes (reading, generating a reply, sending) costs a small number of credits based on the email length. You can check your remaining email credits from within the app.

How to Connect

1. Open Settings > Connected Apps in the Aiffinity app.
2. Find Gmail and tap Connect.
3. Sign in to your Google account when prompted.
4. Grant permission for Aiven to read and send emails on your behalf.
5. Choose your preferred mode: Copilot (default) or Autopilot.
6. Aiven starts monitoring your inbox immediately.

Managing Drafts (Copilot Mode)

When Aiven drafts a reply in Copilot mode, you can:

• Approve — send the draft as-is
• Edit & Approve — modify the draft before sending
• Reject — discard the draft entirely

Pending drafts are visible in the app. You can review and manage all drafts from your Gmail connection screen.

How It Enriches Your AI Soul

Email content is analysed for personality signals and ingested into your memory graph. Both inbound and outbound emails help Aiven understand your communication style, tone, and preferences. This makes future replies more accurate and natural.

How to Disconnect

1. Go to Settings > Connected Apps.
2. Tap Gmail.
3. Tap Revoke Access.
4. Optionally, also revoke access from myaccount.google.com/permissions.

Privacy

Troubleshooting

• "Aiven isn't replying to emails" — Check that your Gmail connection is active in Settings > Connected Apps. Also verify you have sufficient email credits.
• "Replies don't sound like me" — Aiven's voice improves over time as he learns from your outbound emails and chat conversations. Continue chatting and the quality will increase.
• "I want to switch from Copilot to Autopilot" — Go to Settings > Connected Apps > Gmail and change your mode preference.
• "Wrong Gmail account" — Disconnect, then reconnect and ensure you sign in to the correct Google account.

Telegram

Talk to Aiven directly through Telegram. Send messages, voice notes, manage personas, and even purchase credits — all without leaving Telegram.

Features

• Text chat — have natural conversations with Aiven just like any other Telegram contact
• Voice notes — send voice messages that Aiven transcribes and responds to
• Personas — create and switch between multiple AI persona styles
• Group chats — add Aiven to Telegram group chats with configurable active/passive modes
• Mini App — access a rich in-chat experience through Telegram's Mini App
• Telegram Stars — purchase message and voice credits directly through Telegram's native payment system
• Personality insights — receive daily or weekly personality insight notifications

How to Link Your Account

There are two ways to link your Aiffinity account to Telegram:

Method 1: Magic Link

1. In the Aiffinity app, go to Settings > Connected Apps > Telegram.
2. Tap Link Telegram.
3. A magic link will open Telegram and start a conversation with Aiven's bot.
4. Your accounts are linked automatically.

Method 2: Link Code

1. Open Telegram and find @AivenBot (or search for "Aiven").
2. Send /start to begin.
3. You will receive a 6-character link code.
4. In the Aiffinity app, go to Settings > Connected Apps > Telegram and enter the code.
5. Your accounts are linked.

Credits

Telegram messages consume credits. Each message costs a small number of credits based on length. Voice messages cost additional voice credits based on duration.

• Check your balance: send /balance to Aiven on Telegram
• Purchase credits: use Telegram Stars (in-chat purchases) or buy through the Aiffinity app

Group Chats

You can add Aiven to Telegram group chats. When added, Aiven can:

• Respond when mentioned (@AivenBot)
• Participate actively in conversations (configurable)
• Share memory and context between group members (with consent)

How It Enriches Your AI Soul

All text messages and transcribed voice notes are processed for personality signals and ingested into your memory graph. This helps Aiven understand your communication patterns across platforms.

How to Disconnect

1. Go to Settings > Connected Apps in the Aiffinity app.
2. Tap Telegram.
3. Tap Revoke Link.

Privacy

Troubleshooting

• "Bot not responding" — Ensure your Aiffinity account is linked. Send /start to the bot to check.
• "Out of credits" — Check your balance with /balance. Purchase more credits via Telegram Stars or the Aiffinity app.
• "Can't link account" — The link code expires after a few minutes. Request a new one from the Aiffinity app.
• "Aiven not responding in groups" — Aiven only responds in groups when mentioned (@AivenBot) or when active mode is enabled for that group.

WhatsApp

Chat with Aiven through WhatsApp for quick conversations, onboarding, and app support. WhatsApp integration provides a familiar interface to get started with Aiffinity.

How It Works

Aiffinity's WhatsApp channel uses the WhatsApp Business Cloud API. When you send a message, Aiven reads it, generates a personalised response, and replies directly in the WhatsApp conversation.

24-Hour Trial

New users get a 24-hour free trial when they first message Aiven on WhatsApp. During the trial, you can:

• Chat with Aiven and experience AI-powered conversations
• Ask questions and get task updates
• Learn about Aiffinity's features

After the trial period, continue chatting with Aiven through the Aiffinity app or Telegram.

Account Linking

WhatsApp uses phone-based linking. If your WhatsApp phone number matches the one on your Aiffinity account, the connection is bridged automatically. No manual linking step is required.

How to Get Started

1. Open the Aiffinity WhatsApp channel (link available in the app or on aiffinity.me).
2. Send any message to start the conversation.
3. Your 24-hour trial begins automatically.
4. Chat naturally with Aiven — ask questions, get recommendations, or just talk.

Current Limitations

• Text only — voice notes, images, and media are not yet processed
• No credits system — WhatsApp does not currently have a credits/payment system
• Trial-focused — WhatsApp is primarily designed for onboarding and app support. For the full Aiven experience, use the Aiffinity app or Telegram.

How It Enriches Your AI Soul

If your WhatsApp account is linked, text messages are processed for personality signals and ingested into your memory graph, similar to Telegram.

Privacy

Troubleshooting

• "No response from Aiven" — Your trial may have expired. Continue chatting through the Aiffinity app or Telegram instead.
• "Messages not linking to my account" — Ensure the phone number on your WhatsApp matches the one on your Aiffinity account.