Skip to main content
Customize your Superagent to control how it responds, what it remembers, who can access it, and which channels and tools it can use. You manage all of these from Agent Settings in the sidebar.
An illustration of a Superagent connected to messaging apps, calendar, email and search tools

Superagent connected to tools and channels

​
Managing general settings

Manage your Superagent’s core settings, including its AI models, workspace app access, voice, and owner actions. To manage general settings:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click General.
  4. Update the relevant settings:
    • Chat: Choose the model your Superagent uses for conversations and tools in chat, or keep it on Automatic to match the best model for each request.
    • Automations: Choose the model your Superagent uses for scheduled and background tasks.
    • Cross-app data access: Choose which workspace apps your Superagent can access. Interactive actions run as the chatting user under their own permissions, and background watches run as you, the owner. See Working on your apps from chat.
    • Voice: Choose the voice your Superagent uses in voice mode during conversations.
    • Clone agent: Create a copy of your Superagent.
    • Move to workspace: Move your Superagent to another workspace.
    • Delete this agent: Move your Superagent to Recently deleted.
A screenshot of General settings showing AI model choices for chat and automations

The General settings for your Superagent

Deleting a Superagent disconnects its integrations immediately. You can restore the Superagent from Recently deleted for 30 days, but restoring it does not bring the integrations back.

​
Viewing credit usage

See which plan you are on and how many credits your Superagent has used. Monthly credits renew each billing cycle. To view credit usage:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Credit usage.
  4. Review your usage:
    • Message credits: Used when your Superagent processes messages and runs workflows.
    • Integration credits: Used for actions such as image generation, file processing, file upload, and creating download links.
    • Upgrade Plan: Move to a plan with more credits.
A screenshot of Credit usage settings showing message credits and integration credits

Reviewing your Superagent's credit usage

​
Sharing and managing access

Share your Superagent, manage who can chat with it, and choose how memory works across conversations.
Sharing & access appears in Agent Settings when your workspace has more than one agent.
To share and manage access:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Sharing & access.
  4. Update the available settings:
    • Invite collaborators: Invite people to access and chat with your Superagent. All collaborators consume credits from the workspace. You can always remove collaborators who no longer need access.
    • Public template link: Create a public link others can use to make their own copy of your Superagent. Template links do not include connectors, so anyone who opens the link connects their own accounts.
    • Memory: Turn memory on or off, and choose how your Superagent uses it:
      • Separated memory: Your Superagent remembers facts and history within each conversation, kept separate from the others. Choose this to keep each conversation self-contained.
      • Shared memory: Your Superagent remembers across all conversations, so what it learns in one is available everywhere.

​
Personalizing your Superagent

Update your Superagent’s identity and manage the personal context it uses when responding. Clear identity instructions help your Superagent respond in the right tone, format, and level of detail.
A screenshot of Personalization settings showing the Identity tab with agent name and About the agent

Setting your Superagent's identity

To personalize your Superagent:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Personalization.
  4. Choose what you want to update:
    • Identity: Hover over the Superagent image to update it, edit Agent name, and use About the agent to define who your Superagent is, how it responds, and what role it performs.
    • Memory: Update Your name and About you, review what the Superagent has learned about you, or delete memories you no longer want it to use.

​
Connecting channels

Your Superagent is always available in Base44 chat. Connect messaging channels so it can respond outside Base44, send updates, run workflows, and continue conversations where you already work. Supported messaging channels include WhatsApp, Telegram, iMessage, Slack, and LINE. Connected channels help your Superagent respond in the right format for each conversation. Your Superagent can also send images on WhatsApp, Telegram, Slack, and iMessage. You can also give it its own phone number for calls. Learn more about using a phone number. If you message your Superagent directly on one of these channels while it is already working, your message joins the work in progress instead of waiting for it to finish. Your Superagent picks it up at its next step and keeps what it has already done, so you can redirect it partway through a task. In a group chat, your message waits its turn as usual.
Base44 processes messages addressed to your Superagent so it can respond.
A screenshot of Channels settings showing WhatsApp, Telegram, iMessage, Slack, Phone and the browser extension

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. To connect WhatsApp:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Channels.
  4. Click Connect next to WhatsApp.
  5. Scan the QR code or click Open WhatsApp.
  6. Send the activation code.
A screenshot of the Connect to WhatsApp step showing the QR code and activation instructions

Scanning the QR code to connect WhatsApp

