05Como a skill funciona

Como a skill pensa.Passo a passo.

Objetivo, workflow em 8 etapas, APIs, disponibilidade, sandwich, motivos, logging e tratamento de erros.

Objetivo

Automatizar o fluxo que o CS fazia manualmente no backoffice — buscar disponibilidade, identificar empresa/colaborador e criar a reserva — chamando as APIs da Woba. Apenas o ajuste de plano usa navegador (Slack).

Workflow
8 etapas do fluxo automatizado
  1. 1
    Qualificar pedido

    cidade ou espaço, capacidade, data, check-in, check-out e e-mail do solicitante (o domínio identifica a empresa).

  2. 2
    Buscar salas

    search-ms filtra localização, capacidade e disponibilidade, capturando work_hours.

  3. 3
    Apresentar opções

    Fast Booking primeiro, com endereço, créditos, amenidades e link.

  4. 4
    Identificar empresa

    pelo domínio do e-mail ou via API.

  5. 5
    Identificar colaborador

    nome dentro da empresa.

  6. 6
    Motivo de uso

    quando a empresa configura; alguns são automáticos.

  7. 7
    Confirmar resumo

    bloco único; aguarda “SIM”.

  8. 8
    Criar booking

    POST; se falhar por plano, aciona sandwich e recria.

APIs utilizadas
fontes chamadas pela skill
search-mspública

busca de salas e work_hours.

backoffice-apiauth-token

auth, usuários, indisponibilidade e cancelamento.

booking-manager-msauth-token

criação da reserva (HTTP 300 = sucesso).

woba-backendbearer

motivos configurados por empresa.

Slack #borc-portal-livenavegador

via navegador (/borc setsubscription).

Sandwich de plano
ajuste temporário para permitir a reserva
70
reserva sala ✓
71
só compartilhado
72
só escritório exclusivo
Plano atual (72/71)
sobe p/ 70
cria reserva
volta ao plano original

Automático via Slack (/borc setsubscription).

Motivos de reserva (booking reason)
regras por empresa/condição

Cada empresa pode ter uma lista própria de motivos configurados. O motivo pode ser: (a) escolhido manualmente pelo operador no momento da reserva, ou (b) aplicado automaticamente por uma regra por empresa/horário. As regras automáticas são específicas de cada carteira de clientes e serão cadastradas gradualmente pelo time — nesta versão o padrão é o operador escolher o motivo manualmente.

Condição
Mercado Pago · segunda 09–10h
Motivo
Check-in Semanal
Condição
Stellantis
Motivo
Reunião de equipe
Condição
Demais casos
Motivo
operador escolhe
As regras automáticas por empresa serão adicionadas por cada operador conforme sua carteira. Comece pelo fluxo geral (motivo manual).
Detalhes técnicos
disponibilidade, tipos, logging e erros