Native tools (II): update contact and tags
Teach your AI agent to write data into the contact profile, tag contacts and move lifecycle stages, all without human intervention.
Watch this step in the video · Contact, tags and CRM
Your AI agent doesn't just chat: it can write into your CRM while it talks to the customer. These two native tools keep your data clean and segmented without anyone typing it by hand.
What each tool does
- Update contact fields: saves what the customer mentions (name, email, city, company, job title, notes and your custom fields) into their profile. It only writes safe fields; it never touches system columns.
- Update tags: adds or removes tags on the contact. If a tag doesn't exist it's created on the fly, and adding it fires any workflows listening for that event.
Before you start
- Have your agent created under AI Agents (side menu).
- Define in the prompt which values to save and which tags to use, so the agent doesn't improvise.
Steps to enable them
- Open your agent from AI Agents (side menu).
- Go to the Custom actions tab.
- Under Native tools, turn on Update contact fields and/or Update tags depending on what that agent needs.
- For each tool, write the usage instructions: when to save a value and which tag to apply. For example: "If the customer gives their email, save it. If they show interest, add the hot-lead tag."
- Save your changes.
How to verify it works
- Open the agent's Sandbox tester.
- Run a chat where the customer shares their email and shows interest.
- Check the contact profile: the email should be there and the tag added.
If it doesn't work
- The value isn't saved: confirm the field is on the allowed list (names like email, city, company are; internal columns are not) and that your instructions ask the agent to save it.
- The tag isn't showing in reports: remember it's auto-created; make sure a typo didn't spawn a brand-new tag by mistake.
Tips
Pair Update tags with a workflow: adding the "customer" tag can automatically trigger a welcome message or a task for Sales.
Start with a few well-defined tags. An AI that tags with judgment is gold for segmenting your broadcasts.
Note: moving a contact between lifecycle stages is no longer an agent tool; that flow is handled from the CRM and its pipelines.
Related articles
Related articles
-
Create your first AI agent
Learn what an AI agent does in Omnifox, how to give it instructions, connect it to a channel and test it in the sandbox before it talks to real customers.
-
How to write good instructions for your AI agent
Learn how to write clear instructions so your AI agent replies with the right tone, limits and actions.
-
AI Agents complete guide
AI Agents in depth, in 65 chapters: creating, instructions, tools, knowledge, behavior, tester, inbox, workflows, analytics and usage, with every setting explained.
-
Connect your AI agent to WhatsApp, Instagram, Messenger and web chat
An agent with no channels serves nobody. Connect it to your WhatsApp, Instagram, Messenger or website chat from the Connections section, then switch it on so it starts replying.
-
Start here: AI Agents in 8 minutes
AI Agents essentials in a short video: creating an agent, its instructions, tools, knowledge, channels, the tester, hours and handing over to a person.