In your WhatsApp chat
  • When your Superagent needs your approval to install a skill, it asks right in your WhatsApp chat. Reply Yes to install it or No to cancel. Other actions that need your approval are handled in your Superagent in Base44.
  • While your Superagent works on a longer request, it may react to your message with an emoji so you know it has landed. It does this for longer or friendlier exchanges rather than every message, and not at all if you have asked it to skip emojis. Reactions happen in a personal chat only, not in a WhatsApp group.

​
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.
You are 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 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 Agent Settings in the sidebar.
  3. Click Channels.
  4. Click Manage next to WhatsApp.
  5. Click Create group.
  6. Enter the Group name.
  7. (Optional) Enter a Description.
  8. 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.
  9. Click Create & Invite.
  10. Open the invite link in WhatsApp.
  11. Invite contacts to join the group.
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.
  • AI usage from group activity is billed to your account.

​
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 Agent Settings in the sidebar.
  3. Click Channels.
  4. Click Manage next to WhatsApp.
  5. Click the arrow next to the group to open Manage group.
  6. Click Change group image on the Details tab and choose an image. Use a square JPEG of at least 192 × 192 pixels and up to 5 MB.
A screenshot of the Manage group window on the Details tab with Change group image outlined

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 Agent Settings in the sidebar.
  3. Click Channels.
  4. Click Connect next to Telegram.
  5. Scan the QR code or click Open Telegram.
  6. Send the activation code.

​
iMessage

Connect iMessage so you can interact with your Superagent from Apple devices. To connect iMessage:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Channels.
  4. Click Connect next to iMessage.
  5. Scan the QR code or click Open iMessage.
  6. Send the activation code.

​
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 automation 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.
Some Slack workspaces may not support or allow user groups, depending on the workspace’s Slack plan or settings. If user groups are not available, your Superagent does not 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 Agent Settings in the sidebar.
  3. Click Channels.
  4. Click Connect next to Slack.
  5. Scan the QR code or click Add to Slack, then approve the installation for your workspace.
  6. In the Slack channel where you want to use your Superagent, type /invite @Superagents by Base44 and select Superagents by Base44 from the list.
  7. Mention your agent’s @handle or @Superagent to start chatting. Your agent replies in a thread, and each thread is a separate conversation.
A screenshot of a Slack channel confirming the Superagent was invited and is ready to use

Slack connection confirmation

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 Agent Settings in the sidebar.
  3. Click Channels.
  4. Click Slack.
  5. Next to your agent’s handle, click the Edit handle icon .
  6. Enter the new handle, then click Save handle.
The Slack channel settings with the Slack handle field open, showing the handle, Cancel editing handle, and Save handle

Renaming a Superagent's Slack handle

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.
LINE is available in select regions.
To connect LINE:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Channels.
  4. Click Connect next to LINE.
  5. Click Generate Activation Code.
  6. Use the LINE app to scan the QR code.
  7. 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. To install the browser extension:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Channels.
  4. 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 to make and receive calls. Call it to discuss a question or task, or ask it in the AI chat to call you or someone else.

​
Connecting a phone number

Verify your own number and get a dedicated number for your Superagent. You can connect it from your Superagent’s settings, or ask your Superagent in the AI chat to connect a phone number and it walks you through it. You can also connect a number and manage trusted callers from the Base44 mobile app on iOS and Android.
Before you connect a phone number:
  • You need a Builder plan or higher to connect a phone number.
  • 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 releases the number for good, so you cannot get it back.
To connect a phone number:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Channels.
  4. Click Connect next to Phone.
  5. Under Your phone number, select your country code and enter your number.
  6. Click Send code.
  7. Enter the code you receive, then click Verify.
  8. Click Get my number.
A screenshot of the Connect a phone number screen for a Superagent, with the phone number field and a How it works summary

Verifying your own number before Base44 provisions one

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 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.

Ask your Superagent to make a call

To call your Superagent:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Channels.
  4. Click Manage next to Phone to view your Superagent’s number.
  5. 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.
  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.

​
Adding trusted callers

Allow people you trust to call your Superagent by adding them as trusted callers. To add a trusted caller:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Channels.
  4. Click Manage next to Phone.
  5. Under Trusted callers, click Add a trusted caller.
  6. Under Name, enter the caller’s name.
  7. Under Their phone number, select their country code and enter their number.
  8. Click Add caller.
Click the X icon next to a caller’s name to remove them from the trusted callers list.

