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 most of these from Agent Settings in the sidebar, and messaging apps from Channels in the sidebar.
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, public template link, 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.
    • 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. Appears here when you own one Superagent in the workspace.
    • Clone agent: Create a copy of your Superagent. Appears when you own 2 or more Superagents in the workspace.
    • Move to workspace: Move your Superagent to another workspace you belong to. Appears when you own 2 or more Superagents in the workspace.
    • Delete this agent: Move your Superagent to Recently deleted.
A screenshot of General settings with the 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 you own 2 or more Superagents in the workspace. With one Superagent, find the public template link in General, and choose how memory works from the Memory page.
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. You can also ask your Superagent in chat to invite or remove collaborators.
    • 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.

​
Choosing how memory works

Choose whether your Superagent keeps memory separate for each conversation, shares it across all of them, or saves nothing. To choose how memory works:
  1. Open your Superagent.
  2. Click More in the sidebar, then click Memory.
  3. Click Change access.
  4. Under Memory mode, choose Separated memory, Shared memory, or No memory.

​
Connecting channels

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 for calls. Learn more about using a phone number. 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 directly mid-task, 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 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.
Base44 processes messages addressed to your Superagent so it can respond.
A screenshot of the Channels page with 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 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

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

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.

​
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.
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 are 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. In Telegram, choose the group and add the bot as an admin. Telegram only lists groups where you can add admins.

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

​
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 Channels in the sidebar.
  3. Click Connect next to Slack.
  4. Scan the QR code or click Add to Slack, then approve the installation for your workspace.
  5. In the Slack channel where you want to use your Superagent, type /invite @Superagents by Base44 and select Superagents by Base44 from the list.
  6. 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

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 Channels in the sidebar.
  3. Click Slack.
  4. Next to your agent’s handle, click the Edit handle icon .
  5. 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 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. 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. You can also add trusted callers who can call it too.

​
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.
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. 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 and enter your number.
  5. Click Send code.
  6. Enter the code you receive, then click Verify.
  7. Click Get my number.
The Connect a phone number screen, 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 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.
  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 Channels in the sidebar.
  3. Click Manage next to Phone.
  4. Under Trusted callers, click Add a trusted caller.
  5. Under Name, enter the caller’s name.
  6. Under Their phone number, select their country code and enter their number.
  7. 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 with the 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 Superagent Developer settings with 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 a webhook so your Superagent sends events to your own endpoint when it receives a message or finishes a reply. 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. Under Events, select which events to receive: message.created when a message is received, message.completed when your Superagent’s reply is ready.
  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.
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, and uses developer settings, and Channels to update how it connects to messaging apps.
  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.
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 Channels in the sidebar.
  3. Click Manage next to Phone.
  4. Click Disconnect phone.
  5. 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. With one Superagent, open Sharing & access from the Memory page instead. Click More in the sidebar, click Memory, then click Change access. You can also ask your Superagent in chat to remove a collaborator.
Your Superagent keeps working after your plan ends, and nothing is deleted. Its memory, notes, files, conversations, workflows, channels, and connectors all stay as they are. Superagents don’t count toward the app limit on the Free plan.A few things change when your workspace moves to the Free plan:
  • Credits: Your Superagent uses your Free plan’s daily and monthly credits. When you run out, it stops replying until your credits reset, and scheduled workflows skip their runs until then.
  • Phone number: Your Superagent’s phone number is released for good. If you upgrade again later, you need to set up a new number.
  • Webhooks: Webhooks stop sending, and you can’t view or edit them until you upgrade to Builder or higher.
Learn more about canceling your subscription.