ConnectWiz + Calendário da Apple

Integração em produção

Calendário da Apple: as marcações saem, o tempo ocupado entra

As marcações feitas no ConnectWiz aparecem no Calendário da Apple e desaparecem ao cancelar — e os eventos que já estão no Calendário da Apple subtraem-se à disponibilidade, por isso a IA nunca oferece quinta-feira às 15:00 quando o seu calendário tem ali o dentista.

Os eventos saem O tempo ocupado subtrai-se Papel e direção por fonte
Calendário da Apple × ConnectWiz
Marcação → evento de calendário
Bloco ocupado → menos disponibilidade
Ler / escrever / ambos / só ocupação
4
Campos enviados por evento — título, nota, início, fim. Sem participantes, sem convites, mais nada sai
3
Eixos independentes por fonte — alimenta as marcações, espelha as marcações para fora, bloqueia a disponibilidade
Null ≠ 0
«Não foi possível ler o seu calendário» nunca é tratado como «está livre»
1
Registo de marcações — os calendários espelham-no e informam-no; nenhum deles passa a mandar

Calendários

O que faz — ao certo

Envia e limpa atrás de si

As marcações novas criam eventos no Calendário da Apple; os cancelamentos removem-nos. O calendário do profissional nunca fica um dia atrasado em relação à agenda.

O tempo ocupado conta

Os eventos externos subtraem-se à disponibilidade antes de qualquer porta — painel, IA, flow ou widget — oferecer um horário. A marcação dupla contra a sua vida pessoal também fica bloqueada.

A direção é uma definição

Em cada fonte ligada escolhe: ler dela, escrever nela, as duas coisas, ou só a ocupação — para que um calendário partilhado da clínica e um pessoal possam ter papéis diferentes sem se atropelarem.

Por dentro

Uma sincronização que não marca duas coisas à mesma hora

CalDAV com uma palavra-passe específica da app

A porta que a Apple suporta para terceiros é o CalDAV: cunha uma palavra-passe específica da app no seu Apple ID (a palavra-passe verdadeira nunca sai da Apple) e os eventos são lidos e escritos na coleção de calendários do iCloud através do padrão aberto.

Os papéis são três eixos, não um menu pendente

Em cada fonte define se ela alimenta as marcações (nunca, importação única ou em contínuo), se as marcações se espelham nela, e se o tempo ocupado dela bloqueia a disponibilidade — um calendário partilhado da clínica e um pessoal podem ter papéis completamente diferentes.

Falha fechada onde tem de ser

Um calendário que só bloqueia disponibilidade falha fechado num erro de leitura — um tempo ocupado desconhecido bloqueia as marcações em vez de permitir uma colisão. Uma fonte que alimenta o registo falha aberta. Errar esta linha é o erro mais caro que há na sincronização de calendários, por isso é uma regra, não um estado de espírito.

Ligações que se recompõem sozinhas

Uma ligação que dá erro fica marcada como tal, com o motivo — e a leitura seguinte com sucesso limpa a marca automaticamente. Uma avaria que acaba não precisa de um humano para vir desmarcar nada.

Payloads de evento mínimos

O que chega ao seu calendário é o nome do tipo de marcação, o nome e as notas do convidado, e os horários — sem convites a participantes, sem ligações de videoconferência, sem substituir lembretes. Os seus clientes de calendário continuam a mandar no barulho que fazem.

Os conflitos têm uma política declarada

Quando a edição nos dois sentidos chegar, cada fonte já terá uma política de conflitos — reter para um humano (a que vem de origem, e que também suspende os lembretes), ganha a nossa, ou ganha a deles, com a versão perdedora guardada e mostrada. Declarada antes de ser precisa, porque enfiar uma política de conflitos a meio de um incidente é como os dados desaparecem.

Configuração

Como se liga

01

Ligue o Calendário da Apple

Ligue por CalDAV com uma palavra-passe específica da app, criada no seu Apple ID.

02

Defina o papel do calendário

Ler, escrever, as duas coisas, ou só a ocupação — calendário a calendário.

03

Marque por qualquer porta

Painel, IA, flow ou widget do site — todas as portas veem a mesma disponibilidade já subtraída.

Melhor em conjunto

Com o que se combina

O motor de marcações

A disponibilidade, os intervalos de segurança, as janelas de pré-aviso e as reservas à prova de sobreposição vivem no sistema de marcações — o calendário alimenta-o com a verdade.

O Wiz marca com segurança

O agente de IA só oferece horários que sobrevivem à subtração do tempo ocupado — é uma restrição da base de dados, e não uma esperança, que impede a marcação dupla.

Agendas de CRM

Usa o Estesoft Stella? A agenda dele e o seu calendário subtraem-se ambos à mesma disponibilidade — veja a integração com a Stella.

Segurança e garantias

As garantias aborrecidas

Âmbitos mínimos

A ligação pede apenas acesso ao calendário — sem correio, sem contactos, sem drive. Os tokens ficam encriptados em repouso e são renovados automaticamente.

Os seus eventos continuam seus

As leituras de tempo ocupado trazem horários, não conteúdos — a matemática da disponibilidade precisa de saber que está ocupado, não porquê.

Desligar não deixa lixo

Remover uma ligação pára a sincronização de imediato; os eventos já espelhados no seu calendário continuam seus, para manter ou apagar.

As letras pequenas, sem rodeios

Limites, declarados

O registo continua nosso

Ligue os calendários que ligar, o registo de marcações continua a ser a tabela do próprio ConnectWiz — os calendários são espelhos e fontes, nunca o dono. É uma posição de desenho, declarada.

Os lembretes são nossos, não do calendário

Os lembretes das marcações saem do ConnectWiz — por e-mail, e por SMS onde estiver configurado — e não como notificações de calendário, para chegarem a convidados que nunca abriram um convite de calendário. Fica dito, porque dois sistemas de lembretes a disparar é pior do que um.

FAQ do Calendário da Apple

Respostas diretas

Mais respostas no FAQ, ou pergunte-nos diretamente.

As marcações saem como eventos (e são removidas quando canceladas), e o tempo ocupado entra para se subtrair à disponibilidade. Cada fonte tem o seu próprio papel — ler, escrever, as duas coisas, ou só a ocupação.

Não — a disponibilidade é calculada depois de subtrair o tempo ocupado externo, e as reservas sobrepostas são rejeitadas por uma restrição da base de dados que nenhuma porta de marcação consegue contornar.

É a porta que a Apple suporta para o acesso de terceiros a calendários — padrão, estável, e funciona com os calendários do iCloud sem APIs privadas.

Porque a Apple não oferece OAuth para dados de calendário — o CalDAV com uma palavra-passe específica da app é o mecanismo que eles suportam. É um padrão aberto, é revogável a partir do seu Apple ID a qualquer momento, e não expira sem avisar.

Um evento com o título do tipo de marcação, com o nome do convidado e as notas que houver, à hora marcada — criado ao marcar, removido ao cancelar. Não são enviados convites a participantes a partir do seu calendário, e mais nada lá dentro é tocado.

Ligado com honestidade vale mais do que ligado com alarido.

Cada integração aqui está descrita pelo que faz na realidade — direção, propriedade dos dados e limites incluídos.