Docs
Get started

Dynamic message variations with Spintax

Spintax lets you write one message and have Wazzap rewrite it on the fly, so every recipient gets a slightly different version. It's the cleanest way to stay under WhatsApp's spam radar when you send at scale.

Overview

When you blast the exact same text to thousands of numbers, WhatsApp's anti-spam learns the pattern fast and starts throttling, hiding, or banning your number. Spintax breaks the pattern. Instead of always sending "Hi, how are you?", each contact receives a different variant: "Hey, what's up?", "Hi, hope you're well", "Good morning, all good?". Same intent, different fingerprint on every send.

Wazzap supports two flavors of Spintax: global (declare once, reuse anywhere) and per-message (declared and used inside a single message).

Global Spintax

Global Spintax is declared once in your Wazzap settings, under the Spintax tab. After that, you can reference the variable in any message without redeclaring it. Perfect for greetings, sign-offs, and recurring filler text.

  1. Open your Wazzap dashboard and go to Settings, Spintax.
  2. Define up to 6 global variables: ${SPINTAX_1}, ${SPINTAX_2}, … ${SPINTAX_6}.
  3. For each variable, add the text options separated by /.
  4. Save. The variable is now available in every message you send.

Example. If ${SPINTAX_1} is defined as How can I help you? / What's up? / All good?, each recipient receives one of the three options at random when the variable appears in a message.

${SPINTAX_1} I'm reaching out from the agency. Got 2 min?

Per-message Spintax

When you only need variation in one specific message, declare the Spintax inside the message itself. This declaration isn't saved anywhere, so you'll need to repeat it in any other message where you want the same variable.

You can declare as many variables as you need in a single message: A, B, C… up to Z.

Correct syntax:

!/SPINTAX_A/option 1/option 2/option 3/SPINTAX_A/!

Full example:

!/SPINTAX_A/Hello/Hi/Good day/SPINTAX_A/! !/SPINTAX_B/I hope this message finds you well/I am glad to connect with you/SPINTAX_B/!

${SPINTAX_A} team, ${SPINTAX_B}. I'm Miguel from Wazzap.

Why use Spintax

  • Each message looks slightly different to every recipient and to Meta's spam detection layer.
  • Lowers the chance your number gets flagged or restricted during large sends.
  • Makes outbound feel more natural at scale, especially in cold and bulk campaigns where uniformity is the giveaway.
  • Pairs well with smart intervals and warmed numbers for a complete anti-ban setup.

Notes to remember

  • Global Spintax: declared once in Wazzap settings, reusable across every message you send.
  • Per-message Spintax: declared and used inside the same message. Must be redeclared in any new message that needs it.
  • Both flavors can coexist in the same message. Use globals for static building blocks and inline declarations for one-off variations.
!

As with every Wazzap command, Spintax must be sent from the Conversations tab of your CRM (for example HighLevel via the native integration), not directly from the WhatsApp app on your phone.

Troubleshooting

The ! character collides with the syntax

Per-message Spintax uses !/ ... /! as its delimiters. If you place an exclamation mark at the very start or very end of one of your options, it collides with those delimiters and the message fails to send.

Example that fails:

!/SPINTAX_A/I have something special for you!/Been thinking about you 💭/SPINTAX_A/!

Fix: don't place ! at the start or end of any option. If you need the character, keep it in the middle of the phrase.

Fixed example:

!/SPINTAX_A/I have something special for you/Been thinking about you 💭/SPINTAX_A/!

Follow this rule and Spintax phrases parse cleanly, with messages going out error-free.

Variable not replaced and shows literal ${SPINTAX_1}

Two usual causes. First, the global variable isn't defined yet for that sub-account, head to Settings, Spintax and confirm the slot has options. Second, the variable was sent from the phone directly instead of from your CRM's Conversations tab, the WhatsApp app doesn't process Spintax, only Wazzap does.

Spintax pairs naturally with the GPTalk Pro Assistant. Use globals in your AI greetings so the bot opens with one of several handcrafted tones instead of the same line every time.

Was this page helpful?