Manually Blocking an Unwanted Contact

RapidPro.app lets you block contacts who abuse your service so they can no longer receive outbound messages and their inbound messages are automatically archived, and you can do this either manually from the Contacts list (and later unblock from the Blocked view) or automatically in a flow by setting Update Contact → Status to Blocked when you detect spam or offensive content.

Block (and unblock) contacts safely in a few steps

If you just need the essentials, follow this:

  1. Understand what Blocked means vs Stopped
  2. Block a contact from Contacts using the Block icon
  3. Unblock a contact from Contacts → Blocked
  4. Optionally block automatically in a flow with Update Contact → Status = Blocked
  5. Troubleshoot: why messages won’t send or why blocked contacts still “message” you

You’re done. Blocked contacts are suppressed from outbound messaging and their inbound messages are archived automatically.

Step-by-Step Process

1
Understand what happens when a contact is blocked

Blocking is useful for handling spam, abuse, or persistent unwanted behavior.

When a contact is Blocked:

  • they are removed from all groups
  • they cannot receive outgoing messages
  • all incoming messages are automatically archived
  • flows will not send messages to them

Blocked contacts remain in your workspace but are effectively ignored.

⚙️
Note — Blocked vs Stopped:
Blocked contacts are ignored completely, while Stopped contacts cannot receive messages but may become Active again if they send a message (unless restricted by the channel provider).

2
Manually block a contact

  1. Go to Contacts.
  2. Select the contact by checking the box next to their name.
  3. Click the Block icon.

[CAPTURE: Contacts list with a contact selected and the Block icon highlighted.]

Once blocked, the contact is removed from all groups and incoming messages are archived automatically.

3
Unblock a contact

You can unblock a contact at any time.

  1. Go to Contacts.
  2. Click the Blocked sub-category under the Contacts header.
  3. Select the contact.
  4. Click Unblock.

[CAPTURE: Contacts view filtered to “Blocked” with a contact selected and the Unblock button visible.]

After unblocking, the contact returns to Active status but is not automatically re-added to groups.

4
Block contacts automatically in a flow (optional)

You can also block contacts automatically when they send certain words (for example, offensive language or persistent spam).

Example use cases

  • Detect abusive language
  • Block spam triggered by public keywords
  • Protect agents and systems from harmful content

How it works

  1. Collect a response using Wait for Response.
  2. Use rules or expressions to detect undesired words.
  3. Add an Update Contact action.
  4. Set Status = Blocked.

[CAPTURE: Flow showing response rules detecting offensive language.]
[CAPTURE: Update Contact action with Status set to Blocked.]

Once blocked, all future incoming messages from the contact are archived and ignored.

5
Important clarifications and best practices

Clarifications

  • Blocked contacts cannot receive any outbound messages.
  • Flows will not send messages to blocked contacts.
  • Blocked contacts may technically send messages, but messages are archived and flows are not triggered.

Best practices

  • Use Blocked for abuse or spam.
  • Use Stopped for opt-outs.
  • Avoid blocking contacts unless necessary.
  • Combine language detection + blocking in flows when you need automation.

Common Issues & Quick Fixes

Problem: A blocked contact keeps sending messages.

Fix: This is expected. Messages are received but archived automatically and do not trigger flows.

Problem: I accidentally blocked a contact.

Fix: Go to Contacts → Blocked, select the contact, and click Unblock.

Problem: Messages are not sending to a contact.

Fix: Check the contact’s status. If the contact is Blocked, unblock them (if appropriate) to restore outbound messaging.