User Guide

Everything you need to set up an AI chat agent on IN AI Agents — from creating your account to connecting Instagram, training it on your own content, and keeping an eye on how well it's performing.

1Getting started

Go to inaiagents.somethingworksin.com/dashboard and click Sign up to create an account with your email and a password, or Log in if you already have one. There's no separate admin key or setup step — sign up and you're in.

Forgot your password? Use the Forgot password? link on the login screen to get a reset email.

2Your first agent

An "agent" is one configured AI assistant — you can have several (e.g. one per brand or location). From Your agents, click + New agent and fill in:

  • Bot name — what it calls itself when replying.
  • Persona / instructions — tell it who it's speaking for, its tone, and what it should and shouldn't do. Be specific; this is the single biggest factor in reply quality.
  • AI provider and API key — IN AI Agents is "bring your own key" (BYOK): you connect your own OpenAI or Anthropic (Claude) account. We never see or store your conversations with the model beyond generating replies, and you're billed directly by your provider for usage.

Once created, open the agent and you'll see tabs for Overview, Channels, Data sources, Chat history, Leads, Booking, and Quality — covered below.

3Website widget

Every new agent gets a website chat widget automatically. On the Channels tab, copy the embed snippet (a single <script> tag) and paste it into your website's HTML, just before </body>. It'll start showing the chat bubble immediately — no rebuild or redeploy needed on your site.

Customize its look (theme, brand color, social links shown below the message box, and an optional lead-capture form) from the same tab — changes apply instantly to every page that already has the snippet.

4Instagram & Facebook

On the Channels tab, click Connect via Instagram (or Connect via Facebook). A popup opens Instagram/Facebook's own login screen — log in with the account that manages your Instagram Professional (Business/Creator) account or Facebook Page, and approve. That's it; no linked Page is required for the Instagram option.

Once connected, every DM carries two quick-reply buttons for your customers: Talk to a Human (pauses the AI for that one conversation) and Start Over (resets the conversation).

Heads up: the first time you connect, Instagram/Facebook may need a short review before messaging works for every customer. If a connection seems stuck, try again after a few minutes, or reach out — see Troubleshooting below.

5WhatsApp

WhatsApp requires a WhatsApp Business Platform phone number already set up through Meta. On the Channels tab, paste in the Phone number ID and access token from Meta's WhatsApp API setup page. There's no one-click popup for this channel yet.

6Gmail

Click Connect Gmail on the Channels tab and authorize the inbox you want the agent to auto-reply from. It checks for unread mail and replies automatically, then marks the message read so it isn't answered twice.

7Knowledge base (Data sources)

This is what your agent actually knows. On the Data sources tab, click + Add to feed it:

  • A website URL — it scrapes the page's text content (can be set to auto-retrain on a schedule, so it stays current).
  • An uploaded document (PDF, Word, etc.).
  • Pasted text — anything you type or paste directly.

Use Test retrieval at the bottom of that tab to type a question a customer might ask and see exactly which chunks of your knowledge base it would pull in — the fastest way to diagnose "it doesn't know X" (reword the source, or add more detail, if nothing matches).

8Welcome message

On the Overview tab, the Welcome message field is sent automatically the moment someone starts a brand-new conversation — before the AI's own reply, and only once per customer. On Instagram and Facebook it also becomes the native greeting shown in an empty chat before anyone's typed anything. Leave it blank to skip it.

9Appointment booking

On the Booking tab, connect Google Calendar, set your business hours and appointment length, and turn on Let the chatbot book appointments. Once enabled, the AI can check real availability and book directly onto your calendar during a conversation — on any connected channel — and sends a confirmation email if the customer gave one.

10Chat history & human takeover

The Chat history tab lists every conversation across all channels. Each row has a Pause AI button — click it to take over one specific conversation yourself (e.g. to reply personally in Instagram's own inbox) without pausing the whole agent. Click Resume AI when you're done; the bot sends a "you're back" message with the quick-reply buttons reattached.

A customer can also trigger this themselves by tapping Talk to a Human on Instagram/Facebook. On the Overview tab, you can set an auto-resume timer so a paused conversation picks itself back up automatically if staff forget to click Resume AI.

The Channels tab also has a separate Pause AI for this channel toggle per connected channel — use this to pause an entire channel in advance (e.g. before it's had its first conversation), not just one customer's thread.

11Leads

If you enabled the website widget's lead-capture form (Channels tab), every submission shows up on the Leads tab and — if you set a CRM webhook URL — is relayed there automatically too.

12Quality reports

The Quality tab analyzes your agent's real conversations in a date range you choose, using your own configured AI provider/key. Click Generate report and it returns:

  • A score out of 10 for how helpful and effective the agent's replies were.
  • Strengths and weaknesses it noticed in the actual transcripts.
  • A rewritten persona suggestion — click Apply to Overview tab to drop it straight into the persona field, then review and save it yourself.
  • Knowledge base gaps — topics the agent seemed to struggle to answer.
  • Communication tips — specific, actionable ways to improve.

Past reports are saved and listed below the generator, so you can track whether changes you make actually improve the score over time.

13Team & access

Click Team (top of the agent list) to invite teammates by email — they'll get an invite link and set their own password. Click Users if your account has admin access across the whole platform, to manage every customer account.

14Troubleshooting

  • "It doesn't know about X" — use Test retrieval on the Data sources tab to check whether that content is actually in the knowledge base and matching.
  • Instagram/Facebook replies aren't coming through — reconnect the channel from the Channels tab; if that doesn't help, the connection may need a brief platform review the first time (see the Instagram & Facebook section above).
  • Wrong model / API key error — double-check your API key on the Overview tab has access to the model you selected; some models require separate access from your provider.
  • Still stuck? Use the Contact us link in the dashboard footer.