Messaging Integrations

Talk to Aiven through Gmail, Telegram, and WhatsApp.

See Messaging in the product overview →

Messaging integrations are different from data providers. While data providers passively import your activity to build your AI IP, 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 IP and preferences
4. Either saves it as a draft for your approval, or sends it automatically

Two Modes

Mode	How it works	Best for
Draft	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: Draft (default) or Autopilot.
6. Aiven starts monitoring your inbox immediately.

Managing Drafts (Draft Mode)

When Aiven drafts a reply in Draft 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 Helps

Email activity can help keep drafts, replies, and related personalization features more consistent over time.

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 usually improves as your settings and approved context build up over time. Continue using the feature and review drafts as needed.
• "I want to switch from Draft 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 messaging — 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-app experience through Telegram's Mini App
• Telegram Stars — purchase message and voice credits directly through Telegram's native payment system
• Aiven updates — receive daily or weekly Aiven update 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-app 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 Helps

Telegram helps keep your Aiven experience consistent across supported conversations and features.

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

Talk to 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:

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

After the trial period, continue talking to 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. Talk naturally with Aiven — ask questions, get recommendations, or just have a conversation.

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 Helps

If your WhatsApp account is linked, it can help keep supported replies and personalization features consistent, 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.