Skip to main content
This guide distills the most effective patterns we’ve seen from teams getting real results with Spark. Whether you’re just getting started or looking to level up, these tips will help.

​
Setting Up Your Agent

​
Give It a Real Identity

Your agent performs better when it has a clear identity, not just a name. During setup, be specific:
Name: Alex
Title: Sales Development Rep
Personality: Professional but friendly. Responds quickly and concisely. Always suggests a next step. Follows up persistently but never pushes too hard.
A well-defined personality leads to consistent communication style across emails, chat, and task handling.

​
Start with Knowledge, Not Prompts

Before asking your agent to do complex tasks, invest time in your knowledge files. An agent with strong knowledge files and simple prompts outperforms one with weak knowledge files and elaborate prompts every time. Priority order for new setups:
  1. Pricing guide (if applicable)
  2. Product/service overview
  3. Lead handling process
  4. FAQ document
  5. Email templates
See Writing Effective Knowledge Files for a deep dive.

​
Write Instructions Like a Playbook

Your agent’s instructions should read like a playbook — clear rules for common situations:

​
CRM Management

​
Keep Pipeline Stages Clean

Do

  • Use 5–8 meaningful stages
  • Every stage = something changed
  • Review pipeline weekly
  • Move stale contacts to Lost or Archive

Don't

  • Create 15+ granular stages
  • Leave contacts in the same stage for months
  • Use stages as tags (that’s what tags are for)
  • Skip stages — the data gets unreliable

​
Use Tags for Segmentation

Tags are lightweight labels. Use them for categories that don’t fit in your pipeline:
  • Source: Website, Referral, Trade Show, Cold Outreach
  • Industry: Healthcare, Technology, Finance, Retail
  • Interest: Product A, Product B, Custom Solution
  • Status: VIP, Do Not Contact, Past Customer

​
Keep Contacts Updated

Stale data is worse than no data — your agent makes decisions based on what’s in the CRM. Build habits:
  • Update contact notes after every interaction
  • Change pipeline stages promptly when something happens
  • Remove or archive dead leads quarterly
  • Use scheduled tasks to flag contacts that haven’t been touched in X days

​
Schedules That Work

​
The Essential Three

If you only set up three schedules, make it these:

​
Schedule Hygiene

  • Be specific about output. Always tell the schedule what to produce (post to chat, create a document, create tasks). If you don’t, the agent might do the work but you won’t see the results.
  • Include duplicate prevention. For schedules that create tasks or contacts, add “check if it already exists first” to avoid clutter.
  • Review run history. Check your schedule run history weekly to make sure things are working as expected.
  • Start conservative. Run schedules at low frequency first (daily, not hourly). Increase frequency once you’ve verified the output is useful.

​
Working with Your Agent

​
Teach as You Go

Every correction is a training opportunity:
You: “That email was too formal. We’re a casual brand — use first names, shorter sentences, and feel free to use exclamation marks.” Agent: “Got it — I’ll keep emails conversational and friendly going forward. I’ve noted this preference.”
Your agent logs these corrections and applies them in future interactions.

​
Use the Work Tab

When you need something more than a chat message — a report, a proposal, a detailed analysis — ask your agent to create a document:
“Create a quarterly business review document with pipeline analysis, win/loss data, and top accounts”
This goes to the Work tab where you can review, edit, and share it. Much better than scrolling through chat history to find that one time your agent gave you a breakdown.

​
Give Feedback Explicitly

Your agent won’t know it got something wrong unless you say so:
  • ✅ “That quote was wrong — we don’t charge shipping on orders over $500. Update your knowledge.”
  • ✅ “Great email draft, but remove the last paragraph — we never promise timelines.”
  • ❌ Silently fixing the output yourself (the agent learns nothing)

​
Integrations

​
Connect Early

Set up integrations before you start working with your agent intensively:
  1. Gmail — so your agent can send and read emails
  2. Google Calendar — so it can check availability and create events
  3. Webhooks — so leads flow in automatically
  4. Phone — if you want calling capability
An agent with integrations is dramatically more useful than one limited to chat.

​
Test Webhooks Manually

Before connecting your production forms, test your webhook with sample data:
  1. Set up the webhook URL in Spark
  2. Send a test payload using a tool like curl or Postman
  3. Verify your agent processes it correctly
  4. Then connect your real form
See Webhooks for details.

​
Team Usage

​
Define Clear Ownership

When you have team members, make sure it’s clear:
  • Who follows up with which leads (assign contacts)
  • Who reviews which pipeline stages
  • What your agent handles vs. what humans handle
  • When to escalate to a person vs. let the agent continue

​
Use Views for Different Roles

Create saved views tailored to each role:
  • Sales rep: “My Active Leads” — table filtered to their assigned contacts
  • Manager: “Pipeline Overview” — dashboard with team metrics
  • Everyone: “Overdue Tasks” — filtered task list

​
Common Pitfalls

Avoid these common mistakes that reduce your agent’s effectiveness:

​
The 30-Day Ramp

If you’re new to Spark, here’s a realistic timeline: By the end of month one, your agent should be handling lead processing, daily reports, and follow-up management with minimal intervention.