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

# Connecting channels

> Connect your Superagent to WhatsApp, Telegram, iMessage, Slack, and LINE, set up group chats, give it its own phone number, and install the browser extension.

Your Superagent is always available in Base44 chat. Connect WhatsApp, Telegram, iMessage, Slack, or LINE so it can respond outside Base44, send updates, run workflows, and continue conversations where you already work. You can also give it [its own phone number](#using-a-phone-number) for calls, and install the [browser extension](#browser-extension) so it can work in Chrome. You set these up from **Channels** in your Superagent's sidebar.

How your Superagent works on these channels:

* **Replies:** It responds in the right format for each channel, and can send images on WhatsApp, Telegram, Slack, and iMessage. On WhatsApp, it can also send you a PDF it created, up to 10 MB, as a file you can download in a personal chat or a group.
* **Messages while it's working:** When you message it mid-task in a personal chat, your message joins the work in progress. It picks it up at the next step and keeps what it's already done, so you can redirect it partway through. In a WhatsApp or Telegram group, your follow-ups join your own request the same way. If you reply to a specific message there, or write in any other group chat, your message waits its turn.
* **Requests from other people:** If someone else asks it to create or change a task, such as in a group chat, it explains in their language that the request needs your approval. They can ask you to set it up, or sign in through the review link it sends if they have access to your Superagent. Nothing is saved until the request is approved.

> [!NOTE]
>
> Base44 processes messages addressed to your Superagent so it can respond.

![The Channels page with WhatsApp, Telegram, iMessage, Slack, Phone, and the browser extension](https://mintcdn.com/base44/4ItADti_x6EER21Y/images/superagents-settings-channels.png?fit=max\&auto=format\&n=4ItADti_x6EER21Y\&q=85\&s=f9cf17429284f49016b92bbeb699bc55)

The channels you can connect your Superagent to

***

## WhatsApp

Connect WhatsApp so your Superagent can respond through WhatsApp in a personal chat. To have your Superagent read your own WhatsApp chats instead, see [reading your WhatsApp chats](https://docs.base44.com/superagents/browser-control.md#read-your-whatsapp-chats).

**To connect WhatsApp:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Connect** next to **WhatsApp**.
4. Scan the QR code or click **Open WhatsApp**.
5. Send the activation code.

![The Connect to WhatsApp step with the QR code and activation instructions](https://mintcdn.com/base44/_hOoxEYX1jYz_4bL/images/superagents-channels-whatsapp-qr.png?fit=max\&auto=format\&n=_hOoxEYX1jYz_4bL\&q=85\&s=c006b01ee669fae0c8982250a19dadc2)

Scanning the QR code to connect WhatsApp

> [!NOTE]
>
> **In your WhatsApp chat:**
>
> * When your Superagent needs your approval to install a skill or to pay on a website, it asks right in your WhatsApp chat. For a skill, reply Yes to install it or No to cancel. For a payment, reply with the approve or reject message it sends.
> * Your Superagent can react to your message with an emoji when it starts on a new request. In a WhatsApp group, it reacts only to messages that mention it or reply to it.
> * When you ask for a document, such as a report or invoice, your Superagent can send it as a PDF right in the chat. In a WhatsApp group, everyone in the group receives the file, so ask for private documents in your personal chat.

***

## WhatsApp groups

Create a group when you want multiple people to talk to the same Superagent in one shared conversation, such as a family trip chat or a team channel. After WhatsApp is connected, you can create and manage groups.

> [!NOTE]
>
> **How WhatsApp groups work:**
>
> * You can also ask your Superagent to create a WhatsApp group from the Superagent chat, a WhatsApp DM, or an existing WhatsApp group.
> * After you create a group and join it, your Superagent sends an intro message with its reply mode, the invite link, and important usage details.
> * Your Superagent only operates in the group while you remain a member.
> * When someone mentions your Superagent or replies to one of its messages with a new request, it may react with an emoji so they know it's on it.
> * AI usage from group activity is billed to your account.
> * You're responsible for informing everyone in the WhatsApp group that Base44 will access and process the messages and data shared in the group, including personal data.

### Creating a WhatsApp group

Create a group from your Superagent's WhatsApp settings, then share the invite link so people can join.

**To create a WhatsApp group:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Manage** next to **WhatsApp**.
4. Click **Create group**.
5. Enter the **Group name**.
6. (Optional) Enter a **Description**.
7. Choose how your Superagent replies:
   * **Reply only when @-mentioned:** Your Superagent replies only when someone mentions it directly. Best for larger groups.
   * **Smart reply — only when needed:** Your Superagent replies when it can add value to the conversation. Best for smaller, active groups.
8. Click **Create & Invite**.
9. Open the invite link in WhatsApp.
10. Invite contacts to join the group.

### Changing a group's picture

You can give a group its own picture, so people can spot it in their WhatsApp chat list. You can also ask your Superagent to change it in chat, and share an image or a link to one.

**To change a group's picture:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Manage** next to **WhatsApp**.
4. Click the arrow next to the group to open **Manage group**.
5. Click **Change group image** on the **Details** tab.
6. Choose an image. Use a square JPEG of at least 192 × 192 pixels and up to 5 MB.

![The Manage group window on the Details tab with Change group image outlined](https://mintcdn.com/base44/sQudaUBM2ldK_5S9/images/superagent-whatsapp-group-image.png?fit=max\&auto=format\&n=sQudaUBM2ldK_5S9\&q=85\&s=24d708e903b6afe75f6de1a91fa694bf)

Changing a WhatsApp group's picture

***

## Telegram

Connect Telegram so your Superagent can respond to messages through Telegram.

**To connect Telegram:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Connect** next to **Telegram**.
4. Scan the QR code or click **Open Telegram**.
5. Send the activation code.

> [!NOTE]
>
> When your Superagent needs your approval to pay on a website, it asks right in your Telegram chat. Reply with the approve or reject message it sends.

***

## Telegram groups

Add your Superagent to a Telegram group you already belong to, so everyone in the group can talk to it in one shared conversation. Everyone in the group talks to the same Superagent you do, with its usual personality, memory, and the tools you've given it. After Telegram is connected, you can add your Superagent to groups.

> [!NOTE]
>
> **How Telegram groups work:**
>
> * Anything that needs your permission as the owner still needs you, such as changing how your Superagent behaves, reaching your private data, connecting accounts, or sending broadcasts.
> * AI usage from group activity is billed to your account.
> * Your connected groups appear under **Groups** in your Superagent's Telegram settings. To disconnect one, click the arrow next to it, choose **Disconnect**, then confirm. You can also send `/disconnect` in the group.
> * You're responsible for informing everyone in the Telegram group that Base44 will access and process the messages and data shared in the group, including personal data.

### Adding to a group

Add your Superagent to a group from its Telegram settings, then pick the group in Telegram.

**To add your Superagent to a Telegram group:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Manage** next to **Telegram**.
4. Click **Add to group**.
5. Choose the group in Telegram. Telegram only lists groups where you can add admins.
6. Add the bot as an admin.

### Choosing when it replies

Choose whether your Superagent joins in whenever it can help, or only when someone asks for it. You can also ask your Superagent in the group to change this, as long as you're the owner.

**To choose when your Superagent replies in a group:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Manage** next to **Telegram**.
4. Under **Groups**, click the arrow next to the group.
5. Under **Replies**, choose an option:
   * **Reply to every message:** Your Superagent reads every message, replies when it can help and stays quiet during casual chatter. It always answers when someone @-mentions it or replies to one of its messages. This is the default.
   * **Reply when @-mentioned:** Your Superagent replies only when someone @-mentions it or replies to one of its messages. It still keeps earlier group messages for context.

***

## iMessage

Connect iMessage so you can interact with your Superagent from Apple devices.

**To connect iMessage:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Connect** next to **iMessage**.
4. Scan the QR code or click **Open iMessage**.
5. Send the activation code.

> [!NOTE]
>
> If other people chat with your Superagent on iMessage, you can see who's connected or disconnect someone by asking your Superagent in Base44 chat or in your iMessage chat. For example: `Who's connected to you on iMessage?` Anyone connected can also text `STOP` in their personal chat to disconnect, and needs a new activation code to reconnect.

***

## iMessage groups

Bring your Superagent into an iMessage group so you and other people can talk to it together in one shared conversation, such as a family chat or a small team thread. Everyone in the group talks to the same Superagent you do, with the tools you've given it. After iMessage is connected, you can create a new group from Base44 or add your Superagent to a group you already have in Messages.

> [!NOTE]
>
> **How iMessage groups work:**
>
> * Only you, as the Superagent owner, can set up and manage groups. Requests from other people that need your approval work the same way as in any other chat.
> * A group can have one Superagent at a time.
> * Your Superagent only replies in a group while you're still in it. If you leave the group, your Superagent disconnects from it.
> * AI usage from group activity is billed to your account.

### Creating an iMessage group

Create a group from your Superagent's iMessage settings. Base44 starts the group in Messages with you, your Superagent, and the people you add, and sends a first message so everyone knows it's there. You can also ask your Superagent to create a group in your private iMessage chat.

**To create an iMessage group:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Manage** next to **iMessage**.
4. Click **Create group** under **iMessage groups**.
5. Enter the **Group name**.
6. Enter the **Participant phone numbers** in international format, such as +14155550100, one number per line. You can add up to 30 people. You're added automatically and don't count toward the 30.
7. Choose how your Superagent replies:
   * **Reply only when mentioned:** Your Superagent replies only when someone types @Superagent in a message. This is the default.
   * **Reply to every message:** Your Superagent responds to every message in the group.
8. Click **Create group**.

> [!TIP]
>
> If **Create group** is grayed out after you've connected iMessage, disconnect iMessage and connect it again. Anyone else who chats with your Superagent on iMessage then needs a new activation code to reconnect.

### Adding an existing group

Add your Superagent to a group you already have in Messages, so you don't need to start a new one. Groups you add this way start out replying to every message. You can [change this](#managing-a-group) anytime.

**To add your Superagent to an existing iMessage group:**

1. Send `/groups` in your private iMessage chat with your Superagent. It replies with its phone number and a `/connect` message.
2. Open the group in Messages.
3. Add your Superagent's phone number to the group.
4. In the group, send the `/connect` message. It expires after 30 minutes.

### Managing a group

Open a group in your Superagent's iMessage settings to change when your Superagent replies, rename the group, add or remove people, or disconnect the group. Name, picture, and member changes can take a moment to show in Messages.

**To manage an iMessage group:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Manage** next to **iMessage**.
4. Click the arrow next to the group under **iMessage groups**.
5. Choose what to change:
   * **Replies:** Choose when your Superagent replies, then click **Save changes**. You can also send `/response mention_only` or `/response always` in the group.
   * **Details:** Update the group name and click **Save changes**. To change the picture, click **Change group image** and choose a square JPEG of at least 192 × 192 pixels and up to 5 MB.
   * **Members:** To add someone, enter their phone number in international format and click **Add member**. To remove someone, click **Remove member** next to them and confirm. A group always keeps you, your Superagent, and at least one other person.
   * **Disconnect group:** Click **Disconnect group** and confirm. Your Superagent stops replying, and the conversation and its history stay in Messages. You can also send `/disconnect` in the group. To connect the group again, send `/groups` in your private iMessage chat and follow the steps in [Adding an existing group](#adding-an-existing-group).

***

## Slack

Choose the Slack setup that matches how you want your Superagent to work:

* **Slack User connector:** Use this when you want your Superagent to work through your Slack account. It can work with messages sent to you in Slack and reply using your name.
* **Channel:** Use this when you want people in Slack channels to interact with your Superagent directly. They can mention it in a channel, your Superagent replies in a thread, and it can send workflow results to channels.

If you use the Channel setup, you can reach your Superagent with **@Superagent** or, when available, its **@handle**:

* **Its @handle, when available:** Use it to pick out one agent in a channel that has several.
* **@Superagent:** Reaches the agent you connected yourself, without needing to remember its handle.

> [!NOTE]
>
> Some Slack workspaces may not support or allow user groups, depending on the workspace's Slack plan or settings. If user groups aren't available, your Superagent doesn't have an **@handle**. Use **@Superagent** instead. **@Superagent** works on every Slack plan, including free plans.

**To connect your Superagent to Slack channels:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Connect** next to **Slack**.
4. Scan the QR code or click **Add to Slack**.
5. Approve the installation for your workspace.
6. In the Slack channel where you want to use your Superagent, type `/invite @Superagents by Base44`.
7. Select **Superagents by Base44** from the list.
8. Mention your agent's **@handle** or **@Superagent** to start chatting. Your agent replies in a thread, and each thread is a separate conversation.

![A Slack channel confirming the Superagent was invited and is ready to use](https://mintcdn.com/base44/6oggu6cuWvQ7SN1l/images/agent-connected-slack-1.png?fit=max\&auto=format\&n=6oggu6cuWvQ7SN1l\&q=85\&s=182a2a185893045bbecca82df57d3ab7)

Slack connection confirmation

> [!TIP]
>
> To invite additional Superagents to the same Slack channel, just mention the Superagent's **@handle**.

You can change your agent's handle at any time without disconnecting Slack or reinstalling the agent. Only the agent's owner can do this. A handle is lowercase and can include numbers, dots, hyphens, and underscores, up to 50 characters, and has to start and end with a letter or number.

**To rename your agent's handle:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Slack**.
4. Next to your agent's handle, click the **Edit handle** icon .
5. Enter the new handle.
6. Click **Save handle**.

![The Slack channel settings with the Slack handle field open, showing the handle, Cancel editing handle, and Save handle](https://mintcdn.com/base44/f8U1hRghO8T4Jz4x/images/slack-handle-superagent.png?fit=max\&auto=format\&n=f8U1hRghO8T4Jz4x\&q=85\&s=b6cdb5000566aabc7a63f0c97404a4bb)

Renaming a Superagent's Slack handle

> [!NOTE]
>
> If the handle you enter is already taken in your Slack workspace, Base44 asks you to choose another one.

***

## LINE

Connect LINE so your Superagent can respond to messages through LINE.

> [!WARNING]
>
> LINE is available in select regions.

**To connect LINE:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Connect** next to **LINE**.
4. Click **Generate Activation Code**.
5. Use the LINE app to scan the QR code.
6. Send the activation code to the bot in LINE.

***

## Browser extension

Install the **Superagent by Base44** browser extension to let your Superagent work directly in Chrome. It can browse sites, fill in forms, and complete tasks using the sites you are already signed in to. Learn more about [browsing with your Superagent](https://docs.base44.com/superagents/browser-control.md).

**To install the browser extension:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Install** next to **Browser extension**. The Chrome Web Store opens in a new tab.

***

## Using a phone number

Give your Superagent its own phone number. Have it call you with your morning briefing, make calls on your behalf, or pick up when you call it with a task. To let other people call your Superagent, add them as trusted callers in **Agent Settings** › **Trusted people**.

### Connecting a phone number

Verify your number and get a dedicated number for your Superagent. Connect it from your Superagent's settings, or ask your Superagent to connect it for you.

> [!WARNING]
>
> **Before you connect a phone number:**
>
> * **Plan:** You need a [Builder plan](https://base44.com/pricing) or higher to connect a phone number.
> * **Trusted callers:** You can add up to 20 trusted callers who can call your Superagent and ask it to take actions, so only add people you trust.
> * **Disconnecting:** Disconnecting releases the number for good, so you can't get it back. The same happens if your plan changes to one below Builder, such as when you cancel.

**To connect a phone number:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Connect** next to **Phone**.
4. Under **Your phone number**, select your country code.
5. Enter your number.
6. Click **Send code**.
7. Enter the code you receive.
8. Click **Verify**.
9. Click **Get my number**.

![The Connect a phone number screen, with the phone number field and a How it works summary](https://mintcdn.com/base44/91LrCOGP4K-frXT0/images/superagents-phone-connect.png?fit=max\&auto=format\&n=91LrCOGP4K-frXT0\&q=85\&s=51e0df5988a244ae97ffd3bd2d2b0fb2)

Verifying your own number before Base44 provisions one

> [!NOTE]
>
> **Once your phone is connected:**
>
> * Your Superagent receives a US number. If your own number is a US number, Base44 tries to match its area code. If a matching number is unavailable, Base44 uses another available US number.
> * You're responsible for ensuring that call recipients have consented to receive calls from your Superagent.

### Making calls

Your Superagent needs a [connected phone number](#connecting-a-phone-number) to make or receive calls. When your Superagent makes a call, you receive progress updates in the chat. You can see when the phone is ringing and when the call connects. After the call, your Superagent reports who it called, why, and what happened. Your Superagent can also press keys during outbound calls to navigate automated phone menus.

You can also have your Superagent place calls on a schedule, such as every Friday morning, by setting up a [scheduled workflow](https://docs.base44.com/superagents/setting-up-workflows.md#scheduled).

> [card] Ask your Superagent to make a call
>
> ```text wrap theme={null}
> Call me with my morning briefing and walk me through today's to-do list.
> ```
>
> ```text wrap theme={null}
> Call Tom and tell him our meeting has been postponed to 5 p.m. Let him know I'll call him at 4 p.m. to go over the details.
> ```

**To call your Superagent:**

1. Open your Superagent.
2. Click **Channels** in the sidebar.
3. Click **Manage** next to **Phone** to view your Superagent's number.
4. Call that number from your verified phone.

**To have your Superagent make a call:**

1. Open your Superagent.
2. Ask your Superagent to make a call for you in the AI chat. Include details and guidelines, such as:
   * **Who to call:** Share their number, including `+` and the country code. You can use their name if your Superagent already has their number. For a call to you, ask it to use your verified number.
   * **What to ask:** Explain the purpose of the call and the questions you want answered.
   * **What to do:** Tell it which actions to take, anything to avoid, and any limits to follow.
   * **Phone menus:** If the call starts with an automated menu, say so. Your Superagent listens to the menu, presses the right keys, and introduces itself once a person answers.
3. (Optional) Ask your Superagent in the AI chat for recent calls, their outcomes, or a specific call’s transcript. Only the owner can request call history. These requests are not available during a call.

***

## FAQs

> [accordion] What if my Superagent doesn't get a message or file?
>
> Send it again. In a personal WhatsApp chat, your Superagent lets you know when something didn't come through.

> [accordion] How do I manage a WhatsApp group?
>
> 1. Open your Superagent.
> 2. Click **Channels** in the sidebar.
> 3. Click **Manage** next to **WhatsApp**.
> 4. Find the group under **WhatsApp groups**.
> 5. Choose what you want to do:
>    * **Invite:** Copy or open the invite link.
>    * **Reply only when @-mentioned:** Set the Superagent to reply only when mentioned.
>    * **Smart reply — only when needed:** Set the Superagent to reply when it can add value to the conversation.
>    * **Rename:** Update the group name or description.
>    * **Manage members:** Manage group participants.
>    * **Delete group:** Delete the WhatsApp group.

> [accordion] Can I mention my Superagent in a Slack channel it has not been invited to?
>
> No. Your Superagent only sees messages in channels the bot has been invited to, so a mention anywhere else never reaches it. Invite the bot with `/invite @Superagents by Base44` in each channel where you want to use it. This applies to both **@Superagent** and the agent's **@handle**.
>
> Your Superagent can still post to a public Slack channel it has not joined, for example when a workflow sends an update there.

> [accordion] How do I disconnect a channel?
>
> To disconnect WhatsApp, Telegram, iMessage, and Slack, go to **Channels** and click **Manage** next to the channel. Then click **Disconnect** and confirm.
>
> To disconnect LINE, send `/disconnect` to the bot in LINE. To reconnect LINE, click **Connect** next to **LINE** and generate a new activation code.
>
> > [!NOTE]
> >
> > If you disconnect iMessage, anyone using iMessage with this Superagent needs to reconnect with a new activation code. Your Superagent also stops replying in your iMessage groups. After you reconnect, send `/groups` in your private iMessage chat to connect each group again.

> [accordion] How much do phone calls cost?
>
> Phone calls use 0.2 credits per minute, based on call duration. AI chat and background tasks can use additional credits.

> [accordion] How do I disconnect my Superagent's phone number?
>
> > [!CAUTION]
> >
> > Disconnecting permanently releases your Superagent's phone number. You can't get the number back.
>
> **To disconnect your Superagent's phone number:**
>
> 1. Open your Superagent.
> 2. Click **Channels** in the sidebar.
> 3. Click **Manage** next to **Phone**.
> 4. Click **Disconnect phone**.
> 5. Click **Yes, release the number**.


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