Docs · Funnels and payments

AI agent in Instagram Direct: how it works and what it costs

The agent replies in Direct to people no funnel caught, following your rules and knowledge base. Every reply uses credits; the price depends on the model and the size of the knowledge base.

Updated: November 16, 2026

The AI agent replies to people in Instagram Direct on behalf of your account. It writes like a manager in a chat: briefly, in the customer's language, following your rules and knowledge base.

Set it up in Automations → AI agent. You turn it on and off there too.

You can do all of this through the MCP connector too: ask Claude or ChatGPT to set up the agent — rules, knowledge base, model, who gets the handover request, reply pace. The AI can turn the agent on or change a running one only after your "yes". You can also ask it which requests went to your team and whether they arrived

When the agent replies#

  • The agent only replies to messages that no funnel caught. If someone sent a keyword, the funnel runs first and the agent stays silent.
  • Voice messages are transcribed first, then answered (if "Understand voice messages" is on).
  • The agent understands photos: it sees what's in the picture (equipment, model, labels, damage) and replies accordingly. Photos don't cost extra credits.
  • Stickers and shares aren't handled yet — the agent doesn't reply to them.
  • If you reply to a customer yourself — from the Instagram app or from Conversations — the agent goes quiet in that conversation for the time set in "Pause after your reply", so it doesn't talk over a live manager.
  • The agent doesn't message contacts with the tag set in "Don't reply to contacts with this tag".

What it costs#

Every agent reply uses credits — the same ones you spend on chat and images.

The price per reply depends on the model and on the size of the rules and knowledge base together: the agent reads them in full for every reply. Up to 15,000 characters you pay the base price, then it goes up every 15,000 characters. Credits per reply:

Model up to 15,000 up to 30,000 up to 45,000 up to 75,000 up to 105,000
Claude Haiku 5.5 — recommended 1 1 1 1 1
Claude Sonnet 5 2 4 5 7 10
Claude Sonnet 5.5 3 4 5 8 10
Claude Opus 5.5 5 7 10 15 20
Claude Sonnet 4.5 3 5 7 11 15
GPT-6.1 Sol 2 3 4 6 8
Gemini 3.8 Flash 1 1 2 3 3
DeepSeek V4.1 Flash 1 1 1 1 2

The agent page shows the exact price for your agent as you type.

Pick the model at the bottom of the agent page — Claude, GPT, Gemini and DeepSeek. Your credit balance is shown there too.

The difference: 1-credit models are fast and fine for everyday questions — prices, booking, terms. 2–5-credit models handle long rules and tricky conversations better. Start with the recommended one and switch if replies feel weak. Switching models doesn't lose the conversation with the client.

Credits are only used for a reply that actually went out. If a reply wasn't sent (an error, or the Instagram conversation window closed), the credits come back.

The free trial includes 15 credits — 15 replies on a 1-credit model or 5 on a 3-credit one. How many credits your plan includes and how to buy more: see "Credits".

🔴 Out of credits — the agent stays silent. New Direct messages get no reply until you top up. Craft sends an email, a Telegram message (if Telegram is linked) and a bell notification — no more than once a day.

Rules and knowledge base#

  • Communication rule — who you are, how to talk, what to offer, what not to do. Up to 8,000 characters. The agent follows it first.
  • Knowledge base — prices, terms, answers to common questions. Paste text or upload a file.

The knowledge base can be up to 300,000 characters, and the agent reads all of it. The bigger it is, the more a reply costs (see "What it costs"), so it pays to remove what's not needed.

Videos, photos and files — the agent sends them itself#

Besides replying with text, the agent can send your Direct funnels: a video with a caption, photos, a catalogue, a PDF. In the agent settings, under "Materials the agent sends on its own", tick the funnels you want. When a customer asks for a video or material on a topic, the agent picks the right funnel by the meaning and language of the conversation and sends it in full — exactly as if the customer had typed its keyword.

  • The agent chooses by funnel name and keywords. Name funnels clearly: "Video — JET+ maintenance", "EN Video — JET+ maintenance" — then an English-speaking customer gets the English version.
  • Before the material the agent writes one short line; the details come in the video's caption.
  • If it's unclear which video is needed, the agent asks first instead of guessing.
  • A switched-off funnel is never sent.

🔴 After a handover to staff and while paused, the agent sends nothing. The same funnel goes to one person at most once every 30 minutes, even if they ask again.

Nothing ticked — the agent replies with text only, as before.

The agent in Telegram#

