Reporting on Blocked Clients

Find who your ministry has blocked, their phone number and IP address, when each block lifts, and when the block was made.

10 minute read

About

Echo keeps a record every time someone is blocked from contacting your ministry. This article shows you where to find that record: who is blocked right now, how to reach them by phone number or IP address, when each block lifts, when the block was made and by whom, and how to be told the moment a new one happens.

There is no single "blocked callers" report. The information lives in four places, and which one you want depends on the question you are asking:

Your question

Where to look

Who is blocked right now, with their phone number and IP address?

The Clients report, with the Blocked Clients switch on

When does this person's block lift, and how many blocks have they had?

The client record, under Actions, Manage Block

When was the block made, and who made it?

The Conversations report, filtered to the Blocked status

Who has Echo blocked automatically, and for what period?

Admin, Settings, Chat Quotas

You need to be an admin, or hold the Admin: CRM permission, to open the Clients report and client records.

What the terms mean

Echo uses several of these words in its own particular way, and two of them are easy to read as something they are not.

Term

What it means

Blocked client

A person your ministry has blocked. While the block lasts, they cannot reach you on any channel: chat, text, phone, email or social.

Block duration

How long the block will last, chosen when it is made. The choices are 24 hours, 48 hours, 72 hours, 1 week, 2 weeks, 3 months, 6 months and 1 year.

Blocked until

The date and time the block lifts. Nothing has to be undone. When that moment passes the person can reach you again.

Total previous blocks

How many separate blocks this person has had with your ministry. Extending a block that is still running does not add to this number. A second entry means they were blocked, the block ran out, and they were blocked again.

Blocked (Clients report column)

Yes or No, for right now. It does not say when the block was made or how long it has left.

Blocked (conversation status)

A conversation that a responder ended by blocking the person. The conversation's date is the date of the block.

Duration (Conversations report column)

How long the conversation lasted. This is not the length of the block. It is the column people most often mistake for one.

IP address

The internet address the person's web chat came from. Blocks follow it: anyone else arriving from that same address is treated as blocked by your ministry too.

Blocked Clients (filter)

Three settings. Include Blocked shows everyone, Exclude Blocked leaves blocked people out, and Only Blocked returns nothing but blocked people.

Quota

A limit on how often one person may contact you. Pass it and Echo blocks them by itself, without anyone on your team doing anything.

Who is blocked right now

This is the list to start from. It gives you the name, the email address, the phone number and the IP address for everyone your ministry currently has blocked.

  1. Open Clients under Analytics.

The Clients report builder, showing the Date Range, Blocked Clients, Sources and Filters controls above the Find Clients button.
The Clients report builder. The Blocked Clients switch sits in the top row, beside Date Range.
  1. Click Date Range and choose the period you want to look at. This field is required.

  2. Click Sources and select the channels to include. This field is required too. If you want the whole picture, select them all.

  3. Turn the Blocked Clients switch on. The line underneath it changes from All clients to Only blocked.

A close-up of the Blocked Clients switch, turned on, with Only blocked written underneath it.
With the switch on, the report returns blocked people only.
  1. Click Find Clients.

The report results: tiles counting total and blocked clients, and a table of blocked people with their email, phone and IP address.
The Blocked Clients tile counts everyone with a block in force. The table below it lists them.

What each column tells you

Column

What it means

Name

The seeker's name. Click it to open their record.

Email

Their email address, if Echo has one.

Phone

Their phone number, if they have ever reached you by phone or text.

IP Address

The address their web chat came from. Blank for people who only ever called or texted.

Country, City, State, Zip Code

Where Echo places them.

Blocked

Yes or No.

Created At, Updated At

When the person's record was made and when it last changed. Neither of these is the date of the block.

Click Columns above the table to show, hide or reorder any of them. Your choices are remembered for next time.

Two people with the same IP address in this list is worth a second look. It usually means one person came back on a new device or a new browser, and Echo's IP blocking caught them.

Exporting the list

Use Export rather than copying the table by hand. You can export without running the report first.

  1. Click Export in the report builder.

  2. Choose xlsx or CSV.

  3. Choose Direct Download for a small list, or Email Delivery for a large one.

  4. Click Export Report.

The Export Report dialog, offering xlsx or CSV and either direct download or email delivery.
Email delivery sends you a link when the file is ready, so a long report cannot time out while you wait.

The export contains the same columns as the table, so it carries the name, phone number and IP address of everyone in the list.

When a block lifts, and how many blocks someone has had

The report tells you that a person is blocked. Their record tells you until when.

  1. Click the person's name in the report to open their record.

A client record with a red Blocked badge beside the name, and the phone number and IP address in the Basic Information panel.
A Blocked badge sits beside the name. The phone number and IP address are in Basic Information.
  1. Click Actions, then Manage Block.

The Manage Block panel, showing Currently Blocked, the date the block lifts, the total previous blocks, and a duration list.
Blocked until is the date and time it lifts. Total previous blocks is how many times this person has been blocked before.

From this panel you can also change the length of the block, extend it, or choose Unblock Now to end it immediately.

The panel also tells you why someone is blocked when the block is not their own. It will say Blocked via IP Address or Blocked via Related Client, and name the person whose block is being applied.

A block that has expired leaves no row anywhere. Total previous blocks is the only place Echo counts blocks that are over.

