# FluentBooking — playbook de diagnóstico

## "Quem marcou uma reunião?" / ver a agenda

`fb_list_bookings({period: "upcoming"})` para o que vem aí (omitir `period` já faz isto por
omissão). Para histórico completo (incluindo já realizadas/canceladas), usar
`fb_list_bookings({period: "all"})` — **omitir `period` NUNCA mostra o histórico**, só o que
ainda não aconteceu. Filtrar por convidado com `email` ou `search` (nome).

Cada resultado já traz `location_details` (link da reunião online), `custom_form_data` (respostas
ao formulário de marcação — telefone, empresa, cargo, conforme configurado no event type) e
`source_url` (de que página do site veio a marcação).

## Cancelar ou reagendar uma reunião

Cancelar: `fb_update_booking_status({booking_id, status: "cancelled", cancel_reason: "..."})` —
dispara o email de cancelamento ao convidado automaticamente, não é preciso fazer mais nada.
`refund_payment: true` só faz sentido se a reserva tiver `payment_method` associado (evento pago).

Reagendar não é uma tool deste MCP — a reserva tem um `reschedule_url` próprio
(`https://descomplicar.pt/?fluent-booking=booking&meeting_hash=...&type=reschedule`) que o
convidado usa directamente; não há endpoint admin para reatribuir hora sem passar por aí.

## Marcar como "não compareceu" / concluída manualmente

`fb_update_booking_status({booking_id, status: "no_show"})` ou `status: "completed"`. Sem motivo
associado (`cancel_reason`/`reject_reason` só se aplicam a `cancelled`/`rejected`).

## Reenviar confirmação a um convidado

`fb_send_confirmation_email({booking_id})` — só se o convidado pedir explicitamente ou perdeu o
email original. Dispara um envio real; não usar para "confirmar que a tool funciona".

## `fb_list_bookings` devolve vazio

Quase sempre é o `period` por omissão (`upcoming`) sem reservas futuras — confirmar com
`fb_get_reports` (overview mostra o total histórico) antes de assumir que a agenda está vazia; se
o total for >0 mas `upcoming` vier vazio, repetir com `period: "all"`.

## Investigar uma reunião específica em detalhe

`fb_get_booking({booking_id})` para os dados completos, depois `fb_list_activities({booking_id})`
para a timeline (emails de lembrete enviados, mudanças de estado, quem cancelou e porquê — o
`created_by` fica `null` quando a acção foi automática/pelo sistema).

## Health check rápido

`fb_get_plugin_status` (versões + licença Pro) + `fb_get_reports` (totais) — dois tools sem
argumentos para um snapshot inicial. `fb_list_hosts` confirma que anfitriões têm calendário activo
antes de investigar "porque é que ninguém consegue marcar reunião com X".

## Fora do âmbito deste MCP (fazer via wp-admin)

- Criar uma reserva em nome de alguém (payload de slots dinâmico, risco de email indevido).
- Gerir equipa/permissões, métodos de pagamento, integrações Zoom/Google Calendar/CalDAV, SMS
  (Twilio), webhooks, cupões.
- Activar/desactivar a licença Pro (`fb_get_plugin_status` é read-only).