Bem-vindo ao Micali.online

Funções de utilizador

Cada pessoa que interage com o Micali.online enquadra-se numa destas funções. As funções controlam o que cada um pode ver, editar e aprovar.

O que cada função pode fazer

Conta

Uma conta representa uma empresa ou organização proprietária da configuração de reservas — o salão, o estúdio, a clínica. Cada conta tem o seu próprio subdomínio público (por exemplo, yourname.micali.online) onde os visitantes acedem para efetuar uma reserva.

Uma conta contém todos os elementos com que um visitante interage: as subscrições que pode comprar, os serviços e procedimentos que pode reservar, os eventos a que se pode inscrever e os formulários que preenche pelo caminho.

Para onde vão as respostas

Defina um endereço de resposta na conta e todas as mensagens que o Micali.online envia em seu nome passam a usá-lo, para que um visitante que simplesmente responda chegue à caixa de entrada que realmente lê. Deixe-o vazio e as respostas voltam para o endereço a partir do qual o email foi enviado. É uma única definição para todos os seus modelos, não algo a repetir em cada um deles.

Cores

Existem 28 temas de cores. Uma conta escolhe um para todos, e qualquer pessoa pode substituí-lo individualmente — a sua própria escolha prevalece sobre a da conta, e a da conta prevalece sobre a predefinida. Isto altera a aplicação onde trabalha com a sua equipa; não altera o aspeto da sua página pública de reservas.

Eventos

Um evento é um intervalo de tempo — ou uma série de intervalos — para o qual os visitantes se podem inscrever. Utilize os eventos para aulas, sessões em grupo, oficinas, atuações e qualquer outra reserva ligada a uma hora de início fixa.

Eventos modelo vs. eventos clássicos

Os eventos existem em duas variantes:

• Evento modelo — um modelo reutilizável. Os modelos nunca são mostrados aos visitantes; existem para que possa gerar muitos eventos reais com as mesmas definições (capacidade, formulário, mensagens, etc.) sem voltar a introduzir tudo.
• Evento clássico — um evento real e reservável. Um evento clássico pode ser criado de raiz ou ligado a um modelo, caso em que herda a configuração do modelo.

Definições importantes a conhecer

• Capacidade — quantos visitantes podem entrar num lugar e se cada visitante pode levar “amigos” (entidades adicionais). Defina um mínimo e um máximo de participantes. A capacidade é contabilizada em lugares, não em reservas: um visitante que traga dois amigos ocupa três desses lugares.
• Prazo de inscrição — o último momento em que um visitante pode reservar. Se ficar vazio, as reservas permanecem abertas até ao início do evento.
• Confirmação automática — se as reservas são aceites instantaneamente ou aguardam a aprovação do administrador.
• Subscrições permitidas — restrinja quem pode reservar limitando o evento a subscrições específicas. Se deixar este campo vazio, qualquer pessoa pode reservar.
• Lista de espera — quando o evento está esgotado, os novos visitantes podem ser colocados numa lista de espera e notificados automaticamente quando um lugar ficar livre.
• Mensagens — escolha que modelos de mensagens são enviados para a confirmação da reserva, lembretes de pagamento, cancelamentos, lembretes de presença e atualizações da lista de espera. Cada evento tem o seu próprio espaço para cada finalidade, pelo que pode combinar modelos diferentes por evento.
• Pessoa responsável — o membro da equipa a quem pertence o evento. É a pessoa a quem o Micali.online escreve quando algo precisa de atenção, é quem %responsible_person% representa nas suas mensagens, e é pré-selecionada para tratar das conversas sobre o evento. Uma data específica pode indicar outra pessoa, o que permite cobrir a semana de um colega sem alterar o próprio evento.
• Anexos — ficheiros que acompanham o evento, até 8 MB cada. São guardados exatamente como foram carregados: nada é redimensionado ou recortado, pelo que uma planta ou um formulário digitalizado permanece legível.

Serviços e procedimentos

Os serviços destinam-se a reservas individuais nas quais o visitante escolhe uma hora que lhe seja conveniente. Pense num cabeleireiro, numa aula particular, numa consulta ou num tratamento.

Como se relacionam os serviços e os procedimentos

• Um serviço é o contentor — a oferta no seu todo (por exemplo, “Cabeleireiro do centro”). Tem um nome, uma descrição, uma localização, um endereço e um fuso horário.
• Um procedimento é algo específico que pode ser reservado dentro desse serviço (por exemplo, “Corte — 30 minutos”, “Coloração — 90 minutos”). Um serviço pode ter muitos procedimentos.
• A disponibilidade é o calendário das janelas de tempo em que os visitantes podem optar por reservar. Define-se por serviço.
• Intervalo entre horários — determina com que frequência uma reserva pode começar dentro dessas janelas — a cada 5, 10, 15, 20, 30, 60 ou 120 minutos, sendo 15 a predefinição. É uma única definição para todo o serviço: o que é oferecido ao visitante e aquilo em que o pode reservar são a mesma grelha, por isso não pode reservar nada que o visitante não pudesse ter reservado sozinho.

Na página pública, um visitante escolhe primeiro um serviço, depois um procedimento, depois um horário livre — e, por fim, preenche qualquer formulário exigido.

Mensagens automáticas

Cada procedimento pode ser ligado a quatro modelos de mensagens — um para o momento em que a reserva é criada, um para a confirmação, um para a recusa e um lembrete antes da marcação. Escolha os modelos por procedimento para que diferentes serviços possam comunicar com tons diferentes.

Salas

As salas são espaços partilhados que só podem ser reservados pelas pessoas que aprovar — uma sala de reuniões, um estúdio, um posto de trabalho, uma sala de ensaios. Ao contrário de um serviço, o visitante não reserva o seu tempo para algo que oferece; reserva a sala pelo tempo que precisar, dentro das regras que definir.

Quem pode reservar: as etiquetas

Uma etiqueta é um identificador que atribui às pessoas — Funcionários, Direção, Sócios. Uma pessoa pode ter várias etiquetas, e uma sala lista as etiquetas autorizadas a reservá-la; basta ter uma delas. Uma sala sem etiqueta só pode ser reservada pela sua equipa.

Convide pessoas em Salas → Acesso: cole os endereços de email, escolha as etiquetas e envie o convite. Não há palavra-passe — iniciam sessão com um código único enviado para esse endereço.

Um visitante com sessão iniciada que abre uma sala visível que ainda não pode reservar pode pedir acesso. As pessoas responsáveis pela sala aprovam (o que lhe atribui as etiquetas da sala) ou recusam, e o visitante recebe um email em qualquer dos casos.

Para um espaço de coworking, ou uma sala que qualquer pessoa possa usar, mude a sala para Qualquer pessoa que inicie sessão. Tenha em conta que qualquer pessoa pode iniciar sessão com qualquer endereço de email.

Visível ou oculta

Uma sala visível mostra as suas fotos, descrição, capacidade, horários e regras a qualquer pessoa com a ligação, mas a reserva continua a exigir início de sessão e uma etiqueta. Uma sala oculta responde “não encontrado” a todos os que não a podem reservar, por isso mesmo uma ligação divulgada não revela nada. Não existe uma lista pública de todas as salas: as pessoas chegam a uma sala através da sua página de reservas ou da sua própria ligação. Pode alterar a visibilidade diretamente a partir da lista de salas.

Definições principais

• Horários — quando a sala pode ser reservada, por dia da semana, com vários intervalos por dia, se necessário. A sua equipa pode reservar fora destes horários.
• Preparação e limpeza — os minutos em que a sala fica bloqueada antes e depois de cada reserva (0 = nenhum).
• Grelha horária — com que frequência uma reserva pode começar e terminar, por exemplo a cada 15 minutos.
• Regras para visitantes — a reserva mais longa, o intervalo mínimo entre as próprias reservas de uma pessoa (para que duas reservas seguidas de 2 horas não consigam contornar um limite de 2 horas) e com quantos dias de antecedência. Aplicam-se apenas ao que os visitantes reservam por si próprios.
• Confirmar automaticamente — ativado: a reserva é confirmada de imediato. Desativado: aguarda até que uma pessoa responsável a confirme ou recuse.
• Calendário partilhado — desativado, títulos, ou títulos com nomes. Determina o que veem, nos horários ocupados, as pessoas que podem reservar a sala; mais ninguém o vê.
• Pessoas responsáveis — os membros da equipa avisados das novas reservas, dos cancelamentos e dos pedidos de acesso, e que os decidem. Se não escolher ninguém, os administradores são avisados.

Como um visitante reserva uma sala

Na página da sala, o visitante inicia sessão, escolhe um dia no calendário e depois uma hora de início livre — os horários ocupados ficam na grelha, a cinzento — e, por fim, a duração, para que é a reserva e uma nota opcional. Cada passo tem o seu próprio endereço, por isso voltar a carregar a página mantém a posição. As suas reservas de salas aparecem em As minhas reservas, onde pode cancelar até a reserva começar.

