AgentForge
AgentForge
Get Started

Documentation

Documentation

Complete guides for building, configuring, and deploying AI agents with AgentForge.

Quick Start

Create your first AI agent in 5 simple steps.

AgentForge lets you build conversational AI agents without writing a single line of code. In less than 10 minutes you can have a working agent, test it, and embed it in your website.

1

1. Create an account

Go to /signup and register with your email. After registration you'll be redirected to the billing page to choose a plan. Select the plan that fits your needs: Starter (€25/month) to get started, Growth (€79/month) for agencies, Scale (€297/month) for high volumes.

2

2. Create your first agent

From the dashboard click "New Agent". You can start from scratch, choose one of 12 pre-built templates (customer support, bookings, lead qualification, e-commerce...) or import a configuration from a URL. Choose the template closest to your use case to save time.

3

3. Configure the personality

In the Builder, under the Personality tab, set the agent's name, emoji avatar, language and tone. Write the system prompt: this is the core of the agent, defining how it behaves, what it knows, and how it responds. Add a welcome message and a fallback message for cases where it doesn't understand a question.

4

4. Test the agent

Use the live chat panel on the right side of the Builder to test the agent in real time. Every change to the system prompt is applied immediately. Try edge-case questions, verify the tone is correct, and that answers are accurate. Use the Rules tab to add specific behaviors (dos and don'ts).

5

5. Publish and embed

Go to the Deploy tab, click "Deploy & Get Link" to generate a shareable demo link. Copy the widget embed code and paste it into the <body> tag of your HTML site. The agent will be live immediately. You can also share the demo link directly with customers to gather feedback.

💡 Tip

Always start with an existing template and then customize it. You'll save at least 70% of configuration time.

Builder Guide

Explore the 7 Builder tabs and their features.

The Builder is the heart of AgentForge. It's divided into 7 thematic tabs covering every aspect of the agent, from behavior to deployment. On the right side you always have a live preview chat available.

Personality

Configure the agent's identity: name, description, emoji avatar, language and tone. The system prompt is the most important field: it defines who the agent is, what it knows, and how it responds. Choose from 6 preset tones (professional, friendly, formal, casual, empathetic, concise) and supports all languages.

Rules

Define specific behaviors with three lists: 'Dos' — positive instructions like always responding in English, quoting prices, using a certain format. 'Don'ts' — restrictions like not discussing competitors, not providing legal advice. 'Escalation Triggers' — phrases or situations that activate transfer to a human operator.

Flow

Control conversation behavior: maximum number of turns, simulated typing delay (to seem more human), automatic escalation when turn limit is exceeded, and the transfer message shown when handoff to an operator occurs.

Widget

Customize the chat widget's appearance: primary color, bot name, custom avatar URL, welcome message and position (bottom right, left or center). The preview updates in real time.

Deploy

Manage the agent's state (Draft, Testing, Live, Paused), configure the client website, enable the public demo and generate the embed code. The Publish button creates the demo link and sets the state to Live.

Channels

Connect the agent to external messaging channels: WhatsApp Business API, Telegram bot, Instagram Direct, Messenger. Each channel has its own configuration with tokens and webhook URLs to enter in the provider's panel.

Knowledge Base

Add a knowledge base to the agent by importing websites (the scraper automatically extracts text) or adding manual text (FAQs, price lists, documentation). The content is used by the AI model to respond with business-specific information.

💾 Saving

Remember to save your changes with the Save button in the top right. System prompt changes apply immediately in the preview but are only persisted upon saving.

Widget Embed

Embed your agent's chat on any website.

The AgentForge widget is a lightweight JavaScript snippet you can add to any HTML site, WordPress, Webflow, Shopify, or any platform that allows custom code. The widget loads asynchronously without impacting site performance.

1

Get the code

In Builder → Deploy, click "Deploy & Get Link". The code is automatically generated with your agentId and widget settings.

2

Paste into your site

Copy the <script> tag and paste it before the closing </body> tag on all pages where you want to show the chat. If you use a CMS, use the "Custom code" field in the global footer.

Example snippet

html
<script
  src="https://agentforge.solutions/widget/agentforge-widget.v2.js?v=2.3"
  data-agent="YOUR_AGENT_SLUG"
  data-color="#F97316"
  data-title="AgentForge Support"
  data-welcome="Hello! How can I help you today?"
></script>

Available attributes

  • →data-agent — Agent ID or slug (required)
  • →data-color — Widget hex color (e.g. #F97316)
  • →data-title — Title shown in the widget header
  • →data-welcome — Initial welcome message

🔵 WordPress

In WordPress, go to Appearance → Theme Editor → footer.php and paste the snippet before </body>. Alternatively use a plugin like "Insert Headers and Footers" to add the code without modifying the theme.

🌐 Webflow

In Webflow, go to Project Settings → Custom Code → Footer Code and paste the snippet. The widget will appear on all pages of the project.

⚡ Performance

The widget loads asynchronously and does not block page rendering. Total size is under 15KB gzipped.

Knowledge Base

Teach your agent business-specific information.

The Knowledge Base allows the agent to respond with accurate, business-specific information: prices, products, procedures, FAQs. You can import websites or add text manually.

Importing a website

1

Step 1

In Builder → Knowledge, click "Import Website".

2

Step 2

Enter the site URL (e.g. https://yourdomain.com) and an optional name for the document.

3

Step 3

Click "Import Site". The scraper visits the page, extracts the text and indexes it.

4

Step 4

The document appears in the list with "Ready" status. The agent will use this content to respond.

⚠️ Note

The scraper works on public HTML pages. It does not support content behind logins or heavily JavaScript-rendered pages. For complex sites, use manual text addition.

Adding manual text

Use the "Upload Manual Text" field to paste FAQs, price lists, product sheets, internal procedures, or any structured text. Assign a descriptive name (e.g. "Product FAQ", "2024 Pricing") to easily identify documents.

Limits and tips

  • ✓Each document can contain up to 100,000 characters.
  • ✓Add separate documents for different topics (prices, products, support) to improve accuracy.
  • ✓Update documents when information changes to keep the agent accurate.
  • ✓The more specific and structured the knowledge base, the more accurate the answers.

Channels

Connect your agent to WhatsApp, Telegram, Instagram and Messenger.

AgentForge supports integration with major messaging channels. Each channel requires specific configuration with the provider's API credentials. Configuration is in Builder → Channels.

💬 WhatsApp Business

Requires a WhatsApp Business API account (via Meta for Developers or providers like Twilio, 360dialog). You'll need: Phone Number ID, WhatsApp Business Account ID and a permanent Access Token. Enter the Webhook URL provided by AgentForge in the Meta dashboard to receive messages.

✈️ Telegram

Create a Telegram bot via @BotFather, get the bot token (format: 123456789:ABCDEFxxxxx). Paste it in the Telegram Token field in the Builder. AgentForge automatically configures the Telegram webhook to receive messages.

📸 Instagram Direct

Requires a Business Instagram account linked to a Facebook Page and access to Meta's Messenger API. Use Meta App Review to get the necessary permissions (instagram_manage_messages). Enter the Page Access Token and verify the webhook with the provided verification token.

💙 Messenger

Connect a Facebook Page to your agent. Create an app on Meta for Developers, add the Messenger product, select the Page and generate a Page Access Token. Configure the webhook with AgentForge's URL and subscribe to the "messages" event.

📋 Important notes

  • •WhatsApp and Instagram channels require business account verification by Meta (1-7 day process).
  • •Telegram requires no approvals: it's the simplest channel to configure.
  • •You can activate multiple channels on the same agent simultaneously.
  • •Messages received from all channels appear in the Conversations section of the dashboard.

API Keys

Integrate AgentForge into your applications via REST API.

API Keys allow you to interact with your agents programmatically: send messages, create agents, read conversations and more. Find them in Dashboard → Settings → API Keys.

Creating an API Key

1

Step 1

Go to Settings → API Keys.

2

Step 2

Click "New API Key" and assign a descriptive name (e.g. "CRM Integration", "Mobile App").

3

Step 3

Copy the generated key (format: sk-af-xxxxxxxxxx). It's shown only once.

4

Step 4

Use the key in the Authorization: Bearer sk-af-xxxxxxxxxx header of every request.

Main endpoints

  • POST /api/agents/{id}/chat — Send a message to the agent and receive the response
  • GET /api/agents — List all your agents
  • GET /api/conversations — List conversations
  • GET /api/analytics — Aggregated analytics data

Example request

bash
curl -X POST https://agentforge.solutions/api/agents/{agentId}/chat \
  -H "Authorization: Bearer sk-af-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hello, I need some help",
    "sessionId": "session_abc123"
  }'

🔒 Security

  • !Never expose API Keys in client-side code (browser JavaScript).
  • !Use environment variables for API Keys in your servers.
  • !Create separate API Keys for each application or integration.
  • !You can delete and recreate keys at any time from the Settings page.

Webhooks

Receive real-time notifications about your agent's events.

Webhooks allow AgentForge to send HTTP notifications to your server when specific events occur: new messages, conversations started, low credits. Perfect for Zapier, Make, or custom application integrations.

Outbound Webhooks (AgentForge → your server)

Configure outbound webhooks in Dashboard → Integrations → Webhooks. Enter your endpoint URL and choose the events to monitor.

Available events

  • agent.message_received— A user sent a message to the agent
  • agent.message_sent— The agent replied
  • conversation.started— New conversation started
  • conversation.ended— Conversation ended
  • agent.created— A new agent was created
  • credit.low— Credits running low (below 10%)

Example payload

json
{
  "event": "agent.message_received",
  "timestamp": "2025-03-11T10:00:00Z",
  "agentId": "clxxx...",
  "data": {
    "conversationId": "clyyy...",
    "message": "Hello, I'd like to book an appointment",
    "sessionId": "session_abc123"
  }
}

Signature verification

Each webhook request includes the X-AgentForge-Signature header with an HMAC-SHA256 of the payload signed with your secret. Always verify the signature to ensure the request comes from AgentForge.

javascript
const crypto = require('crypto');

function verifySignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(JSON.stringify(payload))
    .digest('hex');
  return `sha256=${expected}` === signature;
}

Inbound Webhooks (your system → AgentForge)

You can also send messages to your agent from external systems via the inbound webhook. The URL is in the Integrations section in the format: /api/webhooks/inbound/{userId}. Useful for receiving notifications from Zapier or Make and having them handled by the agent.

🔗 Zapier / Make Integration

Use the outbound webhook as a trigger in Zapier or Make to automate flows: when an agent receives a message → add lead to CRM, send notification email, create task in Notion, etc.

Sub-Accounts

Manage your clients with separate, isolated accounts.

Sub-Accounts (available from the Growth plan) let you manage agents on behalf of different clients while maintaining organization and separation. Each sub-account has its own name, email, website and logo. Perfect for agencies managing multiple clients.

Creating a sub-account

1

Step 1

Go to Dashboard → Clients → New Client.

2

Step 2

Enter client name, email, website URL, logo and internal notes.

3

Step 3

The sub-account is created. Now you can assign agents to it.

Assigning agents to a client

1

Step 1

Go to Agents, find the agent you want to assign.

2

Step 2

Click ⋯ → "Assign to client" and select the sub-account.

3

Step 3

The agent now appears associated with the client in the agents list.

🔗 Shared portal

Each sub-account has a shared portal with a unique link. You can activate it to give clients read-only access to their agents and conversations, without access to the entire AgentForge dashboard.

🏷️ White-label

Combined with White-Label settings (Settings → Organization), you can present the platform with your own brand: logo, colors and custom domain. Your clients will see your brand, not AgentForge.

Plans & Credits

Understand how the credit system works and what each plan includes.

AgentForge uses a credit system: every message sent to an agent consumes 1 credit. Credits renew monthly with your plan. A paid plan is required to access the platform — choose the one that fits your needs after registration.

Available plans

STARTER — €25/month

500 monthly credits. Fast AI model. Up to 3 agents. Email support. Ideal for freelancers and small businesses.

GROWTH — €79/month

3,000 monthly credits. Fast and Advanced AI models. Unlimited agents. Client sub-accounts. Advanced analytics. Webhooks. Priority support.

SCALE — €297/month

10,000 monthly credits. All AI models (Haiku, Sonnet, Opus). Full white-label. Custom domain. SSO/SAML. Dedicated account manager.

Custom (Enterprise)

Tailored volumes and features for large organizations. Contact us at hello@agentforge.solutions to discuss a custom plan.

💳 How credits work

  • →1 credit = 1 user message sent to the agent.
  • →Credits are deducted from the agent owner's balance for every conversation, including widget demos.
  • →Credits reset and renew every month from your subscription start date.
  • →You can monitor remaining credits in the top bar of the dashboard.
  • →When credits drop below 10%, you receive an email notification and a credit.low webhook.

How to upgrade

Go to Dashboard → Billing and click "Choose plan" on the desired plan. You'll be redirected to Stripe for secure payment. The plan activates immediately after payment and credits are added to your account.

Go to Billing

FAQ

Frequently asked questions about AgentForge.

Didn't find the answer?

Our support team is available to help you.

Open a tickethello@agentforge.solutions