The same agent also replies in Telegram: in your bot's private chats and — if the bot is connected to Telegram Business — in your own account's private messages, on your behalf. On the agent page pick the bot in the Account list and switch the agent on.

  • Rules and knowledge base — the bot's own, or the same as an Instagram agent. With the second option you edit them in one place and both channels answer the same way.
  • It understands voice messages and photos, sends materials from the bot's funnels and hands the customer over to staff with a pause — all just like in Instagram.
  • It replies only to people no bot funnel caught. Commands like /start are left alone.
  • If staff reply themselves — from Dialogs, the work group or their own account via Telegram Business — the agent goes quiet in that chat for the pause period.
  • The bot shows "typing…" before replying.

⚠️ The agent works in Telegram and WhatsApp. VK and MAX don't have it yet.

Statistics#

The agent page shows the last 30 days: how many messages customers sent, how many times the agent replied, how many people it talked to, how many it handed over to staff, reply time (typical and for 9 replies out of 10) and how many credits went on agents. Reply time runs from the customer's message to the agent's reply — including the "typing…" pause if it's on.

Handing over to a person#

With "Hand ready-to-buy leads over to you" on, the agent hands a customer to your team when they are ready to buy, leave a phone number or email, ask for an invoice or a quote, ask to talk to a manager, or say nobody has got back to them.

What happens on a handoff:

  1. The agent writes a summary for your team: the task, known details, chosen option, stage, contact and next step. The customer doesn't see it.
  2. The summary is sent to Telegram — to your leads group or to the people you picked.
  3. Only if the summary was delivered does the agent tell the customer they've been passed on. If it wasn't, the agent doesn't promise a call and says someone will reply right here in the chat.
  4. The agent goes quiet in that chat. To bring it back: Dialogs → the customer's chat → Hand back to bot.

If the agent tells the customer it has passed them to your team but forgets the hidden handover tag, the request still goes out: Craft checks the reply text. The request then carries the customer's last message instead of a summary.

The same customer isn't handed over twice within half an hour, so your group gets one lead, not several.

If a customer was already handed over and writes again ("nobody got back to me", "waiting for a call"), the agent stays quiet and forwards the message to the same recipients as the lead. If someone on your team already wrote to the customer — from the Instagram app or from Dialogs — the agent sees it and doesn't create a new lead for that customer.

Strict handover#

The Strict handover switch is for teams that only want ready leads. The agent hands over a sale only when it's clear what the customer needs and the customer has left a phone, email or messenger themselves. An Instagram username doesn't count as a contact, though it's always in the request.

"How do I buy", "how much", "send the catalogue", "I want a consultation" without those details aren't handed over: the agent keeps consulting and asks for what's missing. Requests for a person and service problems are handed over as usual, but the request doesn't say "ready to buy" — it says "asks for a person" or "service problem".

After handover — only if the customer is waiting#

By default every customer message after a handover goes to the leads group. The After handover — only if the customer is waiting switch turns that off: the group gets one request, and later messages aren't forwarded — you see them in Dialogs and in the handover log.

One reminder still comes if all of these hold:

  • the customer says they're waiting or that nobody contacted them;
  • nobody on your team replied in DMs — from the Instagram app or from Dialogs;
  • one working hour has passed since the handover (Mon–Fri, 09:00–18:00 Moscow time). If the customer was promised contact later, the reminder won't come before that.

Craft can't see calls or chats in other messengers, and the reminder says so. One reminder per handover.

Connecting a leads group#

  1. Connect your Telegram bot under Accounts.
  2. Add the bot to your leads group and make it an admin.
  3. On the agent page, under the handoff switch, pick the bot, tap Refresh list and tick the group.
  4. Tap Send a test — a test message lands in the group, and each recipient shows whether it was delivered and, if not, why.
  5. Save the agent settings.

The Lead only — no service note and no Craft link checkbox removes the note about the paused agent and the "Open chat" button from the group message: only the customer, task, details, option, stage, contact and next step remain. The agent still pauses in the customer's chat as usual.

The Forward the customer's photos and videos after handoff checkbox is for when customers send photos of a site, a video of a fault or a snapshot of a document after the handoff. Those attachments go to the same group as a reply to the lead card: originals, with the customer's caption, an album as one message. No new lead is created, the agent stays silent in the customer's chat, and text messages are not forwarded by this checkbox. Works in Telegram (including personal-account chats via Telegram Business) and Instagram. A video over 20 MB won't be forwarded if leads are sent by a different bot than the one receiving the customer's messages — pick the same bot for leads.