Gerir as reservas de salas

Salas → Calendário mostra a semana de uma sala ou de todas, com as reservas à espera de confirmação no topo. Clique numa hora livre para reservar em nome de alguém (por email) ou para bloquear a sala internamente; clique numa reserva para a confirmar, recusar, mover, renomear ou cancelar. As suas próprias reservas ignoram as regras para visitantes e os horários, mas nunca podem sobrepor-se a outra reserva. Uma reserva pode repetir-se todos os dias úteis, todas as semanas ou de duas em duas semanas durante até um ano — as datas já ocupadas são ignoradas e apresentadas numa lista. A página Visitantes tem um separador Salas com as reservas de cada sala, e a lista Todos os visitantes mostra as etiquetas de todos.

Mensagens automáticas

Cada sala escolhe qual o modelo de mensagem enviado e quando: a reserva aguarda confirmação, é confirmada (com um ficheiro de calendário anexado), é recusada, é cancelada pelo visitante, é cancelada por si, é movida para outra hora, e um lembrete um determinado número de horas antes. A sua primeira sala recebe modelos já prontos que pode editar.

Subscrições

Uma subscrição é um plano pré-pago que um visitante adquire — um cartão de carimbos, uma assinatura mensal, um passe de época. Utilize as subscrições para faturar antecipadamente e para controlar quem está autorizado a reservar determinados eventos.

O que define uma subscrição

• Preço e moeda — o que o visitante paga.
• Limites de utilização — número máximo de utilizações e/ou duração máxima em dias. Deixe um limite vazio, ou defina-o como 0, e conta como ilimitado.
• Janela de disponibilidade — quando a subscrição pode ser comprada (available_from e, opcionalmente, available_to).

Como as subscrições filtram o acesso aos eventos

Por si só, uma subscrição é apenas um produto que os visitantes podem comprar. Para a usar como filtro, ligue-a a um ou mais eventos como subscrição permitida. A partir daí, apenas os visitantes que possuam essa subscrição poderão reservar o evento.

Por predefinição, um crédito só é gasto depois de alguém confirmar que o visitante compareceu de facto — o lugar aguarda o interruptor presente na lista de visitantes. Duas definições podem dispensar essa confirmação, a dois níveis diferentes: o plano pode indicar que esta subscrição consome sempre um crédito, e um evento específico pode indicar que este evento consome um crédito mesmo sem comparência. Basta que uma delas esteja ativa.

Assim, uma falta de comparência custa um crédito ao visitante quando o plano ou o evento assim o determinam, e não custa nada quando nenhum deles o faz — nesse caso, o crédito fica simplesmente pendente até que um administrador marque o visitante como presente.

Acompanhar a subscrição de um visitante

Abra a subscrição de um visitante e obtenha a lista de todas as reservas que já gastaram um crédito dela, com a data em que cada uma foi contabilizada. Quando alguém perguntar porque tem três visitas restantes em vez de quatro, essa lista é a resposta.

Também pode alterar a quota dessa pessoa sem tocar no plano em que todos os outros estão — ofereça uma aula de substituição depois de um cancelamento, ou corrija um erro de contagem. Defina o número inicial, ou some e subtraia à medida que avança; cada alteração fica registada com quem a fez, para que um saldo ajustado possa sempre ser explicado mais tarde.

Como uma subscrição é utilizada

Quando um visitante com uma subscrição válida reserva algo coberto por essa subscrição, ela é aplicada automaticamente — o visitante não precisa de se lembrar de a escolher, nem é preciso associá-la depois. Aplicá-la não é o mesmo que gastá-la: o crédito é reservado nesse momento e só é contabilizado assim que a comparência for confirmada, de acordo com as regras descritas acima.

Mensagens automáticas de subscrição

As subscrições podem acionar quatro modelos de mensagens:

• Após cada utilização — confirma que foi gasto um crédito e quantos restam.
• Antes da data de fim — um aviso prévio um número configurável de dias antes de a subscrição expirar.
• Ao expirar — enviada quando a subscrição termina.
• Poucas utilizações restantes — enviada quando os créditos restantes do visitante caem abaixo de um limite que o senhor defina.

Formulários

Um formulário é o conjunto de perguntas que um visitante responde ao efetuar uma reserva. Crie-o uma única vez e associe-o onde precisar das respostas — um evento, um serviço, uma subscrição ou cada participante individual de uma reserva.

O que pode perguntar

Cada campo tem uma etiqueta, um tipo e um nome interno. Os tipos disponíveis são:

Texto e texto multilinha, número, escolha (botões de opção ou lista pendente), e data, hora ou data e hora.

Formulários para cada participante

Quando uma reserva pode incluir acompanhantes, um evento pode pedir os dados de todos os participantes, e não apenas da pessoa que reserva. Esse formulário tem de conter um campo chamado name — é o que identifica cada participante nas suas listas.

Os visitantes recorrentes não voltam a escrever tudo

Quando alguém que já respondeu a um formulário reserva novamente, as suas últimas respostas a esse mesmo formulário são preenchidas automaticamente. A correspondência é feita pelo formulário, não pelo local onde respondeu — por isso, dois eventos que partilham um formulário preenchem-se um a partir do outro, e a resposta mais recente prevalece sempre.

Uma resposta antiga só é reutilizada se ainda se adequar ao campo tal como está definido hoje. Um campo que entretanto foi removido ou renomeado, uma opção que já não consta da lista, um número agora fora do intervalo — tudo isso fica vazio em vez disso. Manter esse valor silenciosamente seria pior do que deixá-lo em branco: o visitante não veria nada na caixa, mas a resposta desatualizada seria mesmo assim submetida.

Modelos de mensagens

Um modelo de mensagem é um texto reutilizável que a plataforma envia aos visitantes no momento certo — confirmação de reserva, lembrete de pagamento, lembrete de presença, aviso de expiração, etc. Defina um modelo uma única vez ao nível da conta e referencie-o em cada evento, procedimento de serviço ou subscrição que o deva utilizar.

Um modelo, três canais

Cada modelo tem espaços para uma versão em email (assunto + corpo), uma versão em SMS (assunto + corpo) e uma notificação push (título + corpo). Preencha um, dois ou os três — pelo menos um deles tem de estar presente ao gravar.

O que deixar em branco simplesmente não é utilizado:

• Se o corpo do email estiver vazio, não é enviado nenhum email quando este modelo é acionado.
• Se o corpo do SMS estiver vazio, não é enviado nenhum SMS quando este modelo é acionado.
• Se o corpo da notificação push estiver vazio, não é enviada nenhuma notificação push quando este modelo é acionado.

Além do texto, cada modelo tem um interruptor enviar email e um interruptor enviar SMS, ambos ligados por predefinição. Desligar um deles mantém o texto exatamente como foi escrito, mas impede que esse canal seja enviado — útil para pausar o SMS durante um mês sem ter de o reescrever depois. Pode alterná-los diretamente a partir da lista de modelos. O push não tem interruptor: é sempre enviado quando o modelo tem texto de push, porque é o único canal que chega a um visitante que não forneceu nem um endereço de email nem um número de telefone.

Um canal também precisa de um destino para onde chegar. O email é ignorado para um visitante sem endereço de email, e o SMS para um visitante sem número de telefone, independentemente da posição dos interruptores.

Marcadores que pode utilizar

Os modelos suportam variáveis simples que são substituídas por dados reais no momento do envio. Pode colocar qualquer um destes no assunto ou no corpo, em qualquer dos canais:

Os marcadores que não se aplicam a uma determinada mensagem (por exemplo, %event_name% num lembrete de serviço) são simplesmente deixados vazios.

Onde os modelos são utilizados

Na maior parte das vezes, um modelo é utilizado automaticamente pela entidade que aciona a mensagem. Aqui está a lista completa de espaços.

Num evento

• Reserva criada — enviada no momento em que um visitante submete uma reserva.
• Confirmação — enviada quando a reserva é confirmada (manual ou automaticamente).
• Confirmação de primeira vez — enviada em vez da confirmação habitual quando esta é a primeira reserva do visitante para o evento, para que os novos participantes recebam as boas-vindas mais calorosas do que os habituais.
• Pagamento em falta — lembrete de pagamento, com uma ou duas antecedências configuráveis (primeiro e segundo lembrete, em horas antes do evento).
• Lembrete de presença — enviado um número configurável de horas antes do evento.
• Cancelamento — enviado quando o visitante cancela.
• Cancelamento pela conta — enviado quando um administrador cancela a reserva do visitante.
• Lista de espera — adicionado — enviada quando o visitante é colocado na lista de espera.
• Lista de espera — promovido — enviada quando um lugar fica livre e o visitante fica autorizado a reservar.

