Skip to main content

Updating CRM Records and Fields

Let Support Assistant create a lead while it talks to a caller.

How an Agent Changes CRM Data​

Agents change CRM data through the same Role permissions as any other tool. If the Role can create or update a module, the matching tool appears in the @ list. Mention it in the Prompt, say when to use it, and name the fields the agent should collect and pass.

  1. Give the Role the permission. On the agent's Role, allow Create or Update on the module, for example Leads.
  2. Type @ in the Prompt and choose the tool. The create lead tool appears in the list once the Role allows it.
  3. Say when the tool is used and which fields to pass.
info

If the tool is missing from the @ list, the Role does not allow that action on the module. The Knowledge Base does not control it, because the Knowledge Base only lets the agent read.

Example Prompt Section​

This example creates a lead once the key details are collected.

Once the key fields are gathered (Name, Email, Company), use the create lead tool immediately:
- `lead_name`: [Caller Name]
- `email`: [Caller Email]
- `company`: [Company Name]
- `team_size`: [Team Size or "Not specified"]
- `notes`: [Brief summary of the caller's interest]

Your tool and field names come from your own Role and CRM modules. Use the names that appear in the @ list.

Writing the Instruction Well​

  • Name the trigger. Say exactly when the tool should run, for example once name, email and company are gathered.
  • List every field. The agent passes only the fields you name, so list each one the tool needs.
  • Give a fallback value. For optional fields, tell the agent what to pass when the caller does not say, such as Not specified.
warning

Required fields on the module still apply. If the agent does not pass a value for a required field, the record cannot be created, so make sure the Prompt collects every required field first.