[ajuda] conexões

Agenda do AFK no Google Agenda do zero: senha, link e assinatura por URL

O AFK publica os horários marcados como um calendário no formato iCal (.ics), num link protegido por uma senha que você inventa. No Google Agenda, no computador, você adiciona esse link em Outras agendas → Do URL. É grátis e não precisa de conta de desenvolvedor nem de chave do Google. O Google decide quando lê o link de novo, e o AFK conta com até 1 dia. O link só funciona se a página de agendamento do computador estiver acessível pela internet.

Isso faz parte do AFK, o Claude que você assina já configurado no seu computador. Conhecer o AFK

Para que serve no AFK

Ver os horários no celular: cada agendamento vira um evento com o nome do cliente e o serviço. A descrição traz a situação, o WhatsApp do cliente e a observação.
Tudo num lugar só: os horários do negócio ficam ao lado dos seus compromissos no Google Agenda.
Janela: o link traz de 30 dias atrás até 90 dias à frente. Horário cancelado sai do calendário.

O calendário no Google é só para ver. Marcar, mover e cancelar continua no AFK, na tela Agenda do painel ou na conversa. O aviso na hora de cada agendamento continua chegando no Telegram ou no WhatsApp.

Antes: grátis ou pago

	O que vale
Google Agenda e assinatura por URL	Grátis, com qualquer conta Google.
Conta de desenvolvedor, projeto ou chave do Google	Não precisa.
Endereço público da página de agendamento	Depende de como você põe no ar: túnel com o computador ligado, ou um servidor (VPS), que é pago por mês.
Tempo para aparecer no Google	O Google lê o link quando quer. Pode levar até 1 dia. Não dá para forçar.

Parte 1: deixar a página de agendamento acessível pela internet

O link do calendário sai da página de agendamento que roda no computador do AFK, na porta 3040. O Google lê o link dos servidores dele, pela internet. Então esse endereço precisa existir na internet, com https.

O AFK não abre esse endereço sozinho. O link de agendamento do robô 24 horas, na Cloudflare, não traz o calendário.
Para pôr a porta 3040 na internet, use um túnel, como o Cloudflare Tunnel, que liga o computador à Cloudflare sem abrir porta no roteador. Esse túnel você monta à parte: o AFK ainda não faz essa parte sozinho.
Nunca ponha na internet a porta 3030. Essa é o painel, com os seus dados e as suas chaves. Só a 3040 pode sair.
Com o túnel, o link funciona enquanto o computador está ligado e o túnel, ativo. Com o computador desligado, o Google não consegue ler. Os horários novos chegam quando o Google ler de novo.

Parte 2: criar a senha e colar no AFK

A senha protege o link. Ela precisa ter pelo menos 16 caracteres, só letras e números, sem espaço nem símbolo.

Para gerar uma senha forte, abra o PowerShell e rode:
```
[guid]::NewGuid().ToString('N')
```
Sai uma sequência de 32 letras e números. Copie.
No painel do AFK, abra Conexões, clique no cartão Agenda no seu Google Agenda, cole em Senha do link do calendário e clique em Salvar conexão.
- Esse cartão não tem o botão Testar. O teste é abrir o link (passo 4).

Monte o seu link assim:

https://<endereço público da página de agendamento>/agenda.ics?t=<a senha>

Abra o link no navegador. Se aparecer um texto que começa com BEGIN:VCALENDAR, ou se baixar um arquivo .ics, está certo. Se der "página não encontrada", veja a tabela de erros.

Parte 3: adicionar no Google Agenda

O Google só deixa assinar uma agenda por URL no navegador do computador. No app do celular não dá.

Abra calendar.google.com no computador, com a conta Google em que você quer ver os horários.
À esquerda, ao lado de Outras agendas, clique em + (Adicionar outras agendas) e depois em Do URL. Atalho: calendar.google.com/calendar/r/settings/addbyurl.
Cole o link da Parte 2 e clique em Adicionar agenda.
A agenda aparece à esquerda, em Outras agendas, com o nome do seu negócio. Depois ela aparece também no celular, na mesma conta Google.