Num procedimento de serviço

• Reserva criada — enviada quando o visitante submete o pedido.
• Confirmação — enviada quando a marcação é aprovada.
• Confirmação de primeira vez — enviada em vez da confirmação habitual quando esta é a primeira reserva do visitante para o serviço.
• Recusa — enviada quando o pedido é rejeitado.
• Lembrete — enviado antes da marcação.

Numa subscrição

• Após cada utilização — enviada sempre que é gasto um crédito.
• Antes da data de fim — enviada um número configurável de dias antes de a subscrição expirar.
• Ao expirar — enviada quando a subscrição atinge a sua data de fim.
• Poucas utilizações restantes — enviada quando o número de créditos restantes cai abaixo do limite que o senhor definir.

AI

O Micali.online pode responder às suas perguntas sobre a aplicação, ajudá-lo a escrever e gerar as mensagens que os seus visitantes recebem. Tudo isto é opcional e nada é enviado a um visitante sem que o veja primeiro.

Perguntar à AI

Um assistente dentro da aplicação que conhece tanto o funcionamento do Micali.online como o conteúdo da sua própria conta, para que possa perguntar “como impeço que este evento apareça publicamente?” ou “quais das minhas subscrições expiram este mês?” e obter uma resposta sobre a sua configuração. A conversa é privada da sua conta e é guardada durante sete dias.

Os administradores também podem pedir-lhe que faça coisas: criar um evento ou um serviço, adicionar datas ou horários de funcionamento, criar um plano de subscrição, um formulário ou um questionário — e trabalhar com reservas. «Inscrever a Ana na ioga de sexta-feira», «marcar o sábado do Pedro como pago», «mudar a massagem das 10 para as 15h» ou «cancelar a reserva da Eva na segunda-feira». Um novo visitante pode ser inscrito apenas com o e-mail. Nada acontece de imediato: o assistente mostra o que está prestes a fazer num cartão, e só o seu Confirmar o aplica. Os visitantes recebem as mesmas mensagens que receberiam se o fizesse na aplicação, a menos que peça para não os avisar.

Que AI faz o trabalho

Um administrador raiz escolhe a ligação em AI, nas definições da conta. Há duas formas de a executar:

• A sua própria chave — cole uma chave de API do ChatGPT ou do Gemini. Paga diretamente ao seu fornecedor, e o Micali.online não cobra nada por isso.
• Incorporada — utilize a própria ligação do Micali.online, sem nada a configurar.

Uma chave que cola é guardada apenas para escrita: a aplicação mostra-lhe uma pré-visualização mascarada e pode revelá-la de novo, mas nunca é fornecida através da API. Pode testar a ligação antes de gravar e ver quanto já utilizou.

Assistente de escrita

Junto à maioria das caixas de texto mais longas — a descrição de um evento ou serviço, a descrição do seu negócio, uma resposta de chat a um cliente — encontram-se dois botões. Aperfeiçoar melhora o que já escreveu; Gerar escreve um primeiro rascunho a partir de um breve resumo. Ambos mostram o resultado numa caixa de diálogo para aceitar ou rejeitar, pelo que nada é substituído silenciosamente.

Mensagens aos visitantes escritas por AI

Um modelo de mensagem pode conter uma instrução em vez de um texto fixo, em qualquer um dos seus canais. O texto é então escrito de novo no momento do envio, a partir da instrução e dos dados dessa reserva, para que cada visitante receba algo específico em vez de uma frase única com o nome inserido.

Mantenha também o texto estático preenchido. É a alternativa de recurso: se a geração falhar, ou se a conta não tiver ligação de AI, é enviado o texto estático e o visitante nunca dá por isso.

Claude & ChatGPT (MCP)

O Micali.online executa um servidor MCP. Ligue-o uma vez ao Claude ou ao ChatGPT e pode perguntar sobre as suas reservas em linguagem corrente — «quem não pagou para sábado?» — sem sequer abrir a aplicação. O assistente funciona com a sua própria subscrição de AI, vê apenas o que pode ver por si próprio, e pode ser desligado do seu perfil a qualquer momento.

Como ligar

Quatro passos, cerca de um minuto, e no final não fica nenhuma chave nem palavra-passe esquecida em lado nenhum.

1. Copie o endereço

   Na aplicação, abra Perfil → Ligações AI e copie o endereço com o botão Copiar. É https://mcp.micali.online — o endereço completo, sem nada a seguir.

2. Adicione-o como conetor personalizado

   No Claude ou no ChatGPT, abra as definições de conetores e adicione um novo conetor personalizado, colando esse endereço como o seu URL. Não é preciso mais nada — nem chave de API, nem id de cliente, nada a registar previamente connosco. Qualquer outra coisa que fale MCP liga-se da mesma forma: Claude Code, Codex, Cursor.

3. Escolha gestor ou convidado, e depois inicie sessão

   Abre-se a nossa própria página de início de sessão. Escolha Gestor para trabalhar numa conta que gere, ou Convidado para ver as suas próprias reservas. Introduza o endereço de email que já usa no Micali.online e o código de 6 dígitos que chega. É o mesmo início de sessão que na aplicação: o assistente nunca vê o seu código, e nunca lhe entrega uma palavra-passe.

4. Pergunte alguma coisa

   O conetor aparece na lista de ferramentas do assistente e já está pronto. Uma boa primeira pergunta é uma pergunta simples: «o que tenho esta semana, e quem ainda não pagou?»

O que pode perguntar como gestor

O assistente dispõe de cinquenta e três ferramentas e escolhe entre elas por conta própria, por isso não há comandos para aprender. O que vale a pena conhecer é o esboço do que consegue alcançar:

• Eventos e datas — a lista, com o quanto cada data está preenchida, e toda a configuração de um evento: capacidade, prazos, pagamento, confirmação.
• Reservas — quem está inscrito numa data, com os dados de contacto e o estado confirmado / pago / compareceu. Pode ser filtrado a uma única data, ou apenas às que não estão pagas ou confirmadas.
• Lista de espera — quem está em fila para um lugar livre, começando por quem espera há mais tempo.
• Visitantes — pesquise por nome, email ou telefone, e depois o perfil de uma pessoa com as suas subscrições e reservas recentes.
• Planos de subscrição — o que vende, a que preço, com que limite, e quantas pessoas têm um neste momento.
• Serviços e marcações — o que oferece, e quem tem uma marcação reservada num determinado período.
• Salas — as salas e quem as pode reservar, as reservas num período e as que aguardam confirmação, as etiquetas de acesso e as pessoas que as têm, e os pedidos de acesso. Também pode configurar uma sala, reservá-la para alguém uma vez ou repetidamente, confirmar, recusar, mover ou cancelar uma reserva, atribuir uma etiqueta a alguém através de um convite, e aprovar um pedido.
• Formulários de reserva — as perguntas extra a que os visitantes respondem, campo a campo, e a criação ou reescrita de um a partir de uma descrição.
• Questionários de feedback e os seus resultados — o inquérito enviado depois de um evento ou de uma marcação, a pontuação de cada pergunta, e cada resposta individual com quem a deu e sobre o que era.
• Reservas por confirmar — visitantes que preencheram o formulário mas nunca clicaram na ligação do seu email, e a confirmação de uma em seu nome.
• As pessoas que gerem a conta — quem são e que função têm, convidar alguém, alterar uma função, removê-lo.
• A própria configuração da conta — nome, dados de contacto, endereço, fuso horário, idioma, formatos, subdomínio de reservas, ligações sociais.
• Inscrever visitantes e alterar reservas — colocar um visitante numa data de um evento, na sua lista de espera ou numa hora livre de marcação (um novo visitante só com o e-mail), confirmar, marcar como paga ou com presença, adicionar uma nota e mudar uma reserva para outra data ou hora.
• Cancelar uma reserva em nome de um visitante — a de um evento ou uma marcação.
• Criar e alterar o que oferece — eventos e as suas datas, serviços, planos de subscrição, formulários, questionários. Não só ler a configuração, mas também escrevê-la: «monte um curso para principiantes, às segundas-feiras às seis, durante oito semanas, doze lugares» é um único pedido.

Trinta das cinquenta e três só leem; vinte e três podem alterar algo. A diferença importa porque o seu assistente pergunta antes de executar qualquer coisa do segundo grupo, e nunca pergunta para o primeiro — assim as perguntas mantêm-se rápidas e as alterações mantêm-se deliberadas.

Na prática, responde a perguntas como «quantos lugares estão livres para a próxima semana?», «ainda lhe restam visitas no passe?», «quem faltou à aula de sexta-feira passada?», «marcar o sábado do Pedro como pago», «inscrever a Ana na ioga de sexta-feira», «adicionar mais três datas ao curso de terça-feira», «o que disseram as pessoas nos questionários do mês passado?». Encontra a conta, o evento e a reserva sozinho — nunca precisa de indicar um identificador.