​
Managing security settings

Manage what your Superagent can do on its own and how it handles sensitive information. To update security settings:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Security.
  4. Update the relevant settings:
    • Update data: Control whether your Superagent can edit records without asking first.
    • Delete data: Control whether your Superagent can remove records without asking first.
    • Auto-detect secrets in messages: Let Base44 detect API keys and tokens you paste, save them securely, and hide the raw value from the agent.
    • Secrets: Manage secure values available to your Superagent’s backend functions.
A screenshot of Security settings showing agent permission toggles and the Secrets area

Controlling what your Superagent can do without asking

  • Connector Rules: Tell your Superagent what it can and cannot do with each connected service, such as only reading emails and never sending or deleting them.
Only enable Update data or Delete data when your Superagent needs those permissions for its role.

​
Using developer settings

Access API settings and webhooks for your Superagent.
Webhooks require the Builder plan or higher. You can add up to 5 webhooks per Superagent.

​
Viewing the API reference

Connect your Superagent to your own code or product.
Before you begin: You need a personal access token that can reach this agent. You can create one from the Developer settings as you go.
To connect your Superagent to your own code:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Developer.
  4. Under Base URL, click Copy.
  5. Click Create access token, then follow the steps to create a token that can reach this agent. Click View all access tokens to use one you already have.
  6. In your own code, send the token in an Authorization: Bearer header, as the quick example shows.
A screenshot of a Superagent Developer settings showing the base URL, a quick example request, and Create access token

The Developer settings, with your base URL and an example request

​
Adding a webhook

Add webhook URLs so external systems can send events to your Superagent. To add a webhook:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Developer.
  4. Click View full API documentation.
  5. Scroll to Your webhooks and click Add webhook.
  6. Enter the webhook URL in the Target URL field.
  7. Select the Events you want to send.
  8. Click Create.
  9. Click Send test payload to test your webhook.
If you select Sign requests with an HMAC secret (optional), copy and store the signing secret when it is displayed. The signing secret is only displayed once.

​
Managing settings from chat

Your Superagent can manage its own settings when you ask it to in chat. As the agent owner, you can ask it to rename itself, update its description or instructions, switch its AI model, change how it uses memory, invite or remove collaborators, or move to another workspace. Your Superagent applies the change and confirms what it updated. For example:
Only the Superagent’s owner can change settings from chat. Your Superagent reads the available options first, so it only applies values that exist in your settings.

​
Working on your apps from chat

Your Superagent can also work on the apps you build with Base44, without you opening the app editor. In chat, you can ask it to:
  • List your apps: Ask which apps you have, or which one to work on.
  • Make a change to an app: Describe the change, and your Superagent sends it to the app editor to build, just as if you typed it there yourself. It asks for your approval first, names the app it is about to change, and the change uses your credits as usual.
  • Check an app’s status: See whether an app is ready, still building, or hit an error after a change.
  • Run a backend function: Trigger a function one of your apps already has, such as sending a report.
For example:
To choose which apps your Superagent can access:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click General.
  4. Under Cross-app data access, choose All workspace apps, No apps, or the specific apps you want it to reach.
A screenshot of the Cross-app data access dropdown listing All workspace apps, No apps and specific apps

Choosing which workspace apps your Superagent can access

Your Superagent cannot publish an app, connect a domain, or change your plan or billing.

​
FAQs

Click a question below to learn more.
Yes. You can open Agent Settings at any time to update how your Superagent behaves, responds, connects to channels, and uses developer settings.
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Channels.
  4. Click Manage next to WhatsApp.
  5. Find the group under WhatsApp groups.
  6. 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.
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 an automation sends an update there.
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.
If you disconnect iMessage, anyone using iMessage with this Superagent needs to reconnect with a new activation code.
Phone calls use 0.2 credits per minute, based on call duration. AI chat and background tasks can use additional credits.
Disconnecting permanently releases your Superagent’s phone number. You cannot get the number back.
To disconnect your Superagent’s phone number:
  1. Open your Superagent.
  2. Click Agent Settings in the sidebar.
  3. Click Channels.
  4. Click Manage next to Phone.
  5. Click Disconnect phone.
  6. Click Yes, release the number.
Collaborators can access and chat with your Superagent. Some settings and owner actions may only be available to the Superagent owner.
Yes. Open Agent Settings, go to Sharing & access, and manage or remove collaborators under People with access.