# Blocked numbers

> Stop your agents from answering one number or a whole country, see what a block does and does not do, and let the agent answer again.

Source: https://docs.whatsetter.com/dashboard/blocked-numbers/

Some numbers should never get an answer from your agents: spam, cold pitches, countries you do not serve. A blocked number is a number no agent answers. Its messages still arrive, and you can still write by hand.

This page is about the numbers you block. To keep WhatsApp from limiting or blocking your own number, see [How we protect your number](/dashboard/anti-ban/).

## Where blocked numbers are now

Open **Settings** in the **Account** group of the menu, then **Blocked numbers** in the **Workspace** part. Older guides call this list "Numbers the agent ignores" and place it with the links: it is the same list, moved to Settings.

The section shows the blocked countries under **Dial codes** and the single numbers under **Numbers**, each number with its reason and the date it was added. When nothing is blocked, it reads **The agent answers everyone**.

You see **Blocked numbers** if your profile includes the right **Edit leads** or **Edit the team’s settings**. A number can also be blocked without opening Settings, from its conversation or from **Leads**.

## What a block does

A block is set in **Settings**, under **Blocked numbers**, or from a conversation. It applies to the whole workspace, on every agent.

- No agent answers that number any more, and no automatic follow-up is sent to it.
- Its messages keep landing in [Conversations](/dashboard/conversations/), where the conversation shows the word **Ignored**.
- You can still answer by hand.

What a block does not do:

- It is not a WhatsApp block: the person can keep writing to you. To block someone on WhatsApp itself, do it from the phone.
- It does not take the number out of your lists: a first message planned in a list can still leave. To keep a country out of a list, exclude it when you import: see [Lists & import](/dashboard/lists/).

## Block a number from a conversation

1. Open **Conversations** and select the conversation.
2. Open **Details**, at the top of the conversation, if the panel is not already shown.
3. At the bottom of the panel, click **Stop the AI answering this number**.

The app confirms with **Noted: the agent will not answer anymore.** and the conversation now shows **Ignored**.

You need the right **Edit leads**: without it, the click answers **Restricted action**. The button exists on one-to-one WhatsApp conversations only. It is not offered in a group, nor on a number that follows groups, where no agent answers anyway.

## Block a number from Leads

Open **Leads** and click the lead to open its panel. Click the three dots at the top of the panel, then **Stop the AI answering this number**. The panel then reads **The AI no longer answers this number.**

You can also block while deleting one lead: in the confirmation window, tick **Stop the AI answering this number**. If the person writes again, they come back to your leads, but the agent does not answer them.

Both need the right **Edit leads**, and both are offered for WhatsApp leads only. A lead covered by a blocked dial code has no such option: the block is lifted in **Settings**.

## Block a number or a whole country from Settings

1. Open **Settings**, then **Blocked numbers**, and click **Add**.
2. Choose **A number** or **A country**.
3. For a number, type it under **WhatsApp number** with its dial code, for example +33 6 12 34 56 78. For a country, search it and select it in the list.
4. Add a **Reason (optional)** so the team remembers why.
5. Click **Stop answering**.

Blocking a number needs the right **Edit leads**. Blocking a country needs **Edit the team’s settings**. The choice you are not allowed to make is greyed out. If the rule already exists, the app says **Already on the list.**

## What blocking a country covers

In **Settings**, under **Blocked numbers**, a blocked country is kept as its dial code, for example +91 for India. No agent answers a number that starts with that code.

- Some dial codes are shared: +1 covers the United States, Canada and other countries. The window names them before you confirm, and the list shows how many countries the code covers.
- WhatsApp hides the phone number of some contacts. A dial code cannot match them: block those contacts one by one from their conversation. In the list they appear as **Masked number**.
- A contact covered by a dial code cannot be freed from its conversation: remove the dial code in **Settings**.

## Let the agent answer a number again

There are three places to lift a block.

- In **Conversations**: open **Details** and click **Let the AI answer again**.
- In **Leads**: open the lead, click the three dots, then **Let the AI answer again**.
- In **Settings**, under **Blocked numbers**: click the cross at the end of the line of the number, or on the dial code. There is no confirmation.

The app confirms with **The agent answers again.** Nothing is lost while a number is blocked: its messages stayed in the conversation. You can block the same number again at any time.

## Who can block, and how many rules

In **Settings**, under **Blocked numbers**, what you can do depends on your rights.

| Action | Right needed |
|---|---|
| Block or free one number | **Edit leads** |
| Block or free a country (dial code) | **Edit the team’s settings** |

The **Owner**, an **Admin**, an **Editor** and a **Responder** can block a number. Only the **Owner** and an **Admin** can block a country. Rights are set on the Team page: see [Team, profiles & access](/dashboard/team/).

A workspace can hold up to 500 rules, numbers and dial codes together. Blocking is also available through the API: see [API: blocked contacts](/developers/guides/blocked-contacts/).

## Related

- [Conversations](/dashboard/conversations/)
- [Take over a conversation](/dashboard/human-takeover/)
- [Settings](/dashboard/settings/)
- [Lists & import](/dashboard/lists/)