When a block was made, and who made it

When a responder blocks someone from a conversation, that conversation is closed and its status becomes Blocked. Finding those conversations gives you the date of each block and the name of the responder who made it.

  1. Open Conversations under Analytics.

  2. Set your Date Range and Sources.

  3. Click Filters to open the Advanced Search drawer.

The Advanced Search drawer on the Conversations report, listing Basic Information, Status and Outcomes, Demographics and Tags.
The drawer groups the filters. Blocking lives under Status and Outcomes.
  1. Open Status & Outcomes.

The Status and Outcomes filter group open, showing Blocked Clients set to Include Blocked, and the Twilio Call Status options.
Blocked Clients is the first field in this group.
  1. Scroll down to Statuses and tick Blocked. This finds the conversations that ended in a block.

  2. Click Apply Filters, then Run Report.

Conversations report results filtered to blocked conversations, listing the client, the responder, the duration and the created date for each.
One row per block: the seeker, the responder who blocked them, the channel and the date.

Remember that the Duration column here is how long the conversation ran, not how long the block lasts.

Set Blocked Clients to Only Blocked instead, and leave Conversation Status alone, to see every conversation these people have ever had with you. That is the fuller history behind a repeat offender.

Blocks Echo makes on its own

Not every block is made by a person. Echo has two quotas that block someone automatically when they contact you too often. Both create an ordinary block, so the people they catch appear in the Clients report alongside everyone else.

The chat quota, and its own report

Go to Admin, Settings, Chat Quotas, then click Chat Quota to set it, or open the report to see who it has caught.

The Chat Quotas report, listing names with their conversation counts, whether they are currently blocked, and the block period.
This is the one screen in Echo that shows a block period as a start and an end.

Column

What it means

Number of Conversations

Every conversation this person has had with you.

Number of Blocked Conversations

How many times the chat quota has blocked them.

Currently Blocked?

true or false.

Block period

When the current block started and when it ends.

The times on this screen are shown in UTC, not your ministry's time zone. Everywhere else in Echo the times are local, so check the label before you compare a block period against anything else.

This report only lists people the chat quota has blocked. Someone a responder blocked by hand will not appear here.

The call quota

Go to Admin, Settings, Call Quotas. When a caller passes the limit, Echo plays them a recording, optionally takes a voicemail, and blocks them for the period you set.

The Phone Call Quotas settings screen, with fields for quota size, hours, minimum call time, blocked duration and a whitelist.
The legend at the bottom of the screen explains each field.

Field

What it means

Quota Size

How many calls the caller is allowed.

Hours

How far back Echo looks when counting those calls.

Min Call Time in Seconds

How long a call must connect for before it counts. Set to 0 and every call counts.

Blocked Duration in Hours

How long the caller is blocked once they pass the limit.

Whitelist

Numbers the quota never applies to.

The Calls overview in your reports carries a card called Calls Blocked by Quota, which counts the calls turned away this way.

Being told the moment someone is blocked

If your reason for reading a blocked list is to catch a problem before it grows, do not wait for the report. Echo can message you every time a block is made.

  1. Go to Admin, then Alerts.

  2. Click New Alert and choose the Block event.

  3. Write the message people should receive.

  4. Choose how it is delivered: email, text message, or a banner inside Echo.

  5. Add the people who should get it.

The Alerts screen in Echo's admin area, listing alert events including Block with their messages.
The Block event, alongside the other alerts your ministry has set up.

What these reports do not show

Worth knowing before you go looking for something that is not there.

  • No column for the date a block was made. The Clients report shows who is blocked, not when it happened. The nearest thing is the date of the blocked conversation in the Conversations report, or the block period on the Chat Quotas report.

  • No column for the length of a block. The client's Manage Block panel shows when it lifts, and you can work the length back from there.

  • Expired blocks are not listed. Every screen in this article shows blocks that are still in force. Once one lifts, the only trace is the count in Total previous blocks.

  • Calls from a blocked number are not reported. When a blocked person calls, Echo rejects the call before it reaches anybody. Nothing in the reports shows you those attempts.

If you need a permanent written history of blocks, export the blocked list on a schedule, or set up the Block alert and keep the emails. Echo will not reconstruct it for you afterward.

If the report comes back empty

What you see

What to check

"Please complete required fields"

Date Range and Sources are both required. Set them, then run the report again.

No rows, but you know people are blocked

Your Sources selection is the usual cause. A blocked person only appears if they reached you through a channel you selected. Select all sources and try again.

Everyone appears, not just blocked people

The Blocked Clients switch is off. The line under it should read Only blocked.

Someone you blocked is missing

Their block may have expired. Open their record and check Total previous blocks.

You cannot find the Clients report at all

You need to be an admin or hold the Admin: CRM permission.

Did this answer your question?

  1. Conversations Report

    The new Conversation Report in Echo's analytics tab provides comprehensive tools for analyzing your conversation data.

  2. Echo CRM 3.0

    CRM or Client Management is where your client information is stored in Echo.

  3. Echo Permissions Definitions

    Permission sets allow teams, or groups, of people in Echo to have certain permissions and/or access to sources and channels.

Still stuck?

Send us your Echo address and a screenshot of what you are seeing, and it goes to somebody who can look at your account.