Components

Every component: what it is for, when to use it, how to connect it and the tools it gives an AI agent.

Connecting: circle ● to circle ● is the flow; diamond ◆ to diamond ◆ joins a step to an AI agent as a tool. A joined step has no flow lines. In tools mode a component has one filter (a catalogue category, an FAQ or media tag, a DataMold form, a calendar), and its tool names end with that filter — list_faqs_returns — so the same component can be joined to one agent twice with different filters.

Messages & content

Send DM

A direct message, with up to three link buttons.

  • Workflow mode: write the message (use {variables}). Use it to deliver a link, confirm an order, say thanks.
  • Tools mode: the agent's voice. Its replies go out through it, and it can read the conversation. Tools: send_message (an extra message right now), read_messages (the latest messages of this chat, theirs and yours). A new AI agent comes with one joined.

Ask in DM

A DM that waits for the answer.

  • Workflow mode: up to three buttons, each with its own line, plus "typed something else". A typed answer is matched to the buttons (typos and synonyms count).
  • Tools mode: ask_question: the agent asks its own question with up to five quick-reply buttons and waits; their answer is the agent's next message.

Public reply

A reply under the comment that started the run (skipped on a DM run: there is no comment).

  • Workflow mode: the reply text.
  • Tools mode: reply_to_comment: the agent writes one public reply.

Media

Photos, videos and audio from Content → Media.

  • Workflow mode: tick the files to send (up to 10), with an optional message before them.
  • Tools mode, filter tag: list_media (names, what each file is, tags), send_media. Give files a good description: the agent chooses by it.

Catalogue

What you sell, from Content → Catalogue: items, prices, plans, options and policies.

  • Workflow mode: sends items as product cards (photo, name, price, View button): every category, or the ones you tick.
  • Tools mode, filter category: catalog_search (list), catalog_item (get one item's details), business_policy, send_cards, send_photos. The agent quotes only what is in your catalogue and never makes up a price.

FAQ

Your questions and answers, from Content → FAQ.

  • Workflow mode: the AI finds the FAQ entry that answers their message, sends the answer (or only keeps it in {faq.answer}), and leaves by found or not found.
  • Tools mode, filter tag: list_faqs (the questions), get_faqs (their answers).

AI

AI agent

An AI that chats in DMs with your instructions until one of its actions fits. Each action is its own line out; end is taken when the turn limit is reached or the AI fails.

  • Instructions: who it is, what it sells, how it talks. Start from a template, then fill in the [brackets].
  • Actions: what an answer cannot settle: TALK_TO_HUMAN, BUY, BOOK… Each has a description of when to take it.
  • Chat in DMs on: it answers every DM and waits for the next. Off: one answer for the next steps, in {reply}.
  • Tools: everything joined to its ◆. Add a tool in its settings adds and joins one in one go. Without a joined Send DM, nothing it writes reaches the customer.

Basic

Start

Where every run begins. Attached to a post it runs on each comment; as the account's DM workflow it runs on each new DM. One per workflow.

Keyword check

Up to five keywords, each with its own line, plus "no match". Capitals, stretched letters, typos and Hinglish count; see How keywords match.

Follows you?

Yes / no on whether they follow you. If Instagram cannot confirm it, the no line is taken.

Condition

Two actions under What it does:

  • If / else: tests on your variables ({city} is equal to Pune, {qty} is greater than 2, contains, starts with, is empty…) joined with and / or, read left to right. Leaves by true or false.
  • Match a value: one line per value of a variable (capitals and spaces ignored), plus no match.

Variables

Three actions under What it does:

  • Set a variable: keep a value for later steps. {qty} * 450 is worked out; each {reference} must be a number, so a customer's "2+2" is never calculated.
  • Rectify a variable with AI: list the values a variable may end up as, with when each is the one ("Bengaluru": BLR, Bangalore…). The AI writes the matching value back into the same variable; when nothing fits it keeps the old value or becomes empty. {rectify.ok} says which.
  • Extract variables with AI: the AI reads the conversation and fills one variable per item you describe (an order number, a size, a city).

Stop

Ends the workflow.

Integrations

Connect the app first in Settings → Integrations; its component then appears in the palette.

HTTP API

A request to your own system (an order lookup, a CRM, a sheet). The answer lands in {response} and in the variables you map with a dot path (body.status). Leaves by success or failed. Only https:// and only public addresses.

  • Tools mode: one tool, named and described by you ("check_order — looks up an order by its number"). Write {ai.order_number} in the URL, headers or body wherever the AI should fill a value in, and describe each one.

DataMold

Rows in a DataMold form.

  • Workflow mode: Create a row from {variables}, Get rows (words, or field = value), or Update a row. Leaves by done / failed (found / none for Get).
  • Tools mode, filter form: list_rows, get_row, create_row, update_row. The agent can read every row of the form, so never join a form that holds other customers' details.

CalendarBook

Bookings in CalendarBook. The customer is the person in this Instagram chat.

  • Workflow mode: Book a time, Get free times, Find their bookings, Cancel their booking.
  • Tools mode, filter calendar: list_calendars, get_slots, create_booking, list_bookings, update_booking (reschedule, cancel or confirm). The agent only ever sees and changes the bookings of the person it is talking to.

HelloCall

An AI phone call from HelloCall. Instagram does not share phone numbers, so ask for one first.

  • Workflow mode: pick a HelloCall workflow, the line to call from, and the number ({phone}).
  • Tools mode: make_call, at most once per message.

Gmail and Email

An e-mail from your Gmail, or through your own mail server or e-mail service.

  • Workflow mode: To, subject and message with {variables}.
  • Tools mode: send_gmail / send_email to the address set on the step (your own): the agent writes the subject and text, but can never mail an address a customer names.

Notify on WhatsApp

A WhatsApp message to your own team, at the numbers in Settings → Organization.

  • Tools mode: notify_team: the agent alerts your team itself (a new order, a request for a person).

Something unclear or out of date? Tell us and we will fix the page.