Documentation Index
Fetch the complete documentation index at: https://docs.meetzy.io/llms.txt
Use this file to discover all available pages before exploring further.
What is Phone Health?
Phone Health is a monitoring system that analyzes the reputation of phone numbers assigned to your agents. It helps you identify numbers being marked as spam and take preventive action.Numbers marked as spam have significantly lower answer rates. Keeping numbers “healthy” is crucial for campaign success.
Understanding Number Types
Your agents can use two types of phone numbers for outbound calls:Twilio Numbers
- Owned by Meetzy: Numbers from our Twilio inventory
- Badge: Show “Twilio” badge in the health report
- Management: Can be swapped automatically for new numbers
- Billing: Included in your Meetzy subscription
Caller IDs (Verified Numbers)
- Client-owned: Your own phone numbers verified through Twilio
- Badge: Show “Caller ID” badge in the health report
- Management: Can be disconnected but not automatically swapped
- Purpose: Use your existing business numbers for outbound calls
Phone Health Indicator
In the agents list, each agent with assigned numbers shows an indicator:Indicator Colors
| Color | Meaning | Affected Numbers |
|---|---|---|
| 🟢 Green | Healthy | 0 numbers affected |
| 🟡 Yellow | Attention | 1-2 numbers affected |
| 🟠 Orange | Warning | 3-5 numbers affected |
| 🔴 Red | Critical | 6+ numbers affected |
View Phone Health Report
To view the detailed report:Report Content
Summary Dashboard
The report shows three main metrics:| Metric | Description |
|---|---|
| Total Numbers | All numbers assigned to the agent (Twilio + Caller IDs) |
| Healthy Numbers | Numbers without spam issues |
| Spam Numbers | Numbers with high spam ratio |
Spam Threshold
Detailed Analysis Table
Each number in the table shows:| Column | Description |
|---|---|
| Phone Number | The phone number with type badge |
| Type Badge | ”Twilio” or “Caller ID” indicator |
| Status | Healthy, Warning, or Spam |
| Total Calls | Total calls made from this number |
| Spam Calls | Calls marked as spam |
| Completed Calls | Successfully completed calls |
| Spam Ratio | Spam percentage with visual bar |
| Actions | Available management options |
Number Status Types
| Status | Spam Ratio | Description |
|---|---|---|
| 🟢 Healthy | Less than 50% | Number is performing well |
| 🟡 Warning | 50% - 70% | Take preventive action |
| 🔴 Spam | Above 70% | Number should be replaced |
Available Actions
For Twilio Numbers
Swap Number
Replace a problematic Twilio number with a fresh one:Disconnect Number
Remove a Twilio number without replacing it:For Caller IDs (Verified Numbers)
Disconnect Only
Caller IDs can only be disconnected (not swapped):Caller IDs are client-owned numbers and cannot be automatically replaced. You must verify new numbers manually if needed.
Best Practices
Preventing Spam
Warning Signs
Watch for these indicators:- Declining answer rates across campaigns
- Calls ending very quickly (under 3 seconds)
- Sudden increase in spam ratio
- Customer complaints about blocked numbers
- Poor performance from newly verified Caller IDs
Mixed Number Strategy
For optimal performance, consider using both number types:- Twilio Numbers
- Caller IDs
Best for:
- High-volume calling
- Testing campaigns
- Automated number rotation
- Quick replacement when marked as spam
How Spam Ratio is Calculated
- Direct user reports to carriers
- Public spam databases
- Extremely short duration (< 3 seconds)
- Systematic rejection patterns
- Carrier-level blocking
Top Performer Number
In the report, the best-performing number is marked with:FAQ
Can I swap a Caller ID like a Twilio number?
Can I swap a Caller ID like a Twilio number?
No, Caller IDs are client-owned and cannot be automatically swapped. You can only disconnect them and manually verify new ones if needed.
Why does my agent only have Caller IDs?
Why does my agent only have Caller IDs?
Some agents are configured to use only verified client numbers for outbound calls. This is common for compliance or branding requirements.
How often is Phone Health updated?
How often is Phone Health updated?
Data is updated every hour. The indicator in the agents list reflects the latest available analysis.
Can I recover a Twilio number after swapping?
Can I recover a Twilio number after swapping?
Not automatically. Once swapped, the number is unlinked. Contact support if you need to recover it.
What happens to active calls during actions?
What happens to active calls during actions?
Active calls are not interrupted. Changes apply only to new calls.
Why does my new Caller ID already have spam history?
Why does my new Caller ID already have spam history?
Verified numbers may inherit reputation from previous usage. Monitor new Caller IDs closely and disconnect if problematic.
Next Steps
Configure Numbers
Learn to assign and manage phone numbers and Caller IDs.
Manage Agents
View and organize your agents.