07Playbook operacional

Quando algo saido caminho feliz.

Diálogos de referência, templates de confirmação e o que fazer diante de cada erro.

Exemplo 1 — Reserva recorrente

Mercado Pago · 4 segundas · Check-in Semanal

Operador

"Reserva para fulano@mercadopago.com.br — 10 pessoas — segundas de julho das 9 às 10h — [Coworking]"

Agente

Identifica empresa (MP) e colaborador; verifica as 4 segundas; monta RESUMO DA RESERVA (empresa, colaborador, sala, endereço, datas, horário, participantes, créditos, motivo Check-in Semanal) e pede

SIM

Operador

SIM

Agente

Cria as 4 reservas, registra log + webhook e devolve a mensagem de confirmação pronta para o cliente.

Exemplo 2 — Com ajuste de plano

Colaborador em plano 71 · sandwich automático

Operador

Pede reserva para colaborador em plano 71.

Agente

Tenta o POST →

422

"User must have a valid plan".

Agente

O painel sobe o plano para 70 automaticamente (via API), recria a reserva e volta para 71.

Agente

Informa ao operador:

Plano ajustado: 71 → 70 → 71

Ajuste de plano (sanduíche)

Automático no painel via API — com fallback manual no Slack

Só o plano 70 reserva sala. Se o colaborador estiver em outro plano (ex.: 71), o painel agora faz o sanduíche automático via API: lê o plano atual, sobe para o 70, cria a reserva e devolve ao plano original — sem intervenção manual.

Como funciona (automático)

Tenta criar a reserva normalmente.
Se falhar por plano, lê o plano atual do colaborador e sobe para o 70 (PATCH na API de plano).
Refaz a reserva.
Devolve ao plano original (ex.: 71). Sempre reverte, mesmo se a reserva falhar.

Esses lançamentos aparecem com o selo sandwich na aba de Logs. Em caso raro de a reversão falhar, o painel avisa para ajuste manual — o colaborador nunca fica "preso" no 70.

Fallback manual (Slack)

Se a API de plano estiver indisponível, dá para fazer na mão pelo Slack: /borc setsubscription [ID] 70, criar a reserva e depois /borc setsubscription [ID] [plano original]. O comando só funciona digitado no composer do Slack.

Formato do bloco de confirmação

Enviado ao operador antes de criar a reserva

Template

RESUMO DA RESERVA
— Empresa:        {empresa}
— Colaborador:    {colaborador}
— Sala:           {sala} ({capacidade} lugares)
— Endereço:       {endereco}
— Data(s):        {datas}
— Horário:        {check_in} — {check_out}
— Participantes:  {users_quantity}
— Créditos est.:  {creditos}
— Motivo:         {motivo}

Confirma? (SIM)

Mensagem de confirmação ao cliente

Enviada depois que a reserva foi criada

Template

Olá, {nome}! Sua reserva está confirmada:

• Espaço:         {espaco}
• Endereço:       {endereco}
• Data(s):        {datas}
• Horário:        {check_in} — {check_out}
• Participantes:  {users_quantity}
• Motivo:         {motivo}

Qualquer alteração, pode me acionar!

Playbook de erros

Sintoma → causa → ação

Sintoma	Causa	Ação
504 Gateway Timeout no POST	O servidor demorou, mas a reserva costuma ter sido criada.	Confirmar via API de disponibilidade e registrar com nota — o id pode não retornar.
422 — "User must have a valid plan"	Colaborador não está no plano 70.	O painel faz o sanduíche automático via API (sobe p/ 70, cria e devolve o plano original). Slack só como fallback.
Sala ocupada no horário	Conflito na API de disponibilidade.	Trocar de sala no mesmo espaço, ajustar horário ou avisar o operador.
Espaço fechado no dia/horário (work_hours)	Requisição fora do horário de funcionamento do coworking.	Sugerir outro dia/horário ou outro espaço.
422 — capacidade / "selected room is unavailable"	Sala não comporta o grupo ou está indisponível.	Reduzir participantes ou trocar de sala.

Glossário

Termos usados nesta skill

is_daily: Diária (dia todo, usa work_hours do espaço) vs. janela horária (usa check-in/check-out informados).
Fast Booking: Aprovação automática, sem passar pelo Community Manager. Quando falso, a reserva aguarda aprovação humana.
sandwich: Ajuste temporário de plano (71/72 → 70 → cria reserva → volta ao original), agora automático no painel via API (Slack como fallback).
booking reason: Motivo de uso configurado pela empresa; alguns são aplicados automaticamente por regra.