O que pode perguntar um visitante

Os visitantes ligam-se exatamente da mesma forma, escolhendo Convidado na página de início de sessão, e obtêm cinco ferramentas próprias:

• as organizações em que estão registados,
• as suas próprias reservas — eventos, marcações e reservas de salas, as futuras por predefinição,
• as suas subscrições, com as visitas utilizadas e as que ainda restam,
• uma pesquisa de datas que podem reservar, incluindo quantos lugares estão livres,
• cancelar a sua própria reserva — uma reserva de evento respeitando o prazo definido pelo organizador, uma reserva de sala a qualquer momento antes de começar.

Como desligar

Um acesso que não pode retirar com um único botão não é um acesso que valha a pena conceder. Todas as ligações aparecem listadas no seu perfil com o dia em que foram feitas e quando foram usadas pela última vez.

1. Abra a lista

   Perfil → Ligações AI, o mesmo lugar onde está o endereço. Os visitantes têm a mesma secção no seu próprio perfil.

2. Prima Desligar

   O botão Desligar junto ao assistente que quer cortar, e depois confirme na caixa de diálogo.

3. Desaparece de imediato

   Esse conetor perde o acesso de imediato. Tudo o resto fica intacto — a aplicação no seu navegador continua com sessão iniciada, tal como qualquer outro assistente que tenha ligado. Pode voltar a adicionar o mesmo mais tarde; basta que volte a passar pelo início de sessão.

Uma ligação de que se esquece termina sozinha. O token de acesso dura cinco horas e o assistente renova-o silenciosamente, mas a renovação para ao fim de 90 dias.

O que o assistente deliberadamente não pode fazer

Deixar uma AI aceder a dados de visitantes é uma decisão que merece limites visíveis. Estes são os nossos.

• Nunca vê mais do que você vê. Cada chamada volta a verificar que realmente administra essa conta. Não existe nenhuma «conta atualmente aberta» em que se possa apoiar, e por isso não há forma de o convencer a aceder aos dados de outra pessoa.
• Os membros da equipa estão desativados por agora. Um membro da equipa vê apenas os eventos e serviços que lhe estão atribuídos, e esse limite teria de ser reconstruído separadamente dentro de cada uma das cinquenta e três ferramentas. Até estar implementado, o conetor recusa o seu início de sessão com um motivo claro, em vez de entregar uma visão a meio caminho.
• Tudo o que não pode ser desfeito é declarado destrutivo. O protocolo permite que cada ferramenta indique se apenas lê e se o seu efeito pode ser desfeito, e o Claude e o ChatGPT perguntam-lhe antes de executar qualquer coisa do segundo grupo. Cancelar uma reserva está marcado como destrutivo — elimina a linha, envia uma mensagem ao visitante e oferece o lugar libertado à primeira pessoa da lista de espera — e o mesmo acontece com eliminar um evento, um serviço, um plano, um formulário ou um questionário, e remover alguém da conta. Essas ferramentas também instruem o assistente a repetir-lhe por palavras o que está prestes a desaparecer, e a aguardar um sim explícito.
• Obedece às mesmas regras que você. As ferramentas que alteram algo não têm a sua própria versão das regras — executam exatamente o mesmo código que a aplicação executa quando você clica no botão. Por isso, um administrador que não seja administrador raiz também não pode mudar o nome do negócio através do assistente, ninguém pode remover o seu próprio acesso, eliminar um evento continua a avisar todos os que têm uma reserva nele, e um novo gestor continua a receber o email de convite habitual.
• Nunca vemos a sua conversa. O assistente funciona com a sua subscrição e fala consigo diretamente. Do nosso lado, vemos apenas as chamadas individuais às ferramentas que vão chegando — o mesmo que veríamos se estivesse a clicar na aplicação. O texto das suas perguntas e das respostas nunca chega até nós.

Público vs. Ativo — o que significa cada indicador

Os eventos, serviços e subscrições partilham dois interruptores ligar/desligar. Parecem semelhantes, mas respondem a duas perguntas diferentes.

Combinações e o que significam

Webhooks

Os webhooks permitem que o Micali.online notifique os seus próprios sistemas no momento em que algo acontece dentro de uma conta — um novo visitante, uma reserva, um pagamento de subscrição. Configure um ou mais URLs de escuta por conta, escolha os eventos que lhe interessam e o Micali.online envia um payload JSON para cada URL sempre que estes são despoletados. Perfeito para sincronizar reservas num CRM, despoletar automações a jusante ou criar dashboards sobre os dados das suas reservas.

Quem os pode configurar

Apenas os root admins podem criar, editar e eliminar os listeners de webhook. Os admins e os membros da equipa não os conseguem ver nem alterar. Os webhooks estão junto às outras integrações — abra Conectores → Webhooks para os gerir.

Eventos a que pode subscrever

Cada listener está associado a um único tipo de evento. Adicione vários listeners — mesmo apontando para o mesmo URL — para receber mais do que um tipo de evento. O catálogo de eventos atualmente emitidos é:

• visitor.created — um visitante foi adicionado à conta: registou-se ou reservou, ou a equipa adicionou-o ou importou-o.
• visitor.updated — o nome ou o telefone de um visitante mudou, ou a equipa editou as notas do visitante.
• event_booking.created — foi feita uma reserva de evento — pelo visitante, pela equipa ou ao passar alguém da lista de espera.
• event_booking.confirmed — uma reserva de evento está confirmada: quando alguém a confirma, ou logo a seguir a created quando foi confirmada automaticamente.
• event_booking.rescheduled — uma reserva de evento foi movida para outra data ou outro evento, ou a sua data foi movida ou fundida com outra. data.previous contém o evento, a data e a hora que tinha antes.
• event_booking.cancelled — uma reserva de evento foi cancelada pelo visitante ou pela equipa (data.cancelled_by indica qual).
• service_booking.created — foi feita uma reserva de serviço. Vários serviços reservados de uma só vez enviam um webhook cada, com o mesmo booking_group_id.
• service_booking.confirmed — uma reserva de serviço está confirmada: quando alguém a confirma, ou logo a seguir a created quando foi aceite automaticamente.
• service_booking.rescheduled — uma reserva de serviço foi movida para outro horário. As reservas feitas em conjunto movem-se em conjunto, cada uma enviando o seu próprio webhook; data.previous contém o horário anterior.
• service_booking.cancelled — uma reserva de serviço foi cancelada ou eliminada.
• room_booking.created — foi reservada uma sala para um visitante, pelo visitante ou pela equipa (uma série envia um por data).
• room_booking.confirmed — uma reserva de sala está confirmada: quando a equipa a aprova, ou logo a seguir a created quando não é necessária aprovação.
• room_booking.rejected — a equipa recusou um pedido de reserva de sala.
• room_booking.rescheduled — uma reserva de sala foi movida para outro horário; data.previous contém o início e o fim anteriores.
• room_booking.cancelled — uma reserva de sala foi cancelada pelo visitante ou pela equipa.
• membership.assigned — foi atribuída uma subscrição a um visitante, ou um visitante pediu para comprar uma.
• membership.paid — uma subscrição de visitante foi marcada como paga.
• membership.ended — uma subscrição de visitante terminou: a data de fim passou (data.ended_reason = expired) ou a equipa removeu-a (removed).

O que é enviado

Cada entrega é um único POST HTTP para o seu URL com um corpo JSON. Os seguintes cabeçalhos acompanham sempre o pedido:

• Content-Type: application/json — o corpo está sempre codificado em JSON.
• User-Agent: micali-webhooks/1.0 — identifica o remetente.
• X-Micali-Event: <event_type> — repete o tipo de evento para que possa encaminhar sem ler o corpo.
• Authorization — presente apenas quando configura autenticação no listener (ver abaixo).

Forma do payload

Todos os payloads partilham o mesmo envelope:

• event — o tipo de evento (mesmo valor do cabeçalho X-Micali-Event).
• occurred_at — carimbo de data/hora ISO-8601 de quando o gatilho foi executado.
• resource — o tipo de objeto dentro de data: visitor, event_booking, service_booking, room_booking ou visitor_membership.
• data — um instantâneo do recurso, incluindo o seu ID público, o estado atual e o ID público e os contactos do visitante (e-mail, primeiro e último nome, telefone). As reservas de eventos incluem também lugares, acompanhantes, o evento e a data; as reservas de serviços o serviço, o procedimento e booking_group_id; as reservas de salas a sala, o estado e a série; os payloads de subscrição o nome da subscrição e o ID público.

Identifique os objetos entre entregas pelo seu public_id — é o identificador estável e partilhável que usamos em todo o resto da plataforma.

Autenticação

Escolha um esquema de autenticação para que o seu recetor possa verificar que o pedido vem do Micali.online:

