# Keywords & Triggers

A "trigger" is simply the event that makes your agent start replying — it can be a word someone sends you in a DM, a comment they leave on your post, a reply to your story, or a click from one of your ads. You set the rules once by asking Claude, and your agent handles it from there.

---

### Give away a freebie when someone DMs a word

**What you get:** Your agent automatically sends a specific resource (link, PDF, video, etc.) to anyone who DMs you that exact word, then starts a conversation.

**When to use it:** Perfect for "DM me GUIDE to get my free guide" calls-to-action in your content. The word acts as the unlock code.

**Just say:**
> When someone DMs the word GUIDE, have the agent send them my free PDF at [your free PDF link] and start a conversation.

**What happens:** Claude sets up the keyword so that the moment someone sends that word, your agent replies with the resource and opens the conversation. Claude will confirm the setup with you before activating it on your live agent.

**Tips:**
- Keep the keyword short and memorable (one word, all caps tends to stand out in your posts).
- You can have multiple keywords, each delivering a different freebie.
- Matching is forgiving — someone typing "guíde" or "Gide" will still trigger it.

---

### Auto-DM people who comment a word on my post

**What you get:** Your agent slides into the DMs of anyone who comments a specific word on one of your posts, automatically.

**When to use it:** Ideal for "comment WORKSHOP below and I'll send you the link" posts. Great for launches, lead magnets, or giveaways.

**Just say:**
> Set up the agent so that anyone who comments WORKSHOP on my posts gets a DM with [your workshop link].

**What happens:** Claude configures a comment trigger tied to that keyword. When a follower drops that word in your comments, your agent sends them a DM with the message and link you specified. Claude confirms before making the change live.

**Tips:**
- You can pair this with a public reply to the comment (e.g. "Sent! Check your DMs") for even better engagement.
- Works with accents and minor typos, so commenters in different languages won't miss out.

---

### Reply to every comment on a post

**What you get:** Your agent DMs every single person who comments on a specific post — no keyword required.

**When to use it:** Best for high-engagement posts where you want to follow up with everyone, not just those who know the magic word. Think giveaways, polls, or pinned announcements.

**Just say:**
> Make the agent DM everyone who comments on my latest post with: "Thanks for engaging! Here's a little something for you: [link]."

**What happens:** Claude sets up an all-comments trigger on that post. Every new comment, regardless of what it says, kicks off a DM from your agent. Claude will confirm before going live.

---

### Reply to everyone who DMs me

**What you get:** A catch-all so your agent greets every new DM, even when no keyword is involved.

**When to use it:** Use this as your safety net — for people who just say "hey" or ask a question without using any specific word. Ensures nobody is left on read.

**Just say:**
> Set the agent to reply to any new DM, even if they don't use a specific word. Start with a warm greeting and ask how I can help.

**What happens:** Claude activates a catch-all rule. Any new conversation that lands in your inbox gets an automatic first reply from your agent. Existing keyword rules still work — this just covers everyone else. Claude confirms before activating.

**Tips:**
- Keep the catch-all message open-ended so the agent can naturally guide the conversation.
- You can always pause this during busy periods without deleting it.

---

### Respond when someone replies to my story

**What you get:** Your agent automatically replies to anyone who reacts or responds to one of your Instagram stories.

**When to use it:** Stories drive a lot of informal replies ("love this!" or a quick question). Instead of letting those go unanswered, your agent picks them up and starts a real conversation.

**Just say:**
> When someone replies to any of my stories, have the agent respond warmly and ask what caught their attention.

**What happens:** Claude sets up a story-reply trigger. The next time a follower taps "reply" on your story, your agent sends them a message and begins the conversation. Claude confirms before activating.

**Tips:**
- Pair with story CTAs like "Reply with YES if you want the details" to create a soft keyword flow.

---

### Greet leads who come from my ads

**What you get:** Your agent knows when a new DM comes from one of your Meta/Instagram ads and greets that person with a message tailored to that specific ad.

