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
Sobe plano para 70 via Slack, recria a reserva, volta para 71.
Agente
Informa ao operador:
Plano ajustado: 71 → 70 → 71
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. | Executar o sandwich (70 → cria → volta ao plano original) via Slack. |
| 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) executado via Slack.
- booking reason
- Motivo de uso configurado pela empresa; alguns são aplicados automaticamente por regra.