Saltar para a documentação
Base de conhecimento

Calendários por CalDAV

Mantenha o calendário de um endereço sincronizado com o Apple Calendar, o Thunderbird, o DAVx5 no Android e qualquer outra app CalDAV, com sessão iniciada através de uma palavra-passe de app.

As definições

Uma app de calendário inicia sessão com o mesmo nome de utilizador e a mesma palavra-passe de app que uma app de correio, e chega ao calendário desse endereço.

DefiniçãoValor
Servidorapi.openemail.uk, porta 443, HTTPS
Endereço completohttps://api.openemail.uk/dav/, para as apps que pedem um URL
Nome de utilizadorO endereço completo, como [email protected]
Palavra-passeUma palavra-passe de app para esse endereço, do mesmo tipo que uma app de correio usa
  • As apps de calendário encontram o resto sozinhas: /.well-known/caldav envia-as para /dav/ e, a partir daí, para os calendários do endereço.
  • Ver o calendário requer permissão para o ler, e alterar eventos requer permissão para o alterar.
  • Uma palavra-passe criada através de um link de configuração abre o calendário, além do correio, mas nunca os contactos.
  • O calendário pode ser desligado para um endereço com o respetivo interruptor CalDAV, na vista Servidores do separador Apps de email.
  • Os contactos sincronizam da mesma forma por CardDAV, com o mesmo servidor, nome de utilizador e palavra-passe.

Calendário no iPhone e no iPad

  1. Abra as Definições, depois Aplicações, depois Calendário e depois Contas do Calendário.
  2. Toque em Adicionar conta, depois Outra e depois Adicionar conta CalDAV.
  3. Introduza api.openemail.uk em Servidor, o endereço completo em Nome de utilizador, a palavra-passe de app em Palavra-passe e uma Descrição como Trabalho. Toque em Seguinte.
  4. Deixe Calendários ligado, desligue Lembretes e toque em Guardar.
  • O perfil do separador Apps de email adiciona o calendário e o Mail em conjunto, num só passo.
  • O OpenEmail guarda apenas eventos, por isso os lembretes ficam no dispositivo.

Calendário num Mac

  1. Abra o Calendário e escolha Calendário e depois Adicionar conta.
  2. Escolha Outra conta CalDAV e depois Continuar.
  3. Defina Tipo de conta como Manualmente, introduza o endereço completo em Nome de utilizador, a palavra-passe de app em Palavra-passe e api.openemail.uk em Endereço do servidor, e escolha Iniciar sessão.

Se Manualmente não encontrar nenhum calendário, escolha Avançadas, com Endereço do servidor api.openemail.uk, Caminho do servidor /dav/, Porta 443 e Usar SSL ligado.

Thunderbird

  1. Abra o separador Calendário e escolha Novo calendário.
  2. Escolha Na rede e depois Seguinte.
  3. Introduza o endereço completo em Nome de utilizador e https://api.openemail.uk/dav/ em Localização, e escolha Encontrar calendários.
  4. Inicie sessão com a palavra-passe de app quando for pedida. O Thunderbird lista os calendários do endereço. Marque os que quiser e escolha Subscrever.

Android, com o DAVx5

  1. Instale o DAVx5 a partir do Google Play ou do F-Droid e abra-o.
  2. Toque no botão de mais e escolha Iniciar sessão com URL e nome de utilizador.
  3. Introduza https://api.openemail.uk/dav/ em URL base, o endereço completo em Nome de utilizador e a palavra-passe de app em Palavra-passe, e toque em Iniciar sessão.
  4. Mantenha o endereço completo como nome da conta, que o DAVx5 usa como organizador dos eventos que criar, e toque em Criar conta.
  5. Abra o separador CalDAV da nova conta e marque os calendários a sincronizar. Passam então a aparecer no Google Calendar e em todas as outras apps de calendário do telemóvel.

O DAVx5 sincroniza com o intervalo definido nas definições da conta, e o botão de sincronização sincroniza de imediato.

O que a app de calendário vê

  • Uma app de calendário com sessão iniciada como um endereço vê os eventos que esse endereço organiza ou para os quais foi convidado, e os eventos que criou. As suas subscrições aparecem ao lado como calendários só de leitura.
  • Na app, o calendário chama-se OpenEmail. Cada subscrição mantém o nome que lhe deu, e mudar o nome de uma na app muda-o também no OpenEmail.
  • Os eventos de há cerca de três anos até dez anos à frente ficam sincronizados. Os mais antigos e os mais distantes ficam no OpenEmail.
  • Um evento pode ter até 1 MB. As tarefas e os lembretes não são guardados.
  • As apps que consultam quando as pessoas estão livres podem ver quando outros endereços do espaço de trabalho estão ocupados, até 120 dias de cada vez.
Para as apps que pedemCaminho
Descoberta/.well-known/caldav, que redireciona para /dav/
Principal/dav/principals/{principal}/, em que {principal} é o id do endereço
Pasta inicial do calendário/dav/calendars/{principal}/
Eventos/dav/calendars/{principal}/events/
Subscrições/dav/calendars/{principal}/sub- seguido do id de cada uma, só de leitura

Convites e respostas

  • Convidar pessoas a partir da app de calendário envia convites reais a partir desse endereço, e responder lá a um convite avisa o organizador, tal como fazem os botões do OpenEmail. Alterar eventos requer permissão para alterar o calendário, e enviar convites requer permissão para enviar a partir do endereço.
  • Alterar a hora, o local ou os detalhes de um evento que organizou envia aos convidados uma atualização, e remover um convidado envia-lhe um cancelamento.
  • Eliminar um evento com convidados que organizou cancela-o para todos eles. Eliminar um convite que recebeu recusa-o.

Google Calendar e Outlook

O Google Calendar e o Outlook.com não conseguem iniciar sessão noutro servidor de calendário, por isso dê-lhes antes uma ligação de calendário.

Se não funcionar

  • A app pede a palavra-passe uma e outra vez: o nome de utilizador tem de ser o endereço completo e a palavra-passe uma palavra-passe de app para ele. O OpenEmail responde a esse início de sessão com «Sign in with your email address and an app password from OpenEmail».
  • A app inicia sessão mas não encontra nenhum calendário: confirme que o servidor é api.openemail.uk, e não o domínio do endereço, ou introduza o endereço completo https://api.openemail.uk/dav/.
  • This kind of connection is turned off for this address: o interruptor CalDAV do endereço está desligado. Peça ao proprietário do espaço de trabalho, ou a alguém que gere domínios, que o ligue.
  • Não é possível alterar eventos: a pessoa a quem pertence a palavra-passe pode só ter permissão para ler o calendário, ou o evento pertence a uma subscrição.
  • Revogar a palavra-passe de app termina a sessão da app de calendário em cerca de cinco minutos.