• Nenhuma — nenhum cabeçalho Authorization é enviado. Use apenas quando o seu endpoint estiver protegido de outra forma (URL assinado, lista de IPs permitidos, rede privada).
• Basic — o nome de utilizador e a palavra-passe são enviados como o cabeçalho padrão Authorization: Basic ....
• Token Bearer — o token que fornece é enviado como Authorization: Bearer <token>. Armazenado encriptado em repouso e nunca devolvido pela API depois de guardado.

Entrega e novas tentativas

A entrega é assíncrona e passa pela fila de tarefas em segundo plano da plataforma. Se o recetor devolver um estado não-2xx (ou o pedido falhar por completo), a tarefa tenta novamente com backoff exponencial — começando em 60 segundos, duplicando de cada vez e com um limite de uma hora entre tentativas. Após dez tentativas falhadas, a entrega é marcada como falhada e descartada. Listeners que sejam desativados ou eliminados entre o gatilho e a entrega real são ignorados silenciosamente.

Primeiros passos

A forma mais rápida de passar de uma conta vazia para uma página pronta a reservar é deixar que o assistente de configuração a construa por si.

O assistente de configuração

A um administrador raiz de uma nova conta é oferecido um assistente que pergunta sobre o negócio em linguagem simples — o que oferece, se as pessoas vêm em grupo a uma hora fixa ou reservam o seu próprio horário, quanto tempo demoram as coisas, quando está aberto, quem trabalha consigo — e depois cria toda a configuração de uma só vez: os serviços e os seus procedimentos, o horário de funcionamento, os eventos e as suas datas, o nome e a categoria do seu negócio, o seu subdomínio público, o seu endereço no mapa, se as reservas precisam de aprovação, que lembretes são enviados, e os convites para a sua equipa.

Não precisa de terminar de uma só vez. As suas respostas vão sendo guardadas, por isso, se fechar o separador e voltar mais tarde, retoma onde parou. Também pode dispensar o assistente por completo e construir tudo à mão — é oferecido uma vez, não é obrigatório.

O que verificar depois

O assistente deixa tudo ligado e pronto, mas vale a pena verificar duas coisas antes de enviar o link a alguém: abra o seu subdomínio público numa janela privada do navegador para ver exatamente o que um visitante vê, e reveja os modelos de mensagens que ele criou, para que o tom soe a si.

Se começou numa demonstração

A demonstração que pode abrir a partir do site sem se registar é uma conta real e funcional com uma vida curta — é eliminada assim que expira, juntamente com tudo o que configurou nela. Mantenha-a e ela transforma-se numa conta normal, com tudo o que já construiu. Se passou uma noite a organizar a sua semana numa demonstração, faça-o antes de fechar o separador.

Para a manter, prima Manter esta conta. O botão está na barra âmbar no topo de cada ecrã, em Conta e em Utilizadores da conta, onde cada gestor com um endereço de email real também tem Tornar administrador e manter a conta no menu da sua linha. Escolha quem vai ficar com a conta — alguém que já esteja na equipa ou outro endereço —, decida se quer manter o negócio de exemplo ou começar vazio, e introduza o código de 6 dígitos enviado para a caixa de entrada do proprietário. Nada muda enquanto esse código não for introduzido. A partir daí a conta nunca expira, e o proprietário é o seu administrador raiz e inicia sessão com esse endereço.

Iniciar sessão

Ninguém no Micali.online tem palavra-passe. Todos iniciam sessão com um código enviado para o email, e os gestores podem ainda acrescentar uma forma mais rápida.

Gestores

Introduza o seu endereço de email e chega-lhe um código curto por email. Digite-o e fica com sessão iniciada durante essa sessão. Se se dirigia a um local específico — um link de uma notificação, por exemplo — chega a essa página em vez de ao painel.

O PIN de 4 dígitos

Depois de iniciar sessão, pode definir um PIN para o navegador que está a utilizar. A partir daí, esse navegador só pede os quatro dígitos em vez do código enviado por email, durante 30 dias. É por navegador: definir um PIN no seu telemóvel não faz nada pelo seu portátil.

Três tentativas erradas e o navegador deixa de ser considerado de confiança — volta a pedir um código por email, e o PIN sozinho não chega para entrar. Os 30 dias contam a partir do momento em que o definiu e não são prolongados por o utilizar.

Adicione-o ao ecrã principal

Tanto a aplicação de gestores como a página de reservas dos seus visitantes podem ser adicionadas ao ecrã principal de um telemóvel, onde abrem como uma aplicação. É também isto que torna possíveis as notificações push nos iPhones — aí, as notificações só funcionam depois de a página ter sido adicionada ao ecrã principal.

Visitantes

Os visitantes iniciam sessão da mesma forma, com um código para o seu email, no seu próprio subdomínio. Um visitante que nunca tenha reservado consigo antes é simplesmente criado na hora, na primeira vez que inicia sessão.

Painel

O primeiro ecrã depois de iniciar sessão, em três vistas. Os separadores recordam qual escolheu, por isso escolha o que melhor se adapta à sua forma de trabalhar.

• Calendário — uma semana completa disposta numa grelha, com cada horário de evento e serviço no seu lugar e os que se sobrepõem lado a lado. Pode percorrer as semanas e tornar as linhas mais altas ou mais baixas para caber num dia preenchido.
• Agenda — uma lista simples do que está para vir, um horário após o outro. É a que funciona melhor num telemóvel.
• Visão geral — cartões-resumo: o que vem a seguir, o que precisa de confirmação, respostas recentes a formulários.

Trabalhar diretamente a partir do calendário

Clicar num horário no calendário faz mais do que abri-lo. Num horário com lugares disponíveis, pode reservar logo ali um visitante. Um horário futuro pode ser aberto, partilhado ou movido para outro dia ou hora; um vazio também pode ser removido por completo se não o estiver a realizar.

Gerir reservas

Tudo o que acontece depois de um visitante se inscrever: adicionar pessoas você mesmo, aprová-las, movê-las e registar quem realmente compareceu.

Adicionar alguém você mesmo

Nem todas as reservas chegam através da página pública — há pessoas que telefonam, ou o apanham pessoalmente. Adicione-as pelo endereço de email: se esse endereço já for de um dos seus visitantes, fica associado a essa pessoa, e se for novo, o visitante é criado. Pode definir quantos lugares ocupam, adicionar os seus amigos, e preencher as respostas ao formulário em nome deles.

Aprovar e recusar

Se o evento ou procedimento não confirmar automaticamente, as novas reservas ficam à sua espera. Aprovar uma envia a mensagem de confirmação; recusar envia a mensagem de recusa, quando o procedimento tiver uma definida. Uma reserva feita por alguém sem reservas anteriores pode enviar uma mensagem diferente, mais calorosa, do que a que os seus habituais recebem.

Mover uma reserva

Os planos mudam, e um visitante não devia ter de cancelar e voltar a reservar. Uma reserva de evento pode ser movida para outra data do mesmo evento ou para um evento totalmente diferente; uma reserva de serviço pode ser movida para outro horário ou outro procedimento. A capacidade no destino é verificada de novo no momento da mudança, e o lugar que fica livre vai para quem estiver em primeiro lugar na lista de espera. Também pode mover uma data completa do evento, e todos os que têm reserva nela vão junto: clique no horário no calendário ou use o botão para mover no calendário do evento. Se houver alguém com reserva, o Micali pergunta se deve enviar-lhe a mensagem de “reserva movida” com a hora antiga e a nova. E se o evento já tiver uma data marcada para essa nova hora, escolhe entre juntar as duas datas, em que todos os que têm reserva ou estão na lista de espera passam para a data existente e esta é removida, ou manter as duas datas separadas à mesma hora. A junção não volta a verificar a capacidade, e é recusada se houver alguém com reserva nas duas datas.

Marcar quem compareceu

Depois de uma data ter começado, cada reserva confirmada faz uma pergunta: esta pessoa veio? Responder não é apenas um registo. Presente é o que gasta um crédito de uma subscrição, a menos que o plano ou o evento estejam definidos para contar a reserva independentemente da presença; Não compareceu devolve o lugar e o crédito. Até responder, o crédito fica reservado e a contagem restante do visitante não se altera.

Há vários sítios onde pode responder — desde uma aula inteira com um toque até uma única reserva, ou a partir do lado da subscrição:

