Assinatura de Calendário iCal

As assinaturas iCal permitem que você conecte calendários somente leitura do Outlook, calendários públicos ou qualquer outro serviço de calendário que forneça um feed iCal. Isso é perfeito para importar programações que você não controla, como calendários de trabalho, programações de equipes esportivas ou calendários de feriados.

O que é uma assinatura iCal?

iCal (abreviação de iCalendar) é um formato padrão para compartilhar informações de calendário. Ao assinar um calendário iCal:

Acesso somente leitura: os eventos são extraídos do calendário automaticamente, mas você não pode modificá-los através do WhenToMeet
Atualizações automáticas: o calendário é sincronizado regularmente para buscar novos eventos e atualizações
Compatibilidade universal: funciona com qualquer serviço de calendário que forneça um URL de feed iCal

Como encontrar o URL da sua assinatura iCal

Calendário do Outlook

Abra o Calendário do Outlook (versão web)
Clique com o botão direito do mouse no calendário que deseja compartilhar
Selecione Configurações ou Compartilhamento e permissões
Procure por Obter link compartilhável ou link ICS
Copie o URL (geralmente começa com https:// e termina com .ics)

Google Agenda (Calendários Públicos)

Abra as configurações do Google Agenda
Selecione o calendário que deseja compartilhar
Role para baixo até Integrar calendário
Copie o Endereço público no formato iCal

Nota: Para calendários privados do Google com acesso total de leitura e escrita, use a conexão nativa do Google Agenda.

Outros Serviços de Calendário

A maioria dos serviços de calendário oferece uma opção de assinatura iCal:

Procure por opções de Assinar, Exportar ou Compartilhar nas configurações do seu calendário
Encontre o URL iCal, ICS ou webcal
Copie o URL completo

Conectando uma assinatura iCal

Navegue até a página Configurações no WhenToMeet
Na seção Calendário, clique em Assinar calendário iCal
Cole o URL da sua assinatura no campo
O URL pode começar com:
- https:// - URL da web seguro padrão
- webcal:// - Protocolo específico do calendário (convertido automaticamente para https)
Clique em Assinar para conectar

O WhenToMeet validará o URL do calendário e buscará eventos para garantir que ele esteja funcionando corretamente.

Formatos de URL suportados

URLs HTTPS: https://example.com/calendar.ics
URLs Webcal: webcal://example.com/calendar.ics (convertido automaticamente)
Arquivos ICS: URLs que apontam para arquivos .ics hospedados em qualquer lugar

Como funcionam as assinaturas iCal

Conexão inicial: Ao se conectar, o WhenToMeet busca todos os eventos do calendário para validar se ele está acessível
Sincronização regular: os eventos são sincronizados automaticamente em intervalos regulares para se manterem atualizados
Detecção de conflitos: os eventos de calendários assinados são usados para verificação de disponibilidade, assim como seus outros calendários conectados
Filtragem de intervalo de datas: Apenas os eventos dentro do seu período de agendamento ativo são buscados para otimizar o desempenho

Solução de problemas

Erro "O calendário requer autenticação"

Este erro significa que o calendário é privado e precisa de credenciais. Para consertar:

Clique em "🔒 Calendário privado? Adicionar autenticação" na caixa de diálogo
Insira seu nome de usuário e senha (consulte Encontrando suas credenciais acima)
Certifique-se de que está usando as credenciais corretas para o serviço de calendário
Tente novamente com a autenticação ativada

Se a autenticação ainda falhar:

Verifique se seu nome de usuário e senha estão corretos
Verifique se o seu serviço requer uma senha específica do aplicativo em vez da sua senha principal
Certifique-se de que o URL do calendário está correto e acessível

Erro "Falha na autenticação"

Se você inseriu as credenciais, mas a autenticação falhou:

Credenciais erradas: verifique novamente seu nome de usuário e senha
Senha específica do aplicativo necessária: alguns serviços (como a Microsoft) exigem senhas específicas do aplicativo
Formato do nome de usuário: tente formatos de nome de usuário diferentes (e-mail vs. nome de usuário)
URL do calendário: verifique se o URL é o URL real do feed do calendário, não um link de página da web

Erro "Nenhum evento encontrado"

Se a assinatura se conectar, mas não mostrar nenhum evento:

Verifique se o calendário realmente contém eventos
Verifique se o URL aponta para um feed de calendário (arquivo .ics), não para uma página da web
Alguns calendários podem fornecer apenas eventos futuros
Tente acessar o URL diretamente no seu navegador para verificar se ele baixa um arquivo .ics

Erro "Tempo limite da conexão"

Se a conexão expirar:

Verifique se o URL está acessível (tente abri-lo no seu navegador)
O servidor do calendário pode estar lento ou temporariamente indisponível
Tente novamente em alguns minutos
Verifique sua conexão com a internet
Alguns servidores auto-hospedados могут иметь ограничение скорости

Formato de URL inválido

Certifique-se de que o URL esteja completo e formatado corretamente
Remova quaisquer espaços ou caracteres extras
Verifique se o URL começa com https:// ou webcal://
Certifique-se de que o URL termina com .ics ou contém um caminho de calendário
Para o NextCloud, certifique-se de que está usando o URL de assinatura, não o URL da interface da web

Autenticação de Calendário Privado

O WhenToMeet suporta Autenticação Básica HTTP para assinaturas de calendário privado que exigem credenciais. Isso permite que você assine calendários privados de serviços como NextCloud, Radicale ou calendários privados do Outlook.

O que é Autenticação Básica?

A Autenticação Básica é um método de autenticação HTTP padrão em que seu nome de usuário e senha são codificados com segurança и enviados com cada solicitação de calendário. Suas credenciais são armazenadas criptografadas no banco de dados do WhenToMeet.

Quando você precisa de autenticação?

Você precisa de autenticação quando:

Calendários privados do Outlook: calendários que não são compartilhados publicamente
Calendários do NextCloud: assinaturas de calendário pessoal que exigem login
Servidores de calendário auto-hospedados: Radicale, Baïkal, SOGo e serviços semelhantes
Feeds iCal privados: qualquer feed de calendário que retorne um erro 401 Não autorizado

A maioria dos calendários públicos (como feeds públicos do Google Agenda ou calendários do Outlook compartilhados publicamente) NÃO precisa de autenticação.

Como usar a autenticação

Na caixa de diálogo de assinatura iCal, clique em "🔒 Calendário privado? Adicionar autenticação"
Insira seu nome de usuário (geralmente seu endereço de e-mail ou nome da conta)
Insira sua senha ou senha específica do aplicativo
Clique em Assinar para conectar

Encontrando suas credenciais

NextCloud

Nome de usuário: seu e-mail/nome de usuário de login do NextCloud
Senha: sua senha do NextCloud ou uma senha específica do aplicativo
URL: Geralmente https://your-nextcloud.com/remote.php/dav/calendars/USERNAME/CALENDARNAME/?export

Calendário Privado do Outlook

Nome de usuário: seu e-mail da conta da Microsoft
Senha: sua senha da conta da Microsoft ou senha específica do aplicativo
URL: Encontre-o no Calendário do Outlook → Configurações → Calendários compartilhados → Publicar calendário → Obter link ICS

Radicale / Baïkal

Nome de usuário: seu nome de usuário do servidor de calendário
Senha: sua senha do servidor de calendário
URL: Fornecido pelo seu servidor de calendário (geralmente termina em .ics ou contém /calendars/)

Senhas específicas do aplicativo

Muitos serviços recomendam o uso de senhas específicas do aplicativo em vez da senha da sua conta principal por segurança:

Microsoft: Gere em account.microsoft.com → Segurança → Senhas de aplicativo
NextCloud: Configurações → Segurança → Criar nova senha de aplicativo

Privacidade e Segurança

Acesso somente leitura: as assinaturas iCal só podem ler eventos, nunca modificar seus calendários
Credenciais criptografadas: as credenciais de autenticação são armazenadas criptografadas no banco de dados
Suporte à autenticação básica: Autenticação Básica HTTP padrão para calendários privados
Proteção SSRF: o WhenToMeet valida todos os URLs para impedir o acesso a redes privadas ou recursos internos
Conexões seguras: todos os URLs webcal:// são atualizados automaticamente para conexões https:// seguras

Diferenças de outros tipos de conexão

iCal vs Google Agenda

iCal: somente leitura, sem necessidade de OAuth, funciona com qualquer calendário público
Google: acesso total de leitura e escrita, autenticação OAuth, pode criar eventos

iCal vs CalDAV

iCal: assinatura simples para acesso somente leitura, suporta autenticação básica opcional
CalDAV: sincronização bidirecional completa com acesso de leitura e escrita, requer suporte do servidor CalDAV

Quando escolher o iCal:

O acesso somente leitura é suficiente
O calendário fornece um URL de assinatura iCal/ICS
A configuração simples é preferida
Funciona com o Outlook, calendários públicos e a maioria dos serviços de calendário

Quando escolher o CalDAV:

Você precisa de acesso de leitura e escrita (criar/editar eventos)
O provedor de calendário suporta o protocolo CalDAV (iCloud, NextCloud, Fastmail)
A sincronização bidirecional completa é necessária

Quando usar o iCal

Use assinaturas iCal quando:

Você deseja importar um calendário público ou compartilhado
Você só precisa de acesso somente leitura para verificar conflitos
O calendário é do Outlook ou de outro serviço sem integração nativa
Você deseja uma configuração simples sem autenticação OAuth
Você tem um calendário privado com suporte à autenticação básica (consulte Autenticação de Calendário Privado)

Requisitos de recursos

As assinaturas iCal estão disponíveis em determinados planos de assinatura. Verifique a página de preços para obter detalhes sobre quais recursos estão incluídos no seu plano.

Documentação Relacionada

Conexão de Calendário - Guia geral de conexão de calendário
Suporte a vários calendários - Gerenciando vários calendários conectados
Acesso e Privacidade do Calendário - Informações de privacidade e segurança