**When to use it:** When you're running Click-to-DM ads and want the first message to match what the person saw — not a generic hello. Higher relevance, better conversions.

**Just say:**
> I'm running an ad for my [coaching program]. When someone DMs from that ad, have the agent greet them mentioning the program and ask what they're looking to achieve.

**What happens:** Claude sets up the ad trigger tied to your campaign. When someone clicks "Send message" in your ad and lands in your DMs, your agent sends a personalized opener that references the ad context. Claude confirms before activating.

**Tips:**
- If you have multiple ads, you can have a different opener for each one — just describe them one at a time.

---

### Update my whole keyword list at once

**What you get:** A clean, fully reconciled keyword setup in one shot — new words added, changed ones updated, removed ones deleted.

**When to use it:** After a launch, seasonal refresh, or when your offer lineup changes and several keywords need to be added, retired, or tweaked all at once.

**Just say:**
> Here's my full updated keyword list for the agent. Please replace whatever's there with this: GUIDE → [PDF link], WORKSHOP → [workshop link], MASTERCLASS → [replay link].

**What happens:** Claude compares your new list against what's currently active, adds anything new, updates anything that changed, and removes anything you dropped. You get a summary of exactly what changed before anything goes live.

**Tips:**
- Always provide the full list, not just the changes — that way nothing gets left behind accidentally.
- Claude will show you a diff (what's being added, changed, removed) before confirming.

---

### Pause a keyword during a launch (and bring it back automatically)

**What you get:** A keyword goes temporarily silent for a set period, then reactivates on its own — no manual follow-up needed.

**When to use it:** When you're in a live launch and one keyword is pointing to an offer that's sold out or not relevant right now. Or over a holiday when you don't want unexpected conversations starting.

**Just say:**
> Pause the GUIDE keyword for the next two weeks and bring it back automatically on June 23rd.

**What happens:** Claude deactivates that keyword immediately and schedules it to reactivate on the date you set. Anyone who DMs that word during the pause won't trigger the agent (or they'll hit your catch-all if you have one). Claude confirms the pause and the return date before applying.

**Tips:**
- You can pause and resume as many keywords as you like independently.
- The keyword itself is never deleted — all its settings are preserved.

---

### Reply with a voice note to a keyword

**What you get:** When someone sends a specific keyword, your agent responds with an audio message instead of text.

**When to use it:** Great for a more personal feel — sending a voice welcome, a quick coaching snippet, or a warm intro to a paid resource. Stands out in a crowded DM inbox.

**Just say:**
> When someone DMs the word AUDIO, have the agent reply with this voice note: [attach or link your audio file].

**What happens:** Claude attaches the audio file to that keyword so the agent sends it as a voice reply. Claude will confirm the setup and let you know the audio is ready before activating.

**Tips:**
- Keep the audio under 60 seconds for best engagement.
- You can combine a voice note with a follow-up text message in the same flow.

---

### Send specific people straight to an agent

**What you get:** Certain contacts — by Instagram handle, WhatsApp number, or email — are pre-routed to your agent the moment they reach out, skipping any keyword requirement.

**When to use it:** For VIP clients, beta testers, or a specific list of leads you've collected who should go straight into a conversation without needing to type a keyword.

**Just say:**
> Route these contacts directly to the agent: @johndoe on Instagram, +1 555 000 1234 on WhatsApp, and jane@example.com.

**What happens:** Claude registers those contacts so that any time one of them starts a conversation, your agent takes over immediately. Claude confirms the list before saving.

**Tips:**
- You can add or remove contacts from this list at any time just by asking.
- This works independently of keywords — these contacts don't need to type anything special.

---

### Route a whole list of contacts at once

**What you get:** you upload a list (a CSV) of contacts — Instagram handles, WhatsApp numbers, emails — and every one of them is pre-routed to your agent in a single step, no keyword needed.

**When to use it:** you've collected a batch of leads — an event list, a webinar sign-up sheet, an exported audience — and want the agent to take them all on at once, instead of adding them one at a time.