• A lista de reservas. Abra Visitantes → Eventos, escolha o evento e veja as reservas confirmadas de uma data passada (o email de lembrete liga diretamente lá). Assim que a data começa, aparece uma coluna Presença — não existe para datas futuras, porque ainda não há nada a responder. Cada linha tem um visto verde para presente e uma cruz vermelha para não compareceu; toque na resposta acesa para a anular. Presente Não compareceu
• Todos presentes. O cabeçalho de cada data tem um botão Todos presentes. Preenche apenas as reservas que ainda não têm resposta, por isso quem já tiver marcado como ausente continua ausente. Todos presentes
• Uma seleção. Assinale as linhas que quiser e utilize Marcar selecionados como presentes ou Marcar selecionados como ausentes — útil quando a maior parte da aula veio e alguns não.
• A partir do telemóvel. No painel, a vista Agenda mostra uma pequena etiqueta de Presença em cada evento que já começou — âmbar com uma contagem enquanto faltam respostas, verde assim que todos estiverem respondidos. Toque nela e um painel lista as reservas confirmadas com os mesmos botões de presente / não compareceu e um atalho Todos presentes, para que possa fazer a chamada enquanto as pessoas ainda estão na sala.
• Uma reserva. Abra a reserva a partir da lista (o ícone do lápis) e utilize o interruptor Esteve presente na página de detalhe, junto às respostas do formulário do visitante e às notas.
• A partir da subscrição. Abra Subscrições, escolha o plano e depois o membro — o número na coluna de utilização abre a página Utilização da adesão desse membro. Todas as reservas aceites à espera de confirmação de presença estão ali listadas com um par Confirmar presença / Não compareceu, e a lista de membros mostra quantas reservas de cada membro ainda estão à espera. É a mesma resposta que em todos os outros sítios, apenas agrupada por membro, o que é o local natural quando está a verificar quantos créditos ainda restam a alguém. Confirmar presença Não compareceu

Os administradores podem responder por qualquer evento. Um membro da equipa só pode responder pelos eventos de que é responsável — em todos os outros, os botões aparecem a cinzento.

Não precisa de se lembrar. Quando um evento terminou e ainda há reservas à espera de confirmação de presença, o Micali.online envia um email a quem for responsável por essa data com um link direto à lista certa — e apenas para as reservas em que confirmar realmente muda alguma coisa.

Pagamento

As reservas têm um indicador de pago que você próprio ativa; o Micali.online não recebe o dinheiro. O que faz é lembrar: um evento pode enviar um lembrete de pagamento uma ou duas vezes antes da data, e apenas a visitantes que estejam confirmados, ainda não pagos, e não cobertos por uma subscrição.

Levar a lista para outro lado

As reservas exportam-se para um ficheiro CSV, para eventos e para serviços, para que possa entregar um registo a quem precisar de um, somar um mês numa folha de cálculo, ou guardar a sua própria cópia. É a lista tal como a filtrou, não um relatório fixo.

A aguardar confirmação

Reservas que um visitante preencheu nas suas páginas públicas sem iniciar sessão. Nada fica reservado até essa pessoa abrir o link que lhe enviámos por email — esta página é onde vê o que ainda está em curso, quanto disso nunca se concretiza, e onde pode intervir quando o visitante não pode.

Como é que uma reserva chega aqui

Um visitante sem sessão iniciada preenche tudo — o horário, os lugares, os seus dados de contacto, qualquer formulário que tenha anexado — sem que lhe seja pedido um código primeiro. Ao submeter, a reserva fica em espera e é-lhe enviado um link de confirmação de utilização única. Até abrir esse link, nada existe na sua conta: nem visitante, nem reserva, nem resposta ao formulário, nem lugar reservado. Isto é propositado — alguém que escreva o endereço de outra pessoa nunca consegue esgotar o seu evento.

O link dura 24 horas, ou até o horário começar, o que ocorrer primeiro. Abri-lo comprova o endereço, inicia sessão do visitante e cria a reserva segundo as regras habituais — capacidade, lista de espera, prazo de inscrição, a sua aprovação — pelo que recebe a mesma resposta que teria recebido a reservar com sessão iniciada. Se tiver uma subscrição que o evento aceite, é nesse momento que lhe é perguntado qual quer utilizar.

Um visitante que já tenha sessão iniciada nunca passa por aqui. Reserva diretamente, e não fica nada por confirmar.

Também ninguém precisa de esperar pelo email. Ao iniciar sessão na sua página de reservas, aparece um cartão A aguardar a sua confirmação com tudo o que ficou em espera nesse endereço, cada um com um botão Confirmar. Confirmar ali e mesmo assim abrir o email depois não tem qualquer problema — o link limita-se a informar que já está confirmado.

O que a página mostra

Abra A aguardar confirmação na barra lateral. Há quatro números no topo, e os três primeiros são também filtros:

• À espera de confirmação — o link ainda é válido e o visitante ainda o pode utilizar.
• Nunca confirmado — o link expirou sem ser usado. Este é o número que vale a pena acompanhar: é interesse que teve e não conseguiu reter.
• Confirmado — tornaram-se reservas reais.
• Taxa de confirmação — a percentagem de links que foram utilizados. Só contam os links que já concluíram o seu percurso, para que os que ainda estão em curso não a façam descer o dia todo.

Por baixo está um gráfico de reservas por dia: todas as reservas que a sua conta recebeu, com este funil desenhado lá dentro. Uma reserva feita por um visitante com sessão iniciada, ou uma que tenha adicionado você mesmo, nunca passa pelo funil, por isso as duas linhas interiores são sempre uma fatia da mais alta. O filtro de tipo restringe ambos; a pesquisa de texto restringe apenas a tabela, por isso procurar uma pessoa não redesenha o seu volume como se fosse dela.

Apenas administradores e administradores raiz — a mesma barreira da sua lista de visitantes, porque, até o link ser aberto, estes dados de contacto não estão comprovados como pertencendo a quem os escreveu.

Confirmar em nome de um visitante

O email foi parar ao spam, o link caducou sem ser lido, ou a pessoa preferiu telefonar. Confirmar para o visitante está disponível em todas as linhas ainda não confirmadas — incluindo as expiradas, que é sobretudo o motivo de o botão existir — e reserva exatamente como o link teria feito. As regras continuam a decidir o resultado: se o evento estiver esgotado, o visitante vai para a lista de espera; se precisar de aprovação, cai nas suas aprovações; e se o prazo já tiver passado, nada é reservado e é-lhe dito o motivo. Confirmar para o visitante

Há uma diferença em relação ao clique do próprio visitante: não é gasto nenhum plano pré-pago, porque ninguém foi questionado sobre qual utilizar. Associe um à reserva depois, se esta dever contar para um plano.

Toda a reserva feita desta forma regista o administrador que a confirmou, e a linha mostra o seu nome.

Saber que aconteceu

Quando uma reserva fica em espera, chega de imediato uma notificação ao sino — os membros da equipa também a veem, mesmo não podendo abrir esta página. Liga ao evento ou serviço a que o visitante se destinava, porque ainda não há reserva nenhuma a que ligar.

Partilhar os seus eventos e serviços

Cada evento, serviço e plano pré-pago tem o seu próprio endereço público, tal como a sua página de reservas no seu conjunto. Distribua-o como link ou imprima-o como código QR — quem o abrir chega diretamente à página onde pode reservar.

O endereço de tudo o que oferece

A sua página de reservas vive no subdomínio da sua conta — o nome que escolheu na página Conta, seguido de .micali.online. É nesse único endereço que os visitantes percorrem tudo o que tornou público:

• https://yourname.micali.online — todos os eventos futuros.
• https://yourname.micali.online/services — todos os serviços e os respetivos procedimentos.
• https://yourname.micali.online/memberships — os planos pré-pagos que os visitantes podem comprar.

Os visitantes alternam entre estes separadores no topo da página, e um separador só aparece quando há algo público por trás dele. Este é o endereço a colocar no seu site, na sua assinatura de email ou no letreiro à porta — tudo o que publicar mais tarde aparece ali sem que o link mude.

Um evento, serviço ou plano pré-pago

As listas de Eventos, Serviços e Planos pré-pagos mostram uma fila de pequenos botões na extremidade direita de cada linha. O botão de partilha é o que tem três pontos ligados:

Ao clicar nele, abre-se uma pequena janela com as duas coisas de que pode precisar:

• O link — clique nele uma vez para o selecionar por completo, ou clique em Copiar para o colocar na área de transferência. Tem o aspeto de https://yourname.micali.online/events/AbCdEfGhIj.
• O código QR para esse mesmo link, com Transferir código QR para o guardar como imagem PNG que pode inserir num cartaz, num panfleto ou num diapositivo.

Os eventos modelo não têm botão de partilha — um modelo nunca é mostrado aos visitantes. Partilhe antes os eventos reais que criar a partir dele.

O que o visitante recebe

O link abre esse evento, serviço ou plano diretamente na sua página de reservas, com as suas datas ou procedimentos prontos a escolher — não há nada a procurar. Mantém-se acessível enquanto o item estiver simultaneamente público e ativo; desligue qualquer um dos dois e o link deixa de ter algo para reservar até o voltar a ligar.

Partilhar uma data e hora

Por vezes quer enviar a alguém um horário específico — “esta quinta-feira às seis” — em vez de todo o seu calendário e a esperança de que escolham corretamente.

