We notified all stakeholders within ten minutes of confirmation.
Notificamos todas as partes interessadas em até dez minutos após a confirmação.Aula
Comunicação com stakeholders em crise
Nível: B2
Objetivo
Comunicar com stakeholders internos e externos durante uma crise técnica, equilibrando transparência e precisão, usando blocos reutilizáveis: impact summary, customer-facing wording, confidence level, next update e workaround.
Explicação
Em uma crise, a comunicação pesa mais do que a velocidade: dizer pouco demais gera ansiedade, dizer demais gera promessas que o time não consegue cumprir. Em B2, o objetivo é ter um modelo mental em cinco blocos que funciona para um e-mail de status, uma atualização no Slack ou uma postagem pública.
Os cinco blocos de uma atualização de crise
- Impact summary — o que está afetado e em que escala: usuários, regiões, serviços, duração. Seja específico quando puder: `A subset of customers in the EU region is affected`, não `Some users may be affected`.
- Customer-facing wording — escolha de palavras para quem não é técnico. Evite jargão (`queue depth`, `replication lag`); use linguagem concreta (`delays in saving your changes`, `errors when uploading files`).
- Confidence level — indique o quanto você tem certeza sobre o que diz. Use hedging calibrado: `We believe`, `Our current best estimate is`, `We have not yet identified`.
- Next update — diga quando a próxima atualização virá: `We will post the next update by 14:30 UTC` é mais útil do que `We will keep you posted`.
- Workaround — descreva uma alternativa temporária que o cliente pode usar agora para continuar produtivo.
Equilibrar transparência e precisão
A regra prática é: diga o que você sabe, diga o que você não sabe, diga o que está fazendo a respeito. Em inglês de crise, três padrões sustentam esse equilíbrio:
- `What we know:` / `What we're doing:` / `What we'll share next:` — formato de três linhas, comum em status pages.
- `As of 13:10 UTC, we are investigating reports of...` — fixa o tempo e evita parecer antigo.
- `We currently believe the issue is limited to <scope>, but we are still validating.` — afirma um escopo e marca a incerteza sem negar a possibilidade de ampliação.
Tom de voz por audiência
- Interno (engenharia, suporte, liderança): jargão é aceito, números são esperados (`p99 latency`, `error rate`, `blast radius`).
- Executivo / financeiro: foco em impacto de negócio (`revenue at risk`, `SLA breach`, `customer trust`).
- Cliente final: frases curtas, sem jargão, com uma ação concreta que ele pode tomar.
A mesma crise gera três versões da mesma história: uma para o canal de incidentes, uma para a liderança, uma para a status page pública. Reescrever não é repetir.
Exemplos
| Inglês | Tradução | Observação |
|---|---|---|
| As of 13:10 UTC, we are investigating reports of slow checkouts in the EU region. | A partir das 13h10 UTC, estamos investigando relatos de checkouts lentos na região da UE. | Fixa o tempo e o escopo geográfico; evita parecer desatualizado. |
| Impact: a subset of customers is unable to save changes to their dashboards. | Impacto: alguns clientes não conseguem salvar alterações nos painéis. | Customer-facing wording: 'unable to save changes' é concreto, 'a subset' evita alarme absoluto. |
| We currently believe the issue is limited to one database replica, but we are still validating the scope. | No momento, acreditamos que o problema está limitado a uma réplica do banco, mas ainda validamos o escopo. | Hedging calibrado: believe + limited to + still validating. |
| Next update by 14:30 UTC. | Próxima atualização até as 14h30 UTC. | Compromisso de tempo curto; mais útil do que 'em breve'. |
| Workaround: customers can export their data as CSV from the Reports tab while we work on a fix. | Solução temporária: clientes podem exportar seus dados como CSV na aba Relatórios enquanto trabalhamos na correção. | Workaround concreto e executável, sem jargão. |
| What we know: the API is returning 503 errors for about 8% of requests in eu-west-1. | O que sabemos: a API está retornando erros 503 para cerca de 8% das requisições em eu-west-1. | Formato de três linhas para o canal interno; números são aceitos. |
| We have not yet identified the root cause, but we have ruled out the recent deploy. | Ainda não identificamos a causa raiz, mas descartamos o deploy recente. | Diz o que você não sabe sem soar paralisado, e diz o que já eliminou. |
| Posted to the status page and shared with the on-call channel within five minutes of confirmation. | Publicado na status page e compartilhado no canal on-call em até cinco minutos após a confirmação. | Linha típica do resumo executivo: ação, canal, prazo. |
Erros comuns
- Prometer um horário de resolução que você não pode garantir: `We expect full recovery by 15:00 UTC` deve virar `We are working toward recovery and will share a more precise ETA in the next update`.
- Usar jargão técnico em mensagens para clientes: `We are seeing elevated p99 latency due to queue backlog` deve ser reescrito como `Some requests are taking longer than usual`.
- Escrever 'we apologize for any inconvenience' sem informação útil: a frase não substitui impact, workaround ou next update.
- Misturar tempos verbais em uma única atualização: 'we identified the cause' (passado) + 'we are working on a fix' (presente contínuo) é correto; 'we identified' + 'we work on it' (presente simples) soa como status desatualizado.
- Esquecer o workaround: dizer 'we are investigating' sem oferecer alternativa deixa o cliente sem ação possível.
- Escrever 'as previously mentioned' em uma primeira atualização: o leitor não leu a versão anterior; repita o essencial.
- Usar 'maybe' ou 'probably' na status page pública: prefira `we believe`, `our current best estimate`, `we have not yet confirmed`.
Prática guiada
Reescreva cada esboço aplicando os cinco blocos. As respostas-modelo mostram o tom certo para cada audiência.
- Versão interna
Esboço: `eu-west-1 is throwing 503s, p99 is bad, ops is looking.` → `Impact: ~8% of requests in eu-west-1 are returning 503 since 13:08 UTC. What we know: a single replica is saturated; the other two are healthy. What we're doing: draining traffic to healthy replicas. Next update: in 15 minutes.`
- Versão executiva
Esboço: `sla risk, leadership needs to know` → `Customer impact: ~3% of EU enterprise accounts are seeing errors. Revenue at risk: estimated 40k EUR per hour. Confidence on scope: medium — we have not yet ruled out the second region. Next update: 14:30 UTC.`
- Versão para a status page (pública)
Esboço: `db broken, fix coming` → `We are investigating reports of errors when saving changes. Impact: a subset of customers in the EU region. Workaround: please use the Reports tab to export your work. We will share the next update by 14:30 UTC.`
Observe que as três versões compartilham a mesma base factual, mas mudam vocabulário, granularidade e tom.
Resumo
Uma atualização de crise em B2 é montada em cinco blocos reutilizáveis: impact summary (o que está afetado, com escopo claro), customer-facing wording (sem jargão, com ação concreta), confidence level (`we believe`, `we have not yet confirmed`), next update (horário curto e explícito) e workaround (o que o cliente pode fazer agora). O equilíbrio entre transparência e precisão vem de dizer o que você sabe, o que você não sabe e o que você está fazendo a respeito — geralmente no formato `What we know: / What we're doing: / What we'll share next:`. A mesma crise produz três versões: técnica para o canal de incidentes, de negócio para a liderança, e simples para a status page pública.
Vocabulário
Palavras principais
Transparency during a crisis builds long-term trust.
Transparência durante uma crise constrói confiança a longo prazo.We aim for precision over speed in the first public update.
Buscamos precisão em vez de velocidade na primeira atualização pública.The impact summary should lead the update.
O resumo de impacto deve abrir a atualização.Avoid internal jargon in customer-facing updates.
Evite jargão interno em atualizações voltadas ao cliente.Always state your confidence level, not only the facts.
Sempre indique seu nível de confiança, não apenas os fatos.The next update will be posted at 14:30 UTC.
A próxima atualização será publicada às 14h30 UTC.Use the CSV export as a workaround until we deploy the fix.
Use a exportação de CSV como solução temporária até implantarmos a correção.We posted the first status page update within five minutes.
Publicamos a primeira atualização na página de status em até cinco minutos.Only customers in the EU region are affected.
Apenas clientes na região da UE estão afetados.A subset of customers is seeing slow responses.
Parte dos clientes está vendo respostas lentas.We are still validating the scope of the incident.
Ainda estamos validando o escopo do incidente.We have not yet identified the root cause.
Ainda não identificamos a causa raiz.Draining traffic is our current mitigation.
Desviar o tráfego é a nossa mitigação atual.We do not have a reliable ETA yet.
Ainda não temos uma ETA confiável.The investigation is still ongoing.
A investigação ainda está em andamento.We are monitoring the situation closely.
Estamos monitorando a situação de perto.The blast radius is currently limited to one region.
O raio de impacto está limitado a uma região por enquanto.História
História: Comunicação com stakeholders em crise
Nível: B2
História em inglês
The alert at 13:08
At 13:08 UTC, the on-call engineer received a SEV-2 alert from the checkout service. Within three minutes, the engineer opened the incident channel and called the incident commander. The first internal message went out: "As of 13:11 UTC, we are investigating reports of slow checkouts in eu-west-1." The blast radius was still unclear, and the team had not yet identified the root cause.
Writing three updates at once
The incident commander assigned one engineer to draft the internal update, one to draft the executive summary, and one to draft the status page post. The internal update was precise and numeric: "Impact: ~6% of checkout requests in eu-west-1 returning 503 since 13:08 UTC." The executive summary translated the same facts into business terms: revenue at risk, SLA exposure, and confidence on scope. The status page version was short and concrete: customers could not complete a purchase in the EU region. Each version stated a confidence level: "We currently believe the issue is limited to one region, but we are still validating the scope."
The first public post
At 13:25 UTC, the status page post went live. It opened with the impact, named the affected region, and offered a workaround: customers could use the mobile app, which was not affected. It closed with a short commitment: "We will share the next update by 14:00 UTC." Inside the company, the executive summary highlighted that revenue at risk was estimated at 40k EUR per hour, but confidence on scope was still medium. The leadership team asked for one thing: do not over-promise, and do not go silent.
The second update and the mitigation
By 13:50 UTC, the team had ruled out the recent deploy and identified one database replica as the source. The mitigation was clear: drain traffic from the bad replica and let the two healthy ones absorb the load. The second public update said, "As of 14:00 UTC, we have applied a mitigation and are monitoring recovery. We have not yet identified the root cause." It also said, "We currently estimate that most customers will see recovery within the next 30 minutes." By 14:35 UTC, error rates were back to normal, and the third update closed the public incident with a commitment to publish a post-mortem within five business days.
What the team learned
In the retrospective, the team agreed that having a template saved the most time. The five-block structure, what we know, what we are doing, the next update, the workaround, and the impact, was reused for every status update. They also agreed that the worst mistake during a crisis is silence, and the second worst is over-promising. From then on, every public update had to include an impact summary, a workaround, a confidence level, and a next update time.
Tradução linha por linha
| Inglês | Tradução |
|---|---|
| At 13:08 UTC, the on-call engineer received a SEV-2 alert from the checkout service. | Às 13h08 UTC, o engenheiro de plantão recebeu um alerta SEV-2 do serviço de checkout. |
| Within three minutes, the engineer opened the incident channel and called the incident commander. | Em até três minutos, o engenheiro abriu o canal de incidente e chamou o comandante do incidente. |
| The first internal message went out: "As of 13:11 UTC, we are investigating reports of slow checkouts in eu-west-1." | A primeira mensagem interna foi enviada: "A partir das 13h11 UTC, estamos investigando relatos de checkouts lentos em eu-west-1." |
| The blast radius was still unclear, and the team had not yet identified the root cause. | O raio de impacto ainda era incerto, e o time ainda não tinha identificado a causa raiz. |
| The incident commander assigned one engineer to draft the internal update, one to draft the executive summary, and one to draft the status page post. | O comandante do incidente designou um engenheiro para rascunhar a atualização interna, um para o resumo executivo e um para a postagem da status page. |
| The internal update was precise and numeric: "Impact: ~6% of checkout requests in eu-west-1 returning 503 since 13:08 UTC." | A atualização interna foi precisa e numérica: "Impacto: ~6% das requisições de checkout em eu-west-1 retornando 503 desde 13h08 UTC." |
| The executive summary translated the same facts into business terms: revenue at risk, SLA exposure, and confidence on scope. | O resumo executivo traduziu os mesmos fatos em termos de negócio: receita em risco, exposição de SLA e confiança no escopo. |
| The status page version was short and concrete: customers could not complete a purchase in the EU region. | A versão da status page foi curta e concreta: clientes não conseguiam concluir uma compra na região da UE. |
| Each version stated a confidence level: "We currently believe the issue is limited to one region, but we are still validating the scope." | Cada versão indicava um nível de confiança: "No momento, acreditamos que o problema está limitado a uma região, mas ainda validamos o escopo." |
| At 13:25 UTC, the status page post went live. | Às 13h25 UTC, a postagem da status page foi publicada. |
| It opened with the impact, named the affected region, and offered a workaround: customers could use the mobile app, which was not affected. | Ela abria com o impacto, citava a região afetada e oferecia uma solução temporária: clientes podiam usar o aplicativo móvel, que não estava afetado. |
| It closed with a short commitment: "We will share the next update by 14:00 UTC." | Ela terminava com um compromisso curto: "Compartilharemos a próxima atualização até as 14h UTC." |
| Inside the company, the executive summary highlighted that revenue at risk was estimated at 40k EUR per hour, but confidence on scope was still medium. | Dentro da empresa, o resumo executivo destacava que a receita em risco estava estimada em 40 mil euros por hora, mas a confiança no escopo ainda era média. |
| The leadership team asked for one thing: do not over-promise, and do not go silent. | A liderança pediu uma coisa: não prometer demais, e não ficar em silêncio. |
| By 13:50 UTC, the team had ruled out the recent deploy and identified one database replica as the source. | Às 13h50 UTC, o time tinha descartado o deploy recente e identificado uma réplica do banco como origem. |
| The mitigation was clear: drain traffic from the bad replica and let the two healthy ones absorb the load. | A mitigação era clara: desviar o tráfego da réplica ruim e deixar as duas saudáveis absorverem a carga. |
| The second public update said, "As of 14:00 UTC, we have applied a mitigation and are monitoring recovery. We have not yet identified the root cause." | A segunda atualização pública dizia: "A partir das 14h UTC, aplicamos uma mitigação e estamos monitorando a recuperação. Ainda não identificamos a causa raiz." |
| It also said, "We currently estimate that most customers will see recovery within the next 30 minutes." | Também dizia: "No momento, estimamos que a maioria dos clientes verá a recuperação nos próximos 30 minutos." |
| By 14:35 UTC, error rates were back to normal, and the third update closed the public incident with a commitment to publish a post-mortem within five business days. | Às 14h35 UTC, as taxas de erro voltaram ao normal, e a terceira atualização encerrou o incidente público com o compromisso de publicar um post-mortem em até cinco dias úteis. |
| In the retrospective, the team agreed that having a template saved the most time. | Na retrospectiva, o time concordou que ter um modelo economizou mais tempo. |
| The five-block structure, what we know, what we are doing, the next update, the workaround, and the impact, was reused for every status update. | A estrutura de cinco blocos, o que sabemos, o que estamos fazendo, a próxima atualização, a solução temporária e o impacto, foi reutilizada em todas as atualizações de status. |
| They also agreed that the worst mistake during a crisis is silence, and the second worst is over-promising. | Eles também concordaram que o pior erro durante uma crise é o silêncio, e o segundo pior é prometer demais. |
| From then on, every public update had to include an impact summary, a workaround, a confidence level, and a next update time. | A partir de então, toda atualização pública tinha que incluir um resumo de impacto, uma solução temporária, um nível de confiança e um horário para a próxima atualização. |
Notas de vocabulário
- SEV-2 alert = alerta de severidade 2; convenção para classificar a gravidade do incidente
- incident commander = comandante do incidente; pessoa que coordena a resposta e as atualizações
- As of 13:11 UTC = a partir das 13h11 UTC; fixa o tempo da atualização para evitar parecer desatualizado
- blast radius = raio de impacto; até onde a falha está se espalhando
- revenue at risk = receita em risco; tradução financeira do impacto, usada no resumo executivo
- confidence on scope = confiança no escopo; hedging típico para indicar o quanto a equipe sabe sobre a abrangência
- workaround = solução temporária; alternativa que o cliente pode usar enquanto o problema não é resolvido
- drain traffic from the bad replica = desviar o tráfego da réplica defeituosa para as saudáveis; mitigação comum em incidentes de banco
- we currently estimate = no momento, estimamos; hedge calibrado em vez de promessa firme
- publish a post-mortem within five business days = publicar um post-mortem em até cinco dias úteis; compromisso típico de transparência pós-crise
- the worst mistake during a crisis is silence = o pior erro em uma crise é o silêncio; lembrete de que atualizações curtas valem mais do que nenhuma atualização
Perguntas de compreensão
- What triggered the SEV-2 alert at 13:08 UTC?
- How many versions of the same update did the incident commander ask for, and which audiences?
- What was the workaround offered to customers in the first public post?
- What confidence level did the team express about the scope, and how did they mark it?
- Why did the leadership team ask the engineers not to over-promise?
- What mitigation did the team apply at 14:00 UTC?
- What did the third public update commit to do after recovery?
- What did the team identify as the worst and second-worst mistakes during a crisis?
- What four elements did the team require in every public update from then on?
Prática com a história
- Reescreva como workaround customer-facing: "Use the alternate ingress in the secondary cluster to bypass the bad node."
- Reescreva com confidence level: "We have no idea what is causing this."
- Reescreva como next update útil: "We will update you soon."
- Reescreva como impact summary: "eu-west-1 is throwing 503s on the checkout API."
- Reescreva com hedge calibrado: "The issue will be fixed in 30 minutes."
Prática
Exercícios e teste
A próxima melhoria é transformar esses arquivos em perguntas com resposta no navegador. Por enquanto, esta página já organiza o estudo e permite seguir a aula inteira sem abrir os arquivos manualmente.