AI agents
An AI agent replies to customers for you. You describe its role in plain language, give it the facts it should know and the actions it may take, test it in a chat window, then connect it to WhatsApp or Instagram so shoppers get answers right away and are more likely to complete their order.
Les guides sont en anglais.
What an agent does
An agent is made of three parts, and you control each one:
The agent's role, personality and business context, written as instructions.
Text the agent should rely on when it answers: FAQs, policies, product details.
Actions the agent is allowed to take during a conversation, such as handing over to a person.
Building an agent does not make it talk to customers. It starts replying only after you publish it and assign it to a channel. See Connect the agent to a channel.
Before you start
- If you don't see AI Agent in the sidebar, it isn't enabled for your account yet. Ask your account manager or write to hello@contlo.com.
- To reply on WhatsApp, connect WhatsApp first. See WhatsApp setup.
- To reply on Instagram, connect your Instagram account from the App Market. See App Market.
- Collect the text your agent needs: shipping and return policies, opening hours, answers to common questions.
Create an agent
- Open AI Agent and click Create Agent. The agent editor opens full screen.
- Click the name at the top (or the pencil icon) and type a name. If you leave it unchanged, Contlo names the agent for you, for example Agent_001.
- In the middle panel, Define your agent., describe the agent's role, personality and business context.
- Optional: click Improve with AI to have Contlo rewrite your definition into a clearer set of instructions. Review the result and edit it as you like.
- In the left panel under Knowledge, click Add Knowledge, paste your text into Add Knowledge - Text Info and click Add.
- Under Tools, open Select tools and choose the actions the agent may take.
- In the right panel, Test your agent, type a question and check the reply. Adjust the definition or knowledge and test again.
- Click Save & Publish Agent. You return to the agent list and see Agent saved and published successfully!
Configuration options
Definition
Write to the agent as you would brief a new team member: who it speaks for, what it should help with, the tone to use and what it must never do. Improve with AI is available once the field has some text. While it runs you see Improving AI definition... and the field is locked.
Knowledge
Knowledge is plain text. Paste the content of your FAQs and policies rather than linking to them. After you add knowledge, use the edit icon to change it or the remove icon to clear it.
Tools
| Tool | Lets the agent |
|---|---|
| Order flow | Work with orders during the conversation. |
| Instagram direct message | Reply by Instagram direct message. |
| WhatsApp direct message | Reply by WhatsApp message. |
| Comment reply | Reply to comments on your Instagram posts. |
| Transfer to agent | Hand the conversation over to a person on your team. |
Test chat
Test your agent talks to the agent exactly as it is configured, without sending anything to customers. The first test message saves the agent as unpublished so it can answer. The test history is kept with the agent. Click Clear Chat to start a fresh test conversation.
Connect the agent to a channel
A published agent replies only where you assign it.
| Channel | Where to assign | What it handles |
|---|---|---|
| WhatsApp settings → AI Agent tab. Turn on AI agent responses and choose the agent under AI agent. | All incoming customer messages on WhatsApp. | |
| Instagram direct messages | Instagram settings → DM & Mentions tab. Under Direct Message (DM), choose the agent. | All incoming direct messages. |
| Instagram posts | Instagram settings → Posts tab. Open a post's menu and assign an agent, or select several posts and assign in bulk. | Comments on those posts. Under Reply as choose a direct message or a comment, or tick Let AI Agent decide to reply as direct message or a comment. |
In each picker, a green dot marks agents that are published and a red dot marks agents that are paused or not published.
Turn an agent on or off
On the AI Agents list, open the three-dot menu on an agent's row. The menu shows the action that fits the agent's current state.
| Action | When you see it | Result |
|---|---|---|
| Launch Agent | The agent has never been published. | Publishes it. Status becomes Active. |
| Pause Agent | The agent is Active. | Stops it. Status becomes Inactive. |
| Resume Agent | The agent is paused. | Publishes it again. |
| Edit Agent | Always. | Opens the editor. Click Update & Publish Agent to save and publish your changes. |
| Delete Agent | Always. | Removes the agent after you confirm. This cannot be undone. |
To stop AI replies on one channel only, leave the agent published and switch it off in that channel's settings, for example turn off AI agent responses in WhatsApp settings.
Read the agent list
| Column | What it shows |
|---|---|
| Agent | The agent's name. Click the row to open the editor. |
| Status | Active for published agents, Inactive for paused and unpublished ones. |
| Last published at | The date of the latest published update, or Not Published. |
| Last published by | The team member who last published it. |
| Updated at | When the agent was last changed. |
- Tabs: All, Active (agents that have been published, including paused ones) and Inactive (agents never published).
- Search agents filters by name.
- The date filter limits the list to Last 3 Months, Last 6 Months, Last Year or a Custom Range.
Review what the agent did
Agent conversations appear in Conversations with the rest of your customer chats, so you can read every reply the agent sent. See Conversations inbox.
- A conversation the agent is handling shows Assigned to AI agent in its profile panel.
- While it is assigned to the agent, your team cannot type in it. You see Cannot send message when conversation is assigned to AI agent.
- To take over an Instagram conversation, choose Unassign from AI agent in the assignment menu. To hand one back, choose Assign to AI agent.
Troubleshooting
| Message | What to do |
|---|---|
| Failed to save and publish agent. Please try again. | Click the publish button again. If it keeps failing, click Exit to keep your work and write to hello@contlo.com. |
| Failed to improve AI definition | Make sure the definition has some text, then try again. |
| Failed to send message to agent or Sorry, I encountered an error. Please try again. | The test chat could not reach the agent. Send the message again. |
| Failed to launch agent, Failed to pause agent or Failed to resume agent | Refresh the list and repeat the action. |
| Failed to load agent data | Go back to the list and open the agent again. |
| The agent is published but customers get no replies | Check that it is assigned in the channel's settings and shows a green dot there. |
Guides associés
- Conversations inboxReply to WhatsApp, Instagram, SMS and live chat messages in one inbox: filter, assign, tag, resolve, and share orders or carts with customers.
- Connect WhatsAppConnect your WhatsApp Business account to Contlo, check your number and quality rating, and learn what each WhatsApp settings tab does.
- App MarketBrowse, install, set up and uninstall apps in Contlo: channels, analytics, ad audiences and the third-party tools your store already uses.
- Helpdesk settingsSet up your support inbox: away message, notification sounds, custom statuses, auto-assignment, quick replies, keyword actions and tags.
- Brand AITell Contlo about your brand's goals, voice, look and customers so AI-generated emails, copy and images sound and look like you.