Todos os locais onde pode partilhar um único horário dão-lhe tanto um link como um código QR, prontos a imprimir ou enviar:

• No calendário de um evento, junto a qualquer data futura.
• No ecrã de visitantes, onde pode escolher qualquer data futura de um evento — incluindo uma que ainda ninguém tenha reservado.
• Num serviço, onde escolhe o procedimento, o dia e a hora a partir da mesma disponibilidade que os seus visitantes veem.
• No calendário e na agenda, diretamente a partir do próprio horário.

O que o visitante recebe

O link abre a sua página de reservas já naquele horário exato, com as outras datas fora do caminho, por isso não há nada a escolher nem nada a errar. Se o horário estiver esgotado, é-lhes oferecida a lista de espera para o mesmo.

Um botão de reserva no seu website

Coloque um botão de reserva no seu próprio website. Ele flutua num canto de todas as páginas, e um clique permite aos visitantes reservar os seus eventos e serviços ali mesmo — ou leva-os até à sua página de reservas.

Como configurar

Abra Widget do website na barra lateral (apenas administradores raiz). Escolha o texto do botão, a sua cor, o canto onde fica, o que acontece ao clicar e o idioma da janela de reservas, experimente-o na pré-visualização, e copie o código.

Cole o código no seu website mesmo antes da tag de fecho </body>, em todas as páginas onde o botão deva aparecer. A maioria dos criadores de websites (WordPress, Wix, Webflow, Squarespace…) tem um espaço para código personalizado ou um bloco de HTML.

O seu próprio botão. Qualquer link ou botão no seu website com o atributo data-micali-open também abre a janela de reservas, e um programador pode chamar MicaliWidget.open(), MicaliWidget.close() ou MicaliWidget.toggle(). O código do widget tem de estar na página para isto funcionar. Se preferir mostrar apenas os seus próprios botões, ative Ocultar o botão flutuante: o código deixa então de desenhar um botão no canto, e a janela de reservas abre apenas a partir dos seus botões.

Um botão depois da reserva. Na página Widget do website pode adicionar um botão que a janela de reservas mostra assim que um visitante envia uma reserva — com o seu próprio texto, cor e JavaScript. Nada é executado sozinho: o seu código só é executado no seu website quando o visitante clica no botão (por exemplo, para abrir o seu pagamento), e a janela fecha-se de seguida. Para programadores, a página também recebe os eventos micali:booked e micali:action com o kind, id, name e a hora de início da reserva — nunca os dados pessoais do visitante. Com a página de reservas em vez da janela, a reserva acontece no Micali.online e o seu website não a vê.

O que acontece ao clicar

• Janela de reservas — abre-se uma janela na sua página com um calendário: eventos por data, serviços por procedimento, dia e hora. O visitante preenche os seus dados e o formulário de reserva, e confirma.
• Página de reservas — abre a sua página de reservas do Micali.online num novo separador, com tudo o que ela tem, incluindo subscrições e salas.

O que o visitante recebe

Os visitantes não iniciam sessão dentro da janela, por isso uma reserva feita ali funciona como uma feita na sua página de reservas sem iniciar sessão: só passa a ser válida quando abrirem o link que lhes enviamos por email, e é nessa página de confirmação que escolhem as subscrições que usam. Até lá, fica à espera em A aguardar confirmação.

Os seus visitantes

Todos os que alguma vez reservaram consigo, mais quem tiver adicionado, numa única lista que pode pesquisar, para a qual pode importar e à qual pode escrever.

Importar uma lista que já tem

Carregue um CSV e diga qual é cada coluna — o Micali.online não se importa com a ordem das colunas ou com o nome que o ficheiro lhes dá. Os endereços já existentes na sua conta são associados em vez de reescritos, por isso importar uma lista que se sobreponha aos seus visitantes existentes não sobrescreve os dados de ninguém.

A importação corre em segundo plano e reporta o que fez, por isso um ficheiro grande não bloqueia o ecrã. Existe um limite de 500 novos visitantes adicionados por dia, o que é deliberado: é suficientemente alto para uma lista de clientes real e suficientemente baixo para que um carregamento por engano não descontrole. Tudo o que exceda o limite é reportado em vez de descartado, e voltar a importar o mesmo ficheiro no dia seguinte retoma-o.

Listas de distribuição

Uma lista de distribuição é um grupo guardado de visitantes a quem pode escrever vezes sem conta. Preencha-a escolhendo pessoas à mão, ou escolhendo eventos e serviços e um período — todos os que reservaram isso nas últimas duas semanas, no último ano, ou alguma vez.

Escrever-lhes

Pode escrever a uma lista guardada, a todos num evento, ou a toda a sua conta. Cada mensagem é enviada individualmente, por isso um endereço incorreto não atrasa os restantes, e quem não tiver endereço de email é ignorado — a contagem desses é mostrada antes de começar a escrever, não depois de enviar.

A lista negra

Há pessoas que prefere olhar duas vezes antes de deixar entrar — o faltoso em série, aquele que reserva seis lugares e traz um. Adicione o seu endereço de email à lista negra, com uma nota para si próprio sobre o motivo.

A lista está associada ao endereço de email, não ao registo da pessoa — por isso, eliminar o visitante e voltar a inscrever-se com o mesmo endereço não a limpa.

Mensagens com visitantes

Uma conversa é um tópico entre a sua equipa e um visitante. Qualquer um dos lados a pode iniciar, e tudo o que é dito fica associado a essa pessoa, em vez de disperso por quem calhou a responder ao email.

Como começa um tópico

Um visitante pode escrever-lhe a partir da sua própria página de reservas — sobre uma reserva, ou sobre nada em particular. Também pode abrir um tópico você mesmo a partir da linha desse visitante na lista de visitantes, o que é a forma correta de fazer uma pergunta a uma pessoa sem a transformar num email que toda a gente recebe.

Quem responde

Qualquer pessoa na conta pode ler e responder, incluindo membros da equipa. Uma conversa pode ser atribuída a uma pessoa em particular, e há um filtro minhas que mostra o que lhe está atribuído ou a que já respondeu — assim, num dia de muito trabalho, é menos provável que duas pessoas respondam ao mesmo visitante duas vezes.

Manter a lista curta

Os tópicos podem ser fechados depois de resolvidos e reabertos se o visitante escrever de novo, o que mantém a lista reduzida ao que ainda precisa de uma pessoa.

Questionários de feedback

Pergunte às pessoas que compareceram o que acharam, automaticamente, assim que o evento ou a marcação tiver terminado.

Configurar um

Escreva as perguntas, associe o questionário a um evento ou a um serviço, e diga quanto tempo depois de o horário terminar deve ser enviado — imediatamente, na manhã seguinte, alguns dias depois, o que for mais adequado. Dê-lhe um nome para seu próprio uso; os visitantes nunca veem isso, apenas as perguntas.

O que o visitante recebe

Um email com a primeira pergunta. Responder a essa abre o resto numa página própria — sem sessão iniciada, sem palavra-passe, nada a memorizar. Quanto menos pedir a alguém nesse momento, mais respostas obtém.

Uma por reserva

Cada reserva é questionada exatamente uma vez, e o envio fica registado. Alguém que vem à sua aula de terça-feira todas as semanas não é convidado a avaliá-la todas as semanas.

Ler as respostas

As respostas reúnem-se por questionário, para que as possa ler em conjunto em vez de um email de cada vez. Também pode enviar-se a si próprio uma cópia de teste primeiro e ver tudo exatamente como um visitante verá.

Obter ajuda

Para perguntas que este guia não responde, ou quando algo parece errado na sua conta.

Abrir um pedido de assistência

Os administradores e administradores raiz podem abrir um pedido de assistência a partir de dentro da aplicação, o que é melhor do que enviar um email, porque chega com a sua conta associada — ninguém tem de lhe perguntar qual é o seu negócio, e podemos analisar a configuração real que está a descrever.

Como continua

Um pedido de assistência é uma conversa, não um formulário: as respostas do nosso lado chegam ao mesmo tópico e é notificado por email, para que toda a troca fique num único lugar em vez de se fragmentar por uma cadeia de emails.

Como criar um evento e publicá-lo

Para administradores raiz e administradores. O objetivo: um visitante pode chegar à sua página pública e reservar um lugar.

1. Abra a página Eventos.

   Inicie sessão na aplicação, escolha a conta correta na barra superior e abra Eventos no menu principal.

2. (Opcional) Crie primeiro um modelo.

   Se vai realizar o mesmo tipo de evento repetidamente, crie-o uma vez como modelo — capacidade, formulário, mensagens, etc. Os novos eventos clássicos poderão depois herdar dele.

