Log inStart Free Trial
Meta Tech Provider

WhatsApp keyword auto-reply: contains, starts with or exact match

A WhatsApp keyword auto-reply sends a set answer when a customer's message contains a word you choose, such as price, menu or address. With automations on a number connected to Meta's Cloud API, one rule can list several keywords, any one is enough, capital letters do not matter, and the word can sit anywhere, open the message, or be the whole message.

easyCoexistence runs keyword replies on the WhatsApp Business number you keep in the app, through Meta's Cloud API: up to 30 keywords per automation, three match modes, and an answer in fixed text, an approved template, your own AI or your own system.

30 keywords

Most an easyCoexistence keyword automation holds, each up to 100 characters; any one matching starts it.

3 match modes

Contains, Starts with and Is exactly: anywhere in the message, at the start, or the whole message.

1st in line

Keyword automations answer before First message, After hours and catch-all automations, and only one automation runs per incoming message.

[voice message]

A voice note reaching a keyword rule with no OpenAI or OpenRouter key saved. With one, "[voice message] <words>" arrives and Contains can match.

How does a keyword auto-reply decide to answer?

It compares the customer's message with your keywords, after trimming the spaces around both and ignoring capital letters, and runs if any one of them matches. Under Has keyword, type each word or phrase and press Enter, or paste several separated by commas, up to 30, each up to 100 characters. Everything else is compared as typed, accents and punctuation included. Then choose Where the word has to be:

Contains: Anywhere in the messageprice matches "What is the price?" and also "prices"
Starts with: At the startprice matches "price please" but not "the price?"
Is exactly: The whole messagemenu matches "Menu" or " menu ", but not "menu?" or "menu please"

Which match mode should you pick?

Match the mode to how customers write. Contains, the default, suits distinctive words that can appear anywhere in a sentence, such as price, menu, address or PIX. Starts with suits commands typed at the beginning, such as track 1042 or order 15. Is exactly suits one-word replies, such as yes, menu or 1, where the whole message is the keyword. When unsure, keep two- and three-letter words out of Contains, then read the Runs tab for a week: runs that should not have started show which keyword to tighten.

What keyword replies does a small business need?

Six cover most questions a shop, restaurant or clinic gets on WhatsApp. Each is its own automation with Has keyword and a Reply with text step, set to Contains; the texts are ready to copy, with your details in brackets:

  • Price (price, prices, how much): "Here is our price list: [link]. Tell me what you need, {{first_name}}, and I'll check it for you."
  • Menu (menu, cardápio, cardapio): "Today's menu: [link]. We deliver from [11 a.m.] to [10 p.m.]."
  • Hours (hours, open, opening): "We're open Monday to Friday, [9 a.m.] to [6 p.m.], and Saturday, [9 a.m.] to [1 p.m.]."
  • Address (address, location, where are you): "We're at [street and number]. Map: [link]."
  • Payment (pix, payment, pay): "You can pay by PIX to the key [key]. Send the receipt here and we'll confirm."
  • Order tracking (track, tracking, order status): "Track your order here: [link]." Or use Call my webhook, so your system answers with the real status.

What happens when several automations match?

Only one automation answers a message. When several match, keyword automations go first, then First message, then After hours, then the catch-all that answers any message; within the same kind, the oldest automation wins. So a keyword rule takes the message ahead of your AI assistant or your welcome message. And when two keyword rules share a word, or one message holds keywords from two rules, such as "price of the menu?", only the older rule replies. So keep each keyword in one rule only, and remember that the rule created first wins a tie.

How do you test a keyword reply?

In two places, before any customer sees it. The Test it box under the keywords checks the match exactly as the live automation does: type a message as a customer would, and it shows Runs: it matches "price" or Does not run: no keyword matches. Try it, opened with the Test button, runs the saved steps on a sample message so you can read the exact reply, without sending anything to anyone; it runs the steps whether or not the sample holds a keyword. From ChatGPT or Claude, test_automation does the same through the connector.

Can your AI set up keyword replies for you?

Yes. With the easyCoexistence connector added to ChatGPT or Claude, give the words and the reply. The AI calls list_numbers, then create_automation with match keyword, your keywords and keyword_mode contains, starts_with or exact, then test_automation. Ask for the variants in the same request: it can add plurals, spellings without accents and the same words in your customers' other languages to the list.

The request, and the create_automation call it becomes
You: On my WhatsApp number, when a message mentions price or prices,
     reply with our price list, bloomcafe.example/prices, and greet them by name.
     Add the Portuguese words too.

→ list_numbers
→ create_automation {
    "connection_id": "…from list_numbers…",
    "name": "Price list",
    "trigger": {
      "type": "message_received",
      "match": "keyword",
      "keywords": ["price", "prices", "how much", "preço", "preco", "quanto custa"],
      "keyword_mode": "contains"
    },
    "steps": [{
      "type": "reply_text",
      "text": "Hi {{first_name}}! Here is our price list: bloomcafe.example/prices"
    }]
  }
→ test_automation { "automation_id": "…", "text": "How much is a birthday cake?" }

How to set it up

  1. Start from Keyword replyIn the Automations tab, click New automation, then Use this on Keyword reply. Has keyword is selected, set to Anywhere in the message.
  2. Add the keywordsType a word or phrase and press Enter, or paste several separated by commas; up to 30.
  3. Choose where the word has to bePick Anywhere in the message, At the start or The whole message.
  4. Write the replySelect the Reply with text step and write the answer; {{first_name}} and {{message}} are filled in for you.
  5. Check it, then turn it onType samples in the Test it box, run Try it from Test with the automation switched Off and saved, then switch it On and click Save.

Common mistakes

  • Short words in Contains mode. "hi" also matches "this" and "shipping", and the Portuguese "oi" matches "noite" and "depois"; use Is exactly for greetings, or longer phrases.
  • Forgetting accents and spelling variants. Matching ignores capital letters but not accents, so "preco" does not match "preço"; add both, plus the misspellings customers really type.
  • Typing several keywords on one line with spaces, such as price menu hours. Only Enter, a comma or a new line separates keywords, so that becomes one phrase that has to appear whole, and it rarely does.
  • Testing from a phone whose chat you answered from the app in the last 4 hours. The run is skipped as "You answered this chat from your phone recently"; use another phone, or Try it.
Doing this with EasyCoexistence

Set them up by asking ChatGPT or Claude through the connector, or in the editor. US$ 9 down to US$ 0.75 per number per month, falling as you add numbers, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Can a keyword reply answer a button tap?

Yes. When a customer taps a quick reply button on a template, or picks an option from a list, its text arrives as the message, so a keyword rule set to Is exactly with that text answers the tap.

Does a keyword in a photo caption count?

With Contains, yes. A photo arrives as [image] followed by its caption, and a video as [video], so Contains finds the word in the caption. Starts with does not, because the text begins with the bracket.

Can one automation give different answers to different keywords?

Yes. A Split into paths step (condition) checks the message for each keyword and sends each path its own Reply with text, so one automation can answer different words differently, and an Ask a question step with buttons makes a menu in one automation. For open questions, use an Agent answers step, or a Reply with AI step with your prices, hours and address in its Instructions.

Is there a limit on keyword automations?

There is no set limit on how many automations a number has, no run cap and no extra charge for them; each one holds up to 30 keywords. Only AI replies are capped, at 10 per chat per hour by default.

Keep reading

Ready to get started?

Set up WhatsApp Coexistence in minutes, not months. The app keeps working on the phone.

Start Free Trial

Verified on