**Just say:**
> "I have a CSV of about 300 contacts I want routed straight to my agent. How do I upload it?"

**What happens:** Claude tells you which columns to include and where to drop the file, then bulk-routes everyone on the list to your agent. When any of them starts a conversation, the agent picks it up immediately — no magic word required.

**Tips:**
- This is the bulk version of "send specific people straight to an agent" above — same result, one file instead of one-by-one.
- Include whatever identifiers you have (handle, phone, email); more columns means more of the list matches.

---

### Temporarily block a contact or keyword

**What you get:** a specific person or a specific keyword stops triggering your agent — either for a set time that lifts itself, or indefinitely until you turn it back on.

**When to use it:** a troll or a competitor you don't want the agent engaging, a contact you'd rather handle personally, or a keyword you need to silence right now without dismantling its whole setup.

**Just say:**
> "Stop the agent from replying to @somehandle for the next 7 days."

Or:

> "Block the keyword PRICE from triggering until I turn it back on."

**What happens:** Claude adds the block — temporary with an automatic expiry date, or permanent — and confirms before applying it. While the block is on, the agent simply doesn't activate for that contact or keyword.

**Tips:**
- This is different from pausing a keyword for everyone: here you can block just one person while the keyword keeps working for the rest.
- Temporary blocks lift themselves on the date you set — no need to remember to undo them.
- You can also block by a property instead of a name — e.g. "don't let the agent trigger for contacts marked as existing customers" or "skip contacts in Argentina."

---

### Screen out junk DMs before the agent replies

**What you get:** a smart filter in front of your catch-all so the agent only engages real prospects — spam, bots, one-word reactions, and off-topic messages don't get a full reply.

**When to use it:** you turned on "reply to everyone who DMs me" and now the agent is spending replies on "🔥" reactions, giveaway bots, or messages that have nothing to do with your offer.

**Just say:**
> "On my catch-all, only have the agent reply to people who actually ask about coaching or pricing — skip spam and random reactions."

**What happens:** Claude adds a relevance check ahead of the catch-all and confirms the rule with you. Messages that don't pass are left alone; the ones that look like real interest get the agent's full attention.

**Tips:**
- This only applies to the reply-to-everyone catch-all — your specific keyword triggers always fire as set.
- You describe what counts as relevant, in your own words; Claude turns it into the filter.

---

### Control how a keyword matches

**What you get:** you decide whether a keyword fires only when it's the *whole* message ("exact") or any time it appears *inside* a longer message ("anywhere") — and whether near-misses and typos still count.

**When to use it:** exact match is for promo codes or command words, so `SAVE10` doesn't fire on "I want to save money." Anywhere + typo-tolerance is for natural calls-to-action like "send me the GUIDE please."

**Just say:**
> "Make the keyword SAVE10 match only when it's the exact message, and turn off typo tolerance."

**What happens:** Claude sets the match mode and the typo setting for that one keyword and confirms before saving. Everything else about it stays the same.

**Tips:**
- The default is forgiving — matches anywhere, tolerates typos. Only tighten it when false matches are a real problem.
- You can set this differently for each keyword.

---

### Trigger when an outgoing message goes out (ManyChat, or when you reply)

**What you get:** the agent can activate off an *outbound* message — one you send, or one another tool like ManyChat sends — instead of waiting for the lead to message first.

**When to use it:** you run part of your flow in ManyChat (or message leads by hand) and want your Ninjo agent to pick up from there, or to react when a specific word shows up in an outgoing message.

**Just say:**
> "When ManyChat sends a message containing the word HANDOFF, have my agent take over the conversation."

**What happens:** Claude sets up an outgoing-message trigger — optionally tied to a keyword in that outbound message — and confirms before activating it.

**Tips:**
- Handy as the handoff point between an external tool and your Ninjo agent.
- Pair it with auto-pause (on the [Live conversations](conversations.md) page) if you don't want both replying at once.

---

← Back to the [wiki home](index.md)