3. Crie um novo evento clássico.

   Clique em Novo evento, atribua-lhe um nome e uma descrição, defina a capacidade (máximo de participantes, se podem trazer amigos) e escolha o formulário de reserva. Depois defina o local: preencha o endereço e clique em Geocodificar a partir da morada (ou clique no mapa) para definir o pin GPS. O pin é obrigatório, a menos que ative Realizado online — os visitantes veem então “Online” em vez de um endereço.

4. Adicione uma ou mais datas do evento.

   Para cada ocorrência defina a hora de início e, se necessário, o prazo de inscrição. Sem pelo menos uma data futura, o evento não pode ser reservado.

5. Restrinja a subscrições (opcional).

   Se só os subscritores podem participar, adicione as subscrições necessárias em Subscrições permitidas. Deixe vazio para permitir que qualquer visitante reserve.

6. Escolha as mensagens.

   Escolha os modelos para os lembretes de pagamento, os cancelamentos e o lembrete de presença. Garanta que o conetor correspondente (SMTP, SendGrid ou Twilio) está configurado ao nível da conta.

7. Ligue Ativo.

   Isto torna o evento operacional dentro da conta. Ainda não chegará aos visitantes até ao passo seguinte.

8. Ligue Público.

   Agora o evento surge no seu subdomínio público. Abra o subdomínio numa janela privada do navegador para verificar que tudo aparece corretamente.

Como criar um serviço ou procedimento e publicá-lo

Para administradores raiz e administradores. O objetivo: um visitante pode escolher um procedimento e reservar um horário livre.

1. Abra a página Serviços.

   No menu da aplicação, escolha Serviços. A lista mostra tudo o que pertence à conta ativa.

2. Crie o serviço.

   Clique em Novo serviço, introduza o nome, a descrição, a localização, o endereço e o fuso horário. O fuso horário é importante — todas as janelas de disponibilidade são interpretadas nele. Defina o pin GPS com Geocodificar a partir da morada ou clicando no mapa; é obrigatório, a menos que o serviço seja Realizado online, e nesse caso os visitantes veem “Online” em vez de um endereço.

3. Adicione procedimentos.

   Para cada coisa que um visitante pode reservar, crie um procedimento com um nome e uma duração. Opcionalmente, defina um tempo de preparação antes do procedimento e um tempo de limpeza depois, para que o calendário não faça reservas duplicadas.

4. Defina a disponibilidade.

   Defina as janelas de tempo recorrentes em que as reservas são permitidas (por exemplo, seg.–sex. 9:00–17:00). Só podem ser reservados os horários dentro de uma janela de disponibilidade ativa.

5. Escolha o formulário de reserva (opcional).

   Se precisar de informações do visitante no momento da reserva — telefone, alergias, notas —, anexe um formulário ao serviço.

6. Ligue Ativo no serviço e em cada procedimento.

   Um serviço inativo fica oculto em todo o lado; um procedimento inativo permanece na base de dados mas não aparece no fluxo de reservas.

7. Ligue Público no serviço.

   Os visitantes veem agora o serviço no seu subdomínio público, com os procedimentos disponíveis e os próximos horários livres.

Como configurar uma sala que as pessoas possam reservar

Para administradores raiz e administradores. O objetivo: as pessoas que convidar conseguem iniciar sessão e reservar a sala.

1. Abra a página Salas.

   No menu da aplicação, escolha Salas e clique em Nova sala.

2. Descreva a sala.

   Introduza o nome, a descrição, onde fica e quantas pessoas comporta. Depois de guardar pela primeira vez, pode adicionar fotos; a primeira é a capa.

3. Defina quando pode ser reservada.

   Adicione os horários para cada dia da semana, os minutos de preparação e limpeza, e a grelha horária.

4. Defina as regras para visitantes.

   Escolha a reserva mais longa, o intervalo entre as reservas de uma mesma pessoa e com quantos dias de antecedência se pode reservar. Deixe um campo vazio para não haver limite.

5. Escolha quem pode reservar.

   Escolha uma ou mais etiquetas (pode criar uma ali mesmo), decida se as reservas são confirmadas automaticamente, e escolha as pessoas responsáveis e o calendário partilhado.

6. Convide as pessoas.

   Em Salas → Acesso, cole os endereços de email, atribua-lhes a etiqueta e envie o convite. Às pessoas que já reservam consigo pode simplesmente atribuir a etiqueta.

7. Partilhe a ligação.

   Copie a ligação da sala a partir da lista de salas, ou deixe que as pessoas encontrem a sala no separador Salas da sua página de reservas. Ative Visível para todos se as pessoas sem acesso também deverem ver a sala.

Como ligar o Google Agenda e o Google Meet

Para todos os membros da equipa. O objetivo: as reservas confirmadas chegam automaticamente ao seu Google Agenda e, se quiser, as marcações online recebem uma ligação do Google Meet.

1. Ligue a sua conta Google.

   Abra Perfil → A Minha Google Agenda, clique em Ligar Google Agenda e permita o acesso ao calendário na janela do Google. Cada membro da equipa liga a sua própria conta; os administradores veem todas as ligações da conta na secção Google Agenda da página Conta.

2. Ative-o num evento ou serviço.

   Nas definições do evento ou serviço, ative Adicionar à Google Agenda e escolha a conta Google e o calendário. Um evento tem uma entrada no calendário por data, partilhada por todos os que o reservaram; um serviço tem uma entrada por reserva confirmada.

3. Adicione o Google Meet para marcações online (opcional).

   Ative Criar também um link do Google Meet. Os visitantes recebem então a ligação por e-mail e veem-na na sua reserva. Quando está desativado, a reserva vai apenas para o seu calendário e os visitantes não recebem ligação.

4. Envie um procedimento para outro calendário (opcional).

   Num procedimento de serviço, escolha Calendário para este procedimento — por exemplo, o calendário da pessoa que o realiza. Por predefinição, usa o mesmo calendário do serviço.

5. Experimente.

   Junto à ligação, clique em Testar. O Micali cria um evento de teste com uma ligação do Google Meet daqui a cerca de uma hora; ninguém é convidado e pode eliminá-lo de imediato.

Como criar uma subscrição e publicá-la

Para administradores raiz e administradores. O objetivo: um visitante pode comprar uma subscrição e usá-la para reservar eventos.

1. Abra a página Subscrições.

   No menu da aplicação, escolha Subscrições.

2. Crie a subscrição.

   Clique em Nova subscrição, atribua-lhe um nome e uma breve descrição que explique o que o visitante recebe.

3. Defina o preço, a moeda e os limites.

   Introduza o preço (na menor unidade monetária), a moeda, o número máximo de utilizações e/ou a duração em dias. Deixar um limite vazio significa que é ilimitado.

4. Defina quando pode ser comprada.

   Defina disponível a partir de (quando surge na página pública) e, opcionalmente, disponível até (quando desaparece). Útil para ofertas sazonais ou por tempo limitado.

5. (Opcional) Ligue-a a eventos.

   Se a subscrição deve desbloquear eventos específicos, abra cada evento e adicione a subscrição em Subscrições permitidas.

6. Ligue Ativo.

   A subscrição faz agora parte da sua conta. As subscrições existentes de visitantes recorrentes continuam a funcionar mesmo quando isto está desligado.

7. Ligue Público.

   Os visitantes veem a subscrição no seu subdomínio público e podem comprá-la. Confirme abrindo o subdomínio numa janela privada.

Como criar um modelo de mensagem

Para administradores raiz e administradores. Os modelos vivem ao nível da conta — escreva-os uma vez e reutilize-os em qualquer evento, serviço ou subscrição.

1. Abra a página Modelos de mensagens.

   No menu da aplicação, escolha Modelos de mensagens dentro da conta ativa.

2. (Opcional) Semeie as predefinições.

   Se esta for uma conta nova, clique em Semear predefinições para criar um modelo inicial para cada espaço suportado, no idioma da conta. Pode editar qualquer um deles depois.

3. Crie um novo modelo.

   Clique em Novo modelo e dê-lhe um nome interno claro — por exemplo, “Aula de ioga — lembrete de pagamento”. O nome só é mostrado ao seu pessoal.

4. Escreva a versão de email.

   Preencha o assunto e o corpo do email. Utilize marcadores como %visitor_first_name% e %event_start_at% onde quiser valores personalizados. Opcionalmente, defina um nome de remetente.

5. Escreva a versão de SMS (opcional).

   Se também pretender enviá-lo como SMS, preencha o corpo do SMS. Mantenha-o curto — os fornecedores de SMS cobram por segmento.

6. Grave o modelo.

   Precisa, no mínimo, do nome mais um corpo de email ou de SMS. O modelo aparece agora nos menus pendentes em cada formulário de evento, procedimento e subscrição.

7. Anexe o modelo onde precisar.

   Abra o evento, o procedimento de serviço ou a subscrição pertinente e escolha o novo modelo no espaço apropriado — por exemplo, Lembrete de presença num evento. Grave e está concluído.