Further down the same page, Recent handoffs shows who was handed over, when, whether it was delivered, and which recipients failed and why. You can open each summary there. Customer messages forwarded after a handoff are marked separately — "customer's message after handoff" — and don't count as leads; read receipts and reactions aren't forwarded.

⚠️ If no group is selected, the summary goes to your Craft bot DMs — but only if that bot is able to message you. Picking a group is more reliable.

💡 If you reply to a customer in DMs yourself, the agent stays quiet in that chat for the minutes set in "Pause after your reply". To keep the bot away from customers you're already handling, turn on My reply pauses the bot in Dialogs.

Different recipients for different requests#

By default every request goes to one place — the recipients you picked above. If sales should go to the sales group and breakdowns to an engineer personally, add a rule under "Recipients by request type":

  1. Click "+ Add rule" and pick a type: "Sale", "Asks for a person", "Breakdown" or "Custom type".
  2. Tick the group or people for this type. The bot is the same one picked above.
  3. Click "Send a test": next to each recipient you'll see whether the bot can write to them.
  4. Save the agent settings.

A request of that type goes only to those recipients, with no copy to the common list. A type without a rule goes to the common list, as before. The client's messages after the handover, their photos and videos and the "client is waiting" reminder go where the request itself went — they aren't duplicated to other departments.

A custom type is a name and one line "when it goes here", for example "Spare parts — the client asks about filters, cassettes, consumables". Up to 5 custom types. The agent picks a custom type only when the request clearly fits it, otherwise one of the three built-in ones.

The request type is shown in the request itself as a "Тип" (type) line and in "Recent handovers". If the agent picks the wrong type, refine the "when it goes here" line.

💡 Until you add rules, the agent works and hands over exactly as before: its instruction changes only once you add at least one rule with recipients.

Reply pace#

By default the agent replies right away. In the Reply pace block you can make it feel like a real manager:

  • Reply after, from and to (sec) — the agent waits a random pause in this range, e.g. 20–40 seconds. 0 means reply right away.
  • Mark as seen after (sec) — when the customer sees their message as read. 0 means don't mark it.
  • Show "typing…" before replying — Instagram's own indicator a few seconds before the reply.
  • "Typing…" by reply length — the agent writes the whole reply first, then marks the message as seen and shows typing for as long as a person would take to type that text: a short phrase about 5 seconds, a couple of sentences about 10, a long reply up to the upper limit (30 seconds by default). Set the limits with "Typing from" and "to". The "Reply after, from and to" delay isn't used in this mode. If the customer writes again, the reply is rewritten and typing is recalculated for the new text. Typing doesn't delay the handover to your team: it goes out as soon as the reply is written.

If the customer keeps typing while the agent waits, the pause starts over and they get one reply covering all their messages. If someone on your team replies, the chat is paused or handed over, the pending reply is cancelled.

Before sending, the agent checks the Instagram window: you can reply within 24 hours of the customer's last message. Pauses longer than 10 minutes aren't allowed.

Further down the page, Recent replies shows each chat's steps: incoming, seen, typing, scheduled and actual send, or cancellation with the reason.

The agent writes the reply a few seconds before marking the message as seen (if that's off, a few seconds before the reply is due), not the moment the message arrives. Customers often send one thought in two or three messages in a row — this way the agent waits for all of them and replies once. The handoff happens at the same moment: the summary goes to your group when the agent writes the reply, so no later than the "seen" pause.

💡 Credits are charged when the reply is written. If the customer writes again or the reply is cancelled (your team replied, the chat was paused, the window closed), credits for the unsent reply are returned and the agent writes a new one covering all messages.

If the person goes quiet#

To message someone an hour after the agent's reply and again closer to the next day, build a funnel that starts "After AI agent reply". It cancels itself if the person replies or you step in, and it doesn't write once Instagram has closed the conversation. See Follow up in Direct after the AI agent replies for the setup.

Good to know#

  • The agent can only reply within Instagram's messaging window: if someone wrote a long time ago, Instagram won't let a reply through.
  • The agent sends at most 3,000 replies a day per account — a safeguard against errors.
  • The agent works in Instagram, Telegram and WhatsApp. VK and MAX don't have it yet.
  • The agent doesn't reply to people tagged "спам" (spam): AI picks the auto-reply by meaning sets that tag when a comment is trolling, provocation or spam.
Didn't find an answer?Message us on Telegram or email support@craftopen.space — we'll reply and extend the article.
Message on Telegram