PG6 AGENDA V3.2.24

1. PERMISSÃO DO MAPA DE O.S.
Nova coluna:
  users.can_view_os_map

Padrão:
  0 = DESABILITADO

Isso vale inclusive para usuários que já existiam após a migração.
O administrador da Agenda entra em:
  Usuários e cidades > Mapa de O.S.

e libera individualmente cada usuário.

A proteção não é apenas visual:
- sem permissão, o menu Mapa de O.S. não aparece;
- acesso direto por URL é bloqueado;
- ajax/os_map_data.php também valida a permissão no servidor.

2. INTEGRAÇÕES EXTERNAS PELO SUPER ADMIN
Foi criada no Super Admin a seção:
  Integrações externas → Agenda / O.S.

Ela permite preparar conectores como:
  GTF Chat
  CRM
  Bot
  Sistema comercial
  Outro ERP/aplicativo

O Super Admin informa:
- nome do sistema;
- código/origem;
- URL de origem;
- token;
- ativo/inativo.

Também pode gerar um novo token.

3. ABERTURA DE O.S. PELO CHAT / SISTEMA EXTERNO
Endpoint:
  POST /api/v1/appointments.php

Header:
  X-API-Token: TOKEN_CONFIGURADO_NO_SUPER_ADMIN

A chamada pode informar:
- external_id/protocolo;
- cliente;
- CPF;
- WhatsApp;
- cidade por ID ou nome;
- atividade por ID, código ou nome;
- data;
- turno;
- endereço;
- número;
- referência/Google Maps;
- observações;
- técnico opcional.

Fluxo:
Sistema externo
  -> API PG6
  -> salva na Agenda
  -> calcula destino Maps
  -> executa sincronização IXC configurada
  -> cria/vincula a O.S.
  -> devolve ID do agendamento e ID/resultado da O.S. IXC.

external_id + origem possui proteção contra duplicidade.

4. SUPER ADMIN
Toda a configuração dos conectores externos fica no Super Admin.
O tenant não precisa receber credenciais manualmente para cada integração.

5. VERSÕES
Template 3.2.24
Tenant Schema 33
Master Schema 30
