Table of Contents

Contact Subscribe Block: Manage Opt-ins and Audiences

Desirée M Updated by Desirée M

The Contact Subscribe block lets you create or update contacts directly in your bot and add contacts to one or more audiences. You can use it in WhatsApp bots for now.

Please note this block is only available if you have the New Contacts section in your account. If you don’t see it yet, no worries - it’s on its way! For the moment, please refer to this article on the legacy Opt-in block.

The new Contact Subscribe block enables you to:

  • Collect user consent (opt-in) for your channels.
  • Create or update contact information (name, email, phone).
  • Subscribe contacts to one or more audiences across your channels.

👉 You must use this block after asking users if they agree to receive messages from you, following Meta’s policies. If they say yes, connect the flow to Contact Subscribe. If they say no, skip the block and send a rejection message instead.

📌 What is the Opt-in process and why do I need it?

According to WhatsApp’s Business Messaging Policy (November 2024), you must get opt-in permission before contacting users. This consent can be general, as long as it follows local laws.

Opt-in is required for proactive messages (sent after 24 hours since the user’s last reply), which must use approved Message Templates. Reactive messages (within 24 hours of the user’s message) don’t require it.

📲 How does channel selection work?

Mandatory selection: You must select at least one channel for the contact.

Single channel auto-selection: If your brand has only one channel, it will be automatically selected.

If no channel is selected, the bot cannot be published.

📋 How are audiences handled?

You decide whether to add a contact to one or multiple audiences.

If a contact is already in an audience, they will not be duplicated.

🛤️ What do the green and red paths mean?

✅ Green path → The contact is saved successfully and added to the chosen audiences.

❌ Red path → The contact isn’t saved, usually because the phone number format is wrong or some required info is missing. If you want the chat to continue even if there is an error, make sure to connect that path.

📞 What phone number format is required?

The phone number must start with the country code, followed by the full number (no spaces or special characters).

Examples:

🇪🇸 Spain → 34600000000 (34 = country code, 600000000 = number)

🇬🇧 United Kingdom → 447000000000 (44 = country code, 7000000000 = number)

🇺🇸 United States → 12025550123 (1 = country code, 2025550123 = number)

If the phone number doesn’t follow this format, the bot will go through the red path.

🧩 How do I use this block?

To stay compliant with Meta’s policies, add an explicit opt-in question before the Contact Subscribe block.

  • If the user says Yes → connect the flow to the Contact Subscribe block, then send a thank-you message.
  • If the user says No → don’t connect them to the block, and send a polite rejection message instead.

Please make sure to connect the Any of the Above to a message redirecting the user to the question, in case they type anything else.

This approach keeps your flows compliant and creates a better user experience 👍

Was this article helpful?

Opt-in Check Block

New Contacts: Import, Segment, and Organize Easily

Contact