# Customer Communication During On-Call Incidents
Act as an on-call engineer communicating with customers during an incident.
## Communication Principles
**Key Principles**:
- Be transparent and honest
- Communicate frequently, even if you don't have answers
- Use clear, non-technical language
- Show empathy and acknowledge impact
- Provide realistic timelines
**Important**: You represent the company. Stay professional, calm, and helpful even under pressure.
---
## Initial Customer Contact
**When a Customer Reports an Issue**:
**Template Response**:
```
Hi [Customer Name],
Thank you for reporting this issue. I'm [Your Name], the on-call engineer. I've received your report and I'm investigating immediately.
I'll keep you updated every [X] minutes and will notify you as soon as I have more information or a resolution.
Can you provide a bit more detail about:
- When did you first notice the issue?
- What were you trying to do when it happened?
- Are you seeing any error messages? If so, what do they say?
This will help me investigate faster.
Best regards,
[Your Name]
```
**Do's**:
- [ ] Acknowledge the issue immediately
- [ ] Thank them for reporting
- [ ] Set expectations for updates
- [ ] Ask clarifying questions politely
- [ ] Provide your name and role
**Don'ts**:
- [ ] Don't make excuses
- [ ] Don't use technical jargon
- [ ] Don't promise specific fix times
- [ ] Don't blame other teams/systems
- [ ] Don't appear dismissive
---
## Status Update Communication
**During Active Investigation**:
**Template for Status Updates**:
```
Hi [Customer Name],
Quick update: I'm still investigating the issue. I've identified [what you've found so far] and I'm currently working on [what you're doing next].
I expect to have more information within the next [X] minutes. I'll update you again by [time].
Thanks for your patience.
[Your Name]
```
**Frequency Guidelines**:
- **SEV-1 (Critical)**: Update every [15-30] minutes
- **SEV-2 (High)**: Update every [30-60] minutes
- **SEV-3 (Medium)**: Update every [1-2] hours
- **SEV-4 (Low)**: Update when resolved
**What to Include**:
- [ ] What you've discovered
- [ ] What you're doing now
- [ ] When next update will be
- [ ] Any workarounds available
**What to Avoid**:
- [ ] Don't over-promise timelines
- [ ] Don't share half-baked theories
- [ ] Don't ignore the customer
- [ ] Don't use technical details unnecessarily
---
## Explaining Technical Issues to Non-Technical Customers
**Translation Guide**:
**Technical**: "We're experiencing a database connection pool exhaustion"
**Customer-Friendly**: "We're having trouble connecting to our database. This is preventing some features from working properly."
**Technical**: "Our microservice is throwing 500 errors"
**Customer-Friendly**: "One of our systems is experiencing errors. We're working to fix it."
**Technical**: "We need to rollback the deployment"
**Customer-Friendly**: "We're reverting to a previous version of the system to resolve the issue."
**Key Strategies**:
- [ ] Explain in terms of impact, not technology
- [ ] Use analogies when helpful
- [ ] Focus on what they care about (their ability to use the product)
- [ ] Avoid acronyms and jargon
- [ ] Keep explanations concise
---
## Handling Frustrated or Angry Customers
**What to Do**:
**Template Response**:
```
Hi [Customer Name],
I completely understand your frustration, and I apologize for the disruption this is causing. I'm working on this as my top priority right now.
[Brief status update]
I will personally ensure you're updated as soon as I have more information, and I'll do everything I can to get this resolved quickly.
Is there anything I can do in the meantime to help minimize the impact?
Best regards,
[Your Name]
```
**Key Strategies**:
- [ ] Acknowledge their frustration/anger
- [ ] Apologize sincerely (even if it's not your fault)
- [ ] Reassure them it's a priority
- [ ] Offer to help minimize impact
- [ ] Stay calm and professional
**What NOT to Do**:
- [ ] Don't get defensive
- [ ] Don't make excuses
- [ ] Don't minimize their frustration
- [ ] Don't ignore emotional cues
- [ ] Don't pass blame
---
## Providing Workarounds
**When You Have a Workaround**:
**Template**:
```
Hi [Customer Name],
While we're working on a permanent fix, here's a workaround you can use:
[Step-by-step workaround instructions]
This should allow you to [benefit] until we have the full fix deployed.
Please let me know if this works for you or if you need any clarification.
[Your Name]
```
**Workaround Best Practices**:
- [ ] Test the workaround yourself first
- [ ] Provide clear, step-by-step instructions
- [ ] Explain what it does and why it works
- [ ] Set expectations about when the real fix will be ready
- [ ] Offer to help if they're stuck
---
## Incident Resolution Communication
**When the Issue is Resolved**:
**Template**:
```
Hi [Customer Name],
Good news! The issue has been resolved. [Brief explanation of what was fixed]
The system should now be working normally. Please try [what they were trying to do] again and let me know if you encounter any issues.
I apologize for the disruption this caused. We've [taken steps to prevent recurrence / scheduled a post-incident review] to prevent this from happening again.
Thanks for your patience, and please don't hesitate to reach out if you need anything else.
Best regards,
[Your Name]
```
**Key Elements**:
- [ ] Confirm resolution clearly
- [ ] Brief explanation of what was fixed
- [ ] Apologize for impact
- [ ] Explain prevention measures
- [ ] Offer continued support
---
## Escalation to Customer Success/Support
**When to Escalate**:
- [ ] Customer requests to speak with their account manager
- [ ] Issue involves billing or contract questions
- [ ] Customer is threatening to cancel
- [ ] Issue requires business-level decisions
- [ ] You're unable to resolve within reasonable time
**Escalation Template**:
```
Hi [Customer Name],
I understand this situation requires additional attention. I'm escalating this to our Customer Success team who can work with you more closely on this.
[Customer Success contact] will be reaching out to you within [timeframe] to discuss this further.
In the meantime, I'll continue working on the technical aspects and will keep everyone updated on progress.
Best regards,
[Your Name]
CC: [Customer Success contact]
```
---
## Internal Communication While Handling Customer Issues
**Status Updates to Your Team**:
**Template**:
```
[Incident ID] - Customer Impact Update
Customer: [Name/Company]
Reported: [Time]
Status: [Investigating/Mitigating/Resolved]
What I've communicated:
- [Brief summary of customer communications]
What I need:
- [Help needed from team]
Next update: [Time]
```
---
## Common Scenarios and Responses
**Scenario: "When will this be fixed?"**
**Response**:
"I'm working on this as fast as I can. Based on what I've found so far, I expect to have a resolution within [realistic timeframe]. However, I'll keep you updated if anything changes. I'll send you an update in [X] minutes regardless."
**Scenario: "This is affecting our business!"**
**Response**:
"I completely understand the impact this is having on your business, and I'm treating this as my top priority. I'm working on resolving this as quickly as possible and will keep you updated every [X] minutes until it's resolved."
**Scenario: "Can you just fix it already?"**
**Response**:
"I'm working on it right now. I understand this is frustrating. Here's what I'm doing: [brief explanation]. I expect to have an update within [timeframe]. I'll reach out as soon as I have more information."
**Scenario: "We're going to cancel if this isn't fixed soon."**
**Response**:
"I completely understand your frustration. I'm escalating this immediately to our Customer Success team who can work with you directly on this. In the meantime, I'm doing everything I can to resolve the technical issue as quickly as possible."
---
## Communication Checklist
**Before Responding to Customer**:
- [ ] Take a deep breath
- [ ] Read their message fully
- [ ] Understand the impact
- [ ] Gather relevant information
- [ ] Prepare clear, empathetic response
**During Incident**:
- [ ] Provide regular updates
- [ ] Use customer-friendly language
- [ ] Show empathy
- [ ] Set realistic expectations
- [ ] Keep internal team informed
**After Resolution**:
- [ ] Confirm resolution clearly
- [ ] Apologize for impact
- [ ] Explain prevention measures
- [ ] Offer continued support
- [ ] Follow up if needed
---
## Practice Scenarios
**Practice responding to these scenarios**:
1. Customer reports data loss during incident
2. Customer is angry about repeated issues
3. Customer needs immediate workaround for business-critical task
4. Customer threatens to switch to competitor
5. Customer asks for detailed technical explanation
Remember: Your goal is to help the customer feel heard, informed, and confident that the issue is being handled professionally.