Se o link vazar

Quem tem o link vê o nome e o WhatsApp dos seus clientes. Trate o link como senha: não mande por WhatsApp, e-mail ou print.

Crie uma senha nova (Parte 2, passo 1), cole no cartão e clique em Salvar conexão. O link antigo para de funcionar na hora.
No Google Agenda, tire a agenda antiga: clique na engrenagem → Configurações, escolha a agenda à esquerda, clique em Remover agenda, depois em Cancelar inscrição e confirme em Remover agenda.
Adicione o link novo (Parte 3).

Não confunda com o Endereço secreto no formato iCal do Google Agenda (Configurações → a sua agenda → Integrar agenda). Esse faz o contrário: mostra a sua agenda do Google em outro app. O AFK não usa. Se esse endereço vazar, clique em Redefinir ao lado dele: o antigo deixa de valer e o Google cria outro.

No dia a dia

Você quer	Como
Ver os horários do dia no celular	Abra o Google Agenda. Os horários do negócio ficam na agenda com o nome do negócio.
Ver o horário que acabou de entrar	Abra a tela Agenda do painel ou o aviso no Telegram ou no WhatsApp. O Google pode levar até 1 dia.
Marcar, mover ou cancelar	No AFK: tela Agenda do painel ou na conversa ("marca a Ana amanhã às 10h"). Não no Google.
Esconder por um tempo	No Google Agenda, desmarque a caixinha da agenda em Outras agendas.
Trocar a senha	Siga Se o link vazar.

Erros e soluções

O que aparece	O que fazer
O painel recusa a senha ao salvar	A senha tem menos de 16 caracteres, espaço ou símbolo. Use só letras e números.
O link abre "página não encontrada" (`404`)	A senha do link é diferente da salva no cartão, ou o cartão ainda não foi salvo. Confira letra por letra.
O link dá erro `503`	O AFK não conseguiu ler a agenda naquela hora. Abra a tela Agenda do painel e tente o link de novo.
O link não abre fora de casa	O endereço público não está no ar: o computador está desligado, o túnel caiu ou o túnel aponta para a porta errada. Teste no celular com o Wi-Fi desligado.
O Google não aceita o link	O link não abre pela internet ou não começa com `https`. Abra o mesmo link no celular, fora do Wi-Fi, antes de colar no Google.
Não acho Do URL no celular	O Google só deixa assinar pelo navegador do computador.
O horário novo não aparece no Google	É o tempo do Google. Pode levar até 1 dia, e o botão de atualizar não força. O aviso na hora chega pelo Telegram ou pelo WhatsApp.
Mudei o horário no Google e o AFK não mudou	A agenda no Google é só leitura. Mude no AFK.
O horário cancelado sumiu do Google	É assim mesmo: horário cancelado sai do calendário.

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande a senha nem o link completo.

Para entender as conexões em geral, veja O que é chave, quais eu preciso e onde colar.

Fontes oficiais (conferido em 30/10/2026): support.google.com/calendar/answer/37100 (Outras agendas → Do URL → Adicionar agenda; só no navegador do computador; o link precisa ser público) · support.google.com/calendar/answer/37188 (Remover agenda → Cancelar inscrição; Ocultar na lista) · support.google.com/calendar/answer/37648 (Endereço secreto no formato iCal, em Integrar agenda; não compartilhar; Redefinir invalida o antigo) · developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel (o túnel liga o computador à Cloudflare por conexão de saída, sem abrir porta).

ainda não tem o AFK?

Com o AFK, todo horário marcado pelo site, pelo WhatsApp ou por você aparece no seu Google Agenda, no celular, junto com os seus compromissos.

O AFK deixa o Claude que você assina configurado e atualizado no seu computador: painel do negócio, conteúdo, documentos, travas e antivírus prontos. Você fala, o sistema opera. 7 dias de garantia.

Conhecer o AFK

Chaves e conexões

Não resolveu?

Escreva para contato@afk.ia.br com o passo em que você estava, o que apareceu na tela e um print. A lista do que mandar está em travou ou quer sugerir algo.