Admin Portal Guia do Utilizador

Acerca deste guia

Este guia explica como utilizar o Admin Portal da SmartphoneKey a partir do registo. Abrange as ações disponíveis na interface do portal sem descrever os processos internos do sistema.

As secções e os botões visíveis na sua conta dependem da sua função e das suas permissões. Poderá ver apenas parte da funcionalidade descrita abaixo.

Registe a sua conta e reivindique a sua primeira fechadura

Utilize a ligação de registo fornecida pelo seu administrador ou instalador.

Passo a passo

1. Abra a página de registo (registration page).
2. Introduza o seu endereço de e-mail.
3. Crie uma palavra-passe.
4. Introduza o número de série da fechadura.
5. Introduza o código Matter ou o código de emparelhamento fornecido com a fechadura.
6. Introduza a morada, se o campo for apresentado.
7. Clique em Register ou Create Account.
8. Após um registo bem-sucedido, inicie sessão se o portal não abrir automaticamente.

A sua conta fica agora associada ao seu primeiro Objeto (Entity) e à sua primeira fechadura.

Se o registo falhar

Verifique o seguinte:

• O número de série está correto.
• O código Matter ou o código de emparelhamento está correto.
• A fechadura ainda não foi reivindicada.
• A sua palavra-passe cumpre os requisitos mínimos.

Se o problema persistir, contacte o seu administrador.

Inicie sessão no Admin Portal

1. Abra a página de início de sessão do SmartphoneKey Portal.
2. Introduza o seu endereço de e-mail e a sua palavra-passe.
3. Clique em Sign In.
4. Depois de iniciar sessão, abra o SPK Portal.

Também pode iniciar sessão com um clique através dos botões Sign in with Google ou Sign in with Apple — utilize o mesmo endereço de e-mail da sua conta do portal.

Se a sua sessão expirar enquanto o portal estiver aberto, o portal pedir-lhe-á que inicie sessão novamente.

Selecione o Objeto (Entity) atual

Um Objeto (Entity) é a organização, o edifício, o local ou a área gerida cujos dispositivos e utilizadores está a gerir.

Se tiver acesso a mais do que um Objeto:

1. Localize o seletor de Objeto no cabeçalho do portal (no canto superior direito; mostra o nome do Objeto atual e o número de fechaduras).
2. Abra a lista pendente.
3. Selecione o Objeto pretendido.
4. Aguarde que os dados da página sejam atualizados.

Se tiver acesso a apenas um Objeto, o respetivo nome é apresentado no cabeçalho, mas não existe lista pendente para mudar.

Confirme sempre o Objeto selecionado antes de criar utilizadores, atribuir chaves, adicionar dispositivos ou consultar registos.

Navegação principal

O menu do lado esquerdo contém um conjunto fixo de secções de nível superior. Consoante as suas permissões, poderá ver todas ou apenas algumas delas:

Várias secções abrem com separadores no topo da página em vez de entradas de menu separadas:

• Keys → Keys, Physical Keys e Wallet Keys
• Devices → Locks, Hubs e Matter
• Cameras → Cameras e Camera Roles
• Logs → Activity e Audit
• Settings → Profile, Subscription, Notifications, Access Requests e Billing

Algumas contas podem não apresentar todas as secções ou separadores.

As secções e os botões que a sua subscrição não inclui são apresentados bloqueados, com um ícone de cadeado. Clicar num item bloqueado abre uma janela que propõe a compra do pacote em falta na página Settings → Subscription (ver 23.2). O separador Matter Devices, as páginas Cameras e Logs, as chaves de convidado e a concessão de acesso à aplicação móvel ou ao intercomunicador desbloqueiam-se desta forma.

No canto superior direito do cabeçalho do portal, junto ao seletor de Objeto, pode alterar o idioma da interface do SPK Portal. Abra o seletor de idioma e escolha inglês, ucraniano, espanhol, grego, alemão, francês, coreano, japonês, polaco ou português — o portal é recarregado no idioma selecionado. A ligação Welcome Page ao lado regressa à página inicial do portal com o cartão SmartphoneKey Portal. A sua escolha é guardada na sua conta, pelo que a interface se mantém nesse idioma entre sessões e dispositivos. O comutador de tema claro/escuro e a versão do Admin Panel são apresentados no fundo do menu do lado esquerdo. Nos telemóveis, o seletor de idioma aparece também no fundo do menu lateral, e uma barra de navegação inferior dá acesso com um toque às secções mais utilizadas — o separador Menu abre o menu completo, que também pode fechar deslizando-o para a esquerda ou com o gesto de retroceder do seu dispositivo.

Painel (Dashboard)

O Dashboard oferece uma visão geral rápida do Objeto selecionado.

Utilize o Painel para:

• Ler os mosaicos de indicadores no topo: Total Locks (fechaduras online, offline e que ainda não comunicaram), Matter Devices (todos os dispositivos comissionados através dos seus hubs, em todos os Objetos que pode ver: online, offline e que ainda não comunicaram), Total Keys (as chaves na posse das pessoas, por tipo: Wallet Keys, chaves físicas, chaves de convidado e acesso ao intercomunicador) e Total Users (pessoas com acesso completo, pessoas com acesso limitado apenas por telefone e pessoas desativadas). O número no centro de cada meio anel é o total, cada segmento colorido tem a sua própria contagem, a legenda por baixo do anel identifica os segmentos e a seta no canto de um mosaico abre a página correspondente.
• Alternar entre os painéis Locks, Cameras e Matter por baixo dos indicadores com o comutador de separadores (apresentado quando está disponível mais do que uma vista); o painel Matter mostra os totais de hubs no painel Connected HUBs.
• Verificar a atividade recente.
• Confirmar que está a trabalhar no Objeto correto (o nome e o código do Objeto são apresentados no Painel).
• Utilizar os botões de ação rápida (Give Access, Guest Key, Remove Access) e os atalhos de Quick access quando estiverem disponíveis para a sua função.

Quando muda de Objeto, o Painel é atualizado automaticamente.

Gerir Objetos (Entities)

Abra Entities para criar e gerir organizações, edifícios, locais ou outras áreas geridas. Os Objetos são apresentados como cartões (vista de grelha) ou linhas (vista de lista); pode filtrá-los, pesquisá-los e ordená-los.

7.1 Criar um Objeto

1. Abra Entities.
2. Clique em Create Entity.
3. Introduza o nome do Objeto.
4. Adicione uma descrição, se necessário.
5. Opcionalmente, introduza o endereço de e-mail de um Local Admin inicial em Add Local Admin.
6. Opcionalmente, introduza o número de Wallet Keys a transferir para esse Local Admin.
7. Clique em Create.

Código do Objeto

O código do Objeto apresentado nos cartões e nas linhas é gerado automaticamente a partir do nome do Objeto (letras maiúsculas e números, tornado único). Não pode ser alterado após a criação.

7.2 Editar um Objeto

1. Abra Entities.
2. Localize o Objeto pretendido.
3. Clique no ícone de definições (engrenagem) ou abra o menu do cartão e escolha Edit details.
4. Atualize o nome ou a descrição.
5. Clique em Save Changes.

7.3 Eliminar um Objeto

1. Abra Entities.
2. Localize o Objeto pretendido.
3. Abra o menu do cartão e escolha Delete entity.
4. Leia atentamente a mensagem de confirmação.
5. Confirme a eliminação.

A eliminação não está disponível enquanto o Objeto ainda contiver fechaduras; remova-as ou reatribua-as primeiro.

7.4 Janela Entity Information

Faça duplo clique (nos telemóveis, toque duas vezes) no nome de um Objeto para abrir a janela Entity Information — um resumo apenas de leitura de tudo o que diz respeito a esse Objeto. A mesma janela abre a partir do ícone de informação na linha ou no cartão do Objeto, a partir do menu da linha ou do cartão (Entity Information) e a partir do ícone de informação da tabela de resumo (ver 7.5).

• Header — o monograma, o nome e o código do Objeto, o seu estado Active ou Inactive, a marca CURRENT quando é o Objeto selecionado, o Objeto principal quando está aninhado, e a descrição.
• Summary tiles — utilizadores, chaves emitidas, fechaduras, dispositivos Matter e câmaras num relance, cada um com o seu detalhe mais útil (chaves livres, fechaduras online, e assim por diante).
• Keys — as chaves atualmente na posse das pessoas, divididas por tipo (Wallet, Physical, Guest, QR Intercom) numa barra de cores, mais o conjunto livre, as chaves que expiram dentro de 30 dias, as chaves expiradas e revogadas, e as chaves de convidado partilhadas (várias fechaduras). Quando a sua empresa tiver ativado Expiring Wallet Keys (Odoo: Configuration > Settings > Portal Interface; desativado por predefinição), a secção também lista as Wallet Keys prestes a expirar com o nome, o e-mail, a fechadura e a data de expiração do titular.
• Users — utilizadores com acesso completo, com acesso limitado (apenas telefone) e desativados, a mesma divisão da página Users.
• Administrators — o proprietário, cada Local Admin (com o respetivo saldo de Wallet Keys) e todas as pessoas com uma função de gestão limitada a este Objeto, com contactos e etiquetas de função. O ícone de cartão de identificação num cartão abre a janela User Information dessa pessoa na página Users. Os nomes são apresentados para os Objetos que gere; para os restantes, a secção mostra apenas a contagem.
• Locks — cada fechadura com o seu estado online, offline ou não ligado, quantas chaves estão emitidas nela, e marcas de leitor programador e de ligação Matter.
• Devices and Cameras — hubs e dispositivos Matter (online, offline, ainda sem comunicação), câmaras (ativas, desativadas) e funções de câmara. Apresentado apenas quando pode abrir essas páginas.
• Recent Activity — um gráfico dos eventos nas fechaduras do Objeto ao longo dos últimos 14 dias, uma barra por dia (aponte para uma barra para ver a data e a contagem), seguido dos cinco eventos mais recentes, do mais novo para o mais antigo, com a pessoa envolvida.
• Details — código, Objeto principal, subobjetos, e quando e por quem o Objeto foi criado.

Clique no título de uma secção para a recolher; a janela memoriza a sua escolha no seu navegador para o próximo Objeto que abrir. Download PDF no rodapé guarda toda a janela como um relatório PDF no seu idioma, pronto a enviar ao proprietário do edifício. A janela, por si só, não altera nada: Add user, Edit e Open no seu rodapé conduzem às mesmas ações que os botões da linha.

7.5 Tabela de resumo de Objetos

Utilize o comutador de vista junto à caixa de pesquisa (ícone de lista / ícone de tabela) para substituir as linhas de Objetos por uma única tabela com todos os Objetos que pode ver. Cada linha mostra o estado do Objeto, os seus utilizadores (com a divisão completo / limitado), as chaves emitidas (com a barra de tipos) e as chaves livres, as fechaduras (com quantas estão online), os dispositivos Matter e as câmaras (quando pode abrir essas páginas), os administradores e o número de eventos nas suas fechaduras ao longo dos últimos 14 dias; a última linha totaliza as colunas.

Clique no título de uma coluna para ordenar por ela; clique novamente para inverter a ordem. Os filtros e a caixa de pesquisa restringem a tabela tal como restringem as linhas. Faça duplo clique numa linha, ou clique no seu ícone de informação, para abrir a janela Entity Information. O portal memoriza a última vista que utilizou.

Gerir Local Admins

Um Local Admin pode gerir utilizadores e distribuir as Wallet Keys atribuídas dentro de um Objeto específico.

Os Local Admins são geridos na janela de edição do Objeto, não numa página separada.

Esta secção está disponível para todos os administradores autorizados a gerir este Objeto, não apenas para a pessoa que o detém. Os Local Admins não podem adicionar outros Local Admins.

O que um Local Admin pode fazer pode ser restringido por empresa pelo administrador da sua empresa no back office, em Configuration → Role Configurator → Local Admin → Company settings: se os Local Admins podem adicionar e gerir hubs e dispositivos Matter, se podem partilhar câmaras com pessoas e quantos utilizadores cada Local Admin pode criar num Objeto. Sem estas definições, um Local Admin gere hubs, dispositivos Matter e o acesso às câmaras como qualquer outro administrador do Objeto e cria utilizadores sem limite. Estas definições aplicam-se apenas aos Objetos dessa empresa, e uma conta que também tenha outra função de gestão mantém os direitos dessa função.

8.1 Adicionar um Local Admin

1. Abra Entities.
2. Abra o Objeto pretendido para edição (ícone de engrenagem ou Edit details).
3. Desloque-se até à secção Manage Local Admins.
4. Em Add Local Admin, selecione um membro existente do Objeto ou introduza um novo endereço de e-mail.
5. Opcionalmente, introduza o número de Wallet Keys a transferir.
6. Clique em Add.

Se o endereço de e-mail não pertencer a um utilizador existente, o utilizador recebe um convite. Também pode adicionar um Local Admin inicial ao criar o Objeto (ver 7.1).

8.2 Transferir mais Wallet Keys para um Local Admin

Utilize esta opção para transferir Wallet Keys (Transfer Wallet Keys) para um Local Admin a partir do seu saldo livre.

1. Abra o Objeto para edição.
2. Em Manage Local Admins, localize o Local Admin pretendido.
3. Introduza a quantidade no campo Wallet Keys junto a esse Local Admin.
4. Clique em Transfer.

8.3 Remover permissões de Local Admin

1. Abra o Objeto para edição.
2. Em Manage Local Admins, localize o Local Admin pretendido.
3. Clique no botão de remoção.
4. Confirme a ação.

Remover as permissões de Local Admin não elimina a conta de utilizador.

Gerir utilizadores

Abra Users para gerir os utilizadores do portal nos seus Objetos. Os utilizadores são apresentados numa tabela pesquisável — a caixa de pesquisa corresponde ao nome, ao e-mail, ao telefone, à morada e às matrículas de um utilizador. Utilize os filtros All / Active / Deactivated para filtrar por estado — a página abre com Active selecionado — e o seletor de ordenação para ordenar a lista por nome, por morada, por acesso a fechaduras ou por contas mais recentes. Quando ordena por acesso a fechaduras, aparece uma seta junto ao seletor: indica se a lista vai do maior número de fechaduras para o menor, e clicar nela inverte essa ordem. Faça duplo clique (toque duas vezes) na linha de um utilizador para abrir a janela apenas de leitura User Information (ver 9.8). As colunas Address e License Plates aparecem apenas quando pelo menos um dos utilizadores listados tem uma morada ou uma matrícula. Nos telemóveis, a tabela mostra as colunas essenciais (nome, contacto principal, acesso a fechaduras e ações); os restantes detalhes estão disponíveis na janela User Information ou ao editar um utilizador.

Os membros da equipa interna (contas do pessoal da empresa) adicionados ao seu Objeto aparecem na mesma tabela com um distintivo Internal. Pode gerir o seu acesso a fechaduras e as suas chaves como para qualquer outro utilizador, mas a conta em si (editar, desativar, reativar) só pode ser alterada por administradores da SmartphoneKey — para os outros gestores, essas ações estão ocultas.

A sua própria conta também aparece na lista, para que possa ver e gerir o seu próprio acesso a fechaduras e as suas chaves. Não pode editar nem desativar a sua própria conta a partir desta página — essas ações estão ocultas na sua própria linha.

9.1 Criar um utilizador

1. Abra Users.
2. Clique em New User.
3. Adicione uma fotografia de perfil, se necessário (PNG ou JPG, até 6 MB).
4. Introduza o nome completo do utilizador.
5. Introduza o endereço de e-mail do utilizador (passa a ser o e-mail de início de sessão).
6. Introduza um número de telefone, se necessário. Escolha o país na lista pendente à frente do número e, em seguida, escreva o número nacional. Os países são listados pelo seu código de duas letras com o respetivo indicativo — `UA (+380)`, `DE (+49)`, `US/CA (+1)` para os Estados Unidos e o Canadá, que partilham um indicativo — e os países do idioma da sua interface aparecem primeiro, seguidos de todos os outros por ordem alfabética do código. O campo do número aceita apenas dígitos e para no comprimento de número utilizado no país selecionado; enquanto faltarem dígitos, uma mensagem por baixo do campo indica quantos o número precisa.
7. Introduza uma morada / apartamento, se necessário.
8. Adicione uma ou mais matrículas, se necessário.
9. Selecione o Objeto.
10. Clique em Create User.

Se o endereço de e-mail já pertencer a um utilizador — de outro Objeto ou de outra empresa — não é criada uma segunda conta: essa pessoa é adicionada ao Objeto selecionado (e à respetiva empresa), e a janela indica-o.

O envio de um e-mail de boas-vindas ao novo utilizador é controlado pelo separador Defaults em Settings (o comportamento «Email on user welcome») — não existe nenhuma caixa de verificação nesta janela.

Nas subscrições Enterprise e Community Manager, a janela mostra também um botão Import Users para criar muitos utilizadores de uma só vez a partir de um ficheiro CSV ou Excel (ver 9.7).

9.2 Editar um utilizador

1. Abra Users.
2. Localize o utilizador pretendido.
3. Clique na ação de edição (lápis) ou no botão Edit User na janela User Information (ver 9.8).
4. Atualize os campos necessários.
5. Reveja a associação a Objetos na lista pendente Entities (selecione um ou mais Objetos). A lista pendente fica oculta quando gere um único Objeto.
6. Atualize a morada, as matrículas ou a fotografia de perfil, se necessário.
7. Clique em Save Changes.

Um utilizador tem de permanecer associado a pelo menos um Objeto.

9.3 Pesquisar um utilizador

Utilize o campo de pesquisa para pesquisar por:

• Nome
• E-mail
• Número de telefone
• Matrícula

As listas longas são apresentadas com 50 utilizadores por página, com as ligações de página por baixo da tabela. A pesquisa, os filtros de estado e a ordenação abrangem sempre todos os utilizadores do Objeto selecionado, não apenas a página no ecrã, e uma nova pesquisa devolve-o à primeira página dos seus resultados.

Quando a sua pesquisa contém um número, as pessoas que vivem exatamente nesse apartamento são listadas primeiro, depois aquelas cuja morada apenas contém o número (pesquisar 7 encontra o apartamento 7 antes dos apartamentos 17, 37 e 75) e, por último, as correspondentes apenas pelo número de telefone ou pela matrícula — num edifício, o número do apartamento é normalmente o que procura. A ordem escolhida no seletor de ordenação continua a aplicar-se dentro de cada um desses grupos.

A coluna Physical Keys conta os cartões distintos que uma pessoa possui: um cartão adicionado a três fechaduras conta uma vez, enquanto dois cartões separados para a mesma porta contam duas vezes. É apresentada apenas quando Show the Physical Keys column on the Users page está ativado em Settings → Defaults (ver 23.5); está desativado por predefinição.

9.4 Desativar um utilizador

Utilize esta ação quando um utilizador já não deve ter acesso ativo.

1. Abra Users.
2. Localize o utilizador pretendido.
3. Clique na ação de desativação.
4. Leia a mensagem de confirmação (a desativação remove o acesso a fechaduras, desativa o início de sessão no portal e suspende o utilizador SmartKey).
5. Opcionalmente, introduza um motivo.
6. Confirme a ação.

9.5 Reativar um utilizador

1. Abra Users.
2. Localize o utilizador desativado.
3. Clique em Reactivate User.
4. Confirme a ação.

9.6 Criar um Limited User (apenas telefone, sem início de sessão)

Um Limited User é uma identidade simplificada, apenas com telefone e sem início de sessão no portal — utilize-a para pessoas a quem apenas precisa de emitir chaves, sem lhes dar uma conta completa. A tabela Users mostra Limited access na coluna do e-mail para estas entradas.

1. Abra Users e clique em New User.
2. Introduza o nome completo do utilizador.
3. Ative Just phone number, junto ao campo Phone Number.
4. Introduza um número de telefone (obrigatório — é o identificador da pessoa). O indicativo do país é escolhido na lista pendente à frente do número, com a mesma verificação de comprimento por país que para os utilizadores normais (ver 9.1).
5. Opcionalmente, introduza um endereço de e-mail.
6. Opcionalmente, introduza uma morada / apartamento.
7. Selecione um ou mais Objetos (quando gere um único Objeto, este é selecionado automaticamente e o campo fica oculto).
8. Clique em Create Limited User.

Os utilizadores limitados têm as mesmas ações Edit, Give Access e Deactivate/Reactivate que os utilizadores normais (ver as secções 9.2, 9.4, 9.5 e 10), e o botão Lock Access na sua linha abre a mesma janela de acesso por fechadura (secção 10) — sem o botão de Wallet Key, uma vez que não têm início de sessão no portal. Conceder-lhes acesso através do assistente oferece Physical Key e QR Intercom. O seu número de telefone é editado da mesma forma (ação de edição), mas não pode ser alterado, porque é o seu identificador permanente.

Transformar um utilizador limitado num utilizador completo. Abra a ação de edição e atribua-lhe um endereço de e-mail: ao guardar, deixa de ser limitado e passa a ser um utilizador normal do portal, que pode iniciar sessão com esse endereço. Mantém a mesma identidade — todas as chaves, matrículas e concessões de fechadura já emitidas continuam válidas — e o seu número de telefone mantém-se como está. O endereço não pode pertencer já a outro utilizador ou contacto, e a conversão conta para o limite de utilizadores da sua subscrição, uma vez que passa a ter início de sessão. Como qualquer novo utilizador do portal, ainda não tem palavra-passe: define-a por si próprio com Reset Password na página de início de sessão. O envio de um e-mail de boas-vindas com essas instruções é controlado pelo separador Defaults em Settings.

9.7 Criar utilizadores em massa a partir de um ficheiro (CSV ou Excel)

Nas subscrições Enterprise e Community Manager, a janela de criação de utilizadores mostra um botão Import Users para criar muitos utilizadores de uma só vez. São aceites tanto ficheiros CSV simples como livros do Excel (`.xlsx`, primeira folha de cálculo).

1. Abra Users e clique em New User.
2. Clique em Import Users.
3. Selecione o Objeto de destino.
4. Clique em Example CSV ou Example Excel para transferir um ficheiro com todas as colunas suportadas.
5. Preencha uma linha por utilizador e carregue o ficheiro com Choose CSV or Excel file.
6. Opcionalmente, ative a atualização de utilizadores existentes quando o e-mail já existir.
7. Clique em Import Users e reveja os resultados linha a linha.

Quando a importação termina, a janela Import report abre-se sozinha assim que pelo menos uma linha não tenha sido adicionada; também pode ser aberta com o botão Import report junto às contagens do resultado. O relatório lista cada linha com o seu número no ficheiro, o nome da pessoa, o seu e-mail ou telefone, o resultado (Created, Updated, Skipped ou Failed) e o motivo completo pelo qual uma linha foi ignorada (o utilizador já existia) ou falhou. Desative Only rows that were not added para ver também as linhas criadas e atualizadas, e use Download the report (CSV) para guardar uma cópia.

Os utilizadores do portal criados recebem o e-mail de boas-vindas de acordo com o separador Defaults em Settings (o comportamento «Email on user welcome»).

Colunas do ficheiro:

• name — obrigatório em todas as linhas.
• email — cria um utilizador completo do portal (passa a ser o e-mail de início de sessão). Uma linha sem número de telefone não é problema — o utilizador é simplesmente criado sem ele.
• phone — opcional para utilizadores do portal; uma linha com um número de telefone e sem e-mail cria um Limited User (ver 9.6). Escreva cada número no formato internacional, com o indicativo do país e um `+` inicial (por exemplo, `+380501234567`); um número sem indicativo é rejeitado. No Excel, formate a coluna do telefone como texto para manter o `+`.
• address — opcional; a nota de morada / apartamento apresentada no cartão do utilizador (ver 9.1).
• license_plate — opcional, apenas para utilizadores do portal; separe várias matrículas com `;`.

São processadas até 500 linhas por importação. As linhas que falham (por exemplo, um e-mail ou um número de telefone inválido) são reportadas individualmente e não impedem o resto do ficheiro.

Os nomes podem usar qualquer alfabeto (por exemplo, cirílico). Se editar o ficheiro no Excel, a opção mais segura é partir do exemplo Excel e carregá-lo como `.xlsx` — o formato CSV simples do Excel substitui as letras não latinas por pontos de interrogação, e essas linhas são rejeitadas durante a importação. Se preferir CSV, guarde-o como CSV UTF-8.

9.8 Janela User Information

Faça duplo clique (nos telemóveis, toque duas vezes) na linha de um utilizador para abrir a janela User Information — um resumo apenas de leitura de tudo o que diz respeito a essa pessoa:

• Header — fotografia de perfil, nome, e-mail e telefone (tocáveis) e etiquetas de estado: Active ou Deactivated, Limited access, Internal, qualquer função além de utilizador comum (por exemplo, Local Manager, com o Objeto a que se aplica), o pacote de subscrição se a pessoa tiver um e — para os Local Admins — o seu próprio saldo de Wallet Keys. O ícone de envelope junto ao nome mostra se o e-mail de convite já foi enviado a esta pessoa: esbatido quando ainda não foi, sólido quando foi (passe o cursor para ver quando); clique nele para enviar o convite de novo. Os utilizadores sem e-mail não têm ícone.
• Profile — morada / apartamento, associação a Objetos, quando e por quem a conta foi criada, o último início de sessão no portal, as matrículas e o estado SmartKey.
• Wallet Key — o estado e a data de expiração da chave, quando e por quem foi emitida, e todas as fechaduras que abre, com a data em que cada acesso foi concedido e por quem.
• Physical Keys — cada cartão com o seu número, série, tecnologia, quando e por quem foi emitido, e as suas fechaduras. O cabeçalho mostra quantos cartões diferentes a pessoa tem — um cartão conta uma só vez, por muitas fechaduras que abra.
• App and Intercom Access — as fechaduras em que o acesso à aplicação móvel ou ao Intercomunicador QR está ativo, com quem concedeu cada um e quando.
• Cameras — câmaras de que a pessoa é proprietária e funções de câmara a que pertence (as concessões de transmissão em direto são geridas na própria câmara e não são listadas aqui).
• Matter Devices — dispositivos inteligentes associados à pessoa, com o hub e a data em que foram associados.
• Recent Activity — os cinco eventos de fechadura mais recentes da pessoa, do mais novo para o mais antigo. View all activity abre a página Activity já filtrada para esta pessoa (disponível para utilizadores com e-mail).

Clique no título de uma secção para a recolher, deixando apenas o título; clique novamente para a expandir. A janela memoriza o que recolheu — abra o utilizador seguinte e as mesmas secções já estão recolhidas, para que possa reduzi-la às partes com que realmente trabalha. A escolha é apenas sua e fica no seu navegador; não altera o que qualquer outra pessoa vê.

A janela é meramente informativa — nada nela altera qualquer acesso. Utilize Edit User no seu rodapé para saltar para a janela de edição (apresentado apenas para as contas que pode editar), ou faça a gestão do acesso por fechadura a partir da janela Lock Access, como anteriormente (ver 10). A janela abre também para utilizadores desativados e internos, para os quais a janela de edição não abriria.

Gerir o acesso de um utilizador a uma fechadura

A partir da secção Users, todo o acesso por fechadura de um utilizador é gerido numa única janela.

1. Abra Users.
2. Localize o utilizador pretendido.
3. Clique no botão da coluna Lock Access — mostra quantas fechaduras essa pessoa pode abrir atualmente (por exemplo, 3 locks).

Abre-se uma janela (nos telemóveis ocupa todo o ecrã) com todas as fechaduras do Objeto, pelo que o acesso também pode ser concedido numa fechadura que a pessoa ainda não tem. Cada linha de fechadura tem quatro botões:

• Card — a Wallet Key (uma chave digital na carteira do telemóvel).
• Key — a chave física NFC.
• Phone — acesso à aplicação móvel.
• Camera — acesso ao Intercomunicador QR.

Um botão apresentado premido significa que o utilizador tem atualmente esse tipo de acesso nessa fechadura. Clique num botão não premido para conceder esse tipo de acesso; clique num botão premido para o retirar.

10.1 Wallet Key (botão de cartão)

• Se o utilizador ainda não tiver chave, uma janela propõe atribuir uma nova Wallet Key e enviá-la para o seu e-mail.
• Se o utilizador já tiver uma Wallet Key ativa noutra fechadura, essa mesma chave é simplesmente adicionada a esta fechadura.
• Clicar no botão de cartão premido revoga a Wallet Key dessa fechadura.

As Wallet Keys não estão disponíveis para utilizadores limitados (apenas telefone), pelo que o botão de cartão não é apresentado para eles.

10.2 Chave física (botão de chave)

• Se o utilizador já tiver uma chave física ativa, uma janela propõe adicionar essa mesma chave a esta fechadura ou programar uma nova. Quando o utilizador tem várias chaves físicas, a janela enumera-as — cada uma com o seu número curto, o tipo de cartão e as fechaduras que já abre — e assinala uma ou várias (ou Select all) antes de clicar em Add Existing Key; cada chave assinalada é adicionada a esta fechadura.
• Programar uma nova chave abre o Physical Key Wizard (ver a secção 14) com a fechadura e o utilizador já selecionados.
• Clicar no botão de chave premido abre a janela de revogação da chave física dessa fechadura. Quando há várias chaves físicas do utilizador na fechadura, são revogadas uma de cada vez: a janela mostra o UUID da chave que vai ser revogada.

10.3 Acesso à aplicação móvel (botão de telefone)

• Clique no botão de telefone para conceder acesso à aplicação móvel; clique no botão premido para o revogar (com confirmação).
• Nas subscrições Professional e Enterprise pode concedê-lo mesmo quando a pessoa ainda não tem chave para essa fechadura. Nos outros planos, o botão permanece desativado até que seja atribuída uma chave.

10.4 Acesso ao Intercomunicador QR (botão de câmara)

• Clique no botão de câmara para conceder acesso ao Intercomunicador QR; clique no botão premido para o revogar (com confirmação).
• Conceder acesso ao Intercomunicador QR concede também acesso à aplicação móvel quando a pessoa ainda não o tem, porque a chamada do intercomunicador é atendida na aplicação. Retirar o intercomunicador mais tarde deixa o acesso à aplicação móvel como está.
• Nas subscrições Professional e Enterprise pode concedê-lo mesmo quando a pessoa ainda não tem chave para essa fechadura. Nos outros planos, o botão permanece desativado até que seja atribuída uma chave.

Num plano Managed Access Control Service (parceiro), conceder acesso ao Intercomunicador QR requer o complemento Resident Digital Access Package ativo. Até ser comprado, o botão de concessão fica oculto; ver 23.2 sobre como comprar o complemento. Revogar um acesso existente permanece sempre disponível.

Se a concessão ou a revogação do acesso à aplicação móvel ou ao Intercomunicador QR falhar porque os registos do SmartKey estão dessincronizados do portal, o portal ressincroniza e tenta novamente de forma automática. Se continuar a falhar, verá «Ups, algo correu mal — contacte o seu administrador», e a falha é registada no registo de auditoria.

Gerir chaves digitais

Abra Keys (o separador Keys) para atribuir, atualizar, partilhar ou revogar chaves digitais. As chaves são apresentadas como cartões.

Cada chave é apresentada como um cartão. A frente mostra a fechadura, o tipo de chave, o seu número, o titular e a validade; toque no cartão para o virar: o verso mostra o estado da chave, o e-mail ou o telefone do titular e, por baixo, a morada do titular quando o seu contacto tem uma, as etiquetas de acesso Mobile e Intercom, as ligações Apple / Google Wallet, os botões Lock Details e User Details — abrem exatamente as mesmas janelas que Lock Details em Devices → Locks (15.14) e a janela User Information em Users (9.8) — e as ações (o menu, Update / Delete para uma chave de convidado, Revoke para acesso ao intercomunicador). Toque no verso, ou na pequena seta no seu canto, para virar o cartão novamente para a frente. A caixa de verificação no canto superior esquerdo da frente seleciona a chave para ações em massa sem a virar. Quando o nome da fechadura aparece truncado na frente, passe o cursor sobre ele para ver o nome completo.

11.1 Filtrar a lista de chaves

Utilize os filtros para restringir a lista por:

• Fechadura
• Estado (Active, Expired, Revoked, Available)
• Tipo (Wallet Key, Physical Key, Intercom, Guest Key)

Utilize o campo de pesquisa para pesquisar por UUID da chave, nome do utilizador, e-mail, telefone ou morada.

Quando a sua pesquisa contém um número, as chaves das pessoas que vivem exatamente nesse apartamento são listadas primeiro, depois aquelas cuja morada apenas contém o número (pesquisar 7 encontra o apartamento 7 antes dos apartamentos 17, 37 e 75) e, por último, as chaves correspondentes apenas por outro campo — num edifício, o número do apartamento é normalmente o que procura.

11.2 Atribuir (associar) uma chave

1. Abra Keys.
2. Clique em Bind Key. Abre-se o assistente Assign Key.
3. Passo 1 — Assinale todas as fechaduras que a chave deve abrir. Utilize Select all ou Clear quando a lista for longa.
4. Passo 2 — Selecione um utilizador existente ou clique em Create User para adicionar um. O campo de utilizador é uma caixa de pesquisa: comece a escrever um nome, e-mail ou telefone e a lista por baixo vai-se reduzindo à medida que escreve; escolha a pessoa com o rato ou com as setas e Enter. Assinale Show address para ver a morada de cada pessoa por cima do nome na lista e pesquisar também por morada — as correspondências de morada são então listadas antes das correspondências de nome. O estado inicial de Show address segue Settings → Defaults (ver 23.5).
5. Passo 3 — Escolha o tipo de chave:
   • Wallet Key
   • Physical Key
   • QR Intercom
6. Preencha as opções apresentadas para o tipo de chave selecionado.
7. Clique no botão final (Assign Key, Grant Access ou Continue to Programming, consoante o tipo de chave).

Para um Limited User (ver 9.6), o Passo 2 mostra o seu número de telefone onde normalmente apareceria um e-mail, e o Passo 3 oferece apenas Physical Key e QR Intercom — a Wallet Key não está disponível, uma vez que os utilizadores limitados não têm início de sessão no portal.

Selecionar várias fechaduras de uma só vez

Selecionar mais do que uma fechadura emite uma única Wallet Key que abre todas elas, pelo que o utilizador recebe um só passe em vez de um por porta. Apenas uma Wallet Key pode ser emitida desta forma; Physical Key e QR Intercom são opções por fechadura e ficam ocultas enquanto estiverem selecionadas várias fechaduras.

Se uma fechadura não puder ser concluída, as restantes prosseguem na mesma. O assistente permanece então aberto e mostra um resultado por fechadura — adicionada, já tinha esta chave, ou falhou com o motivo — para que nada falhe silenciosamente. É enviado um único e-mail de chave para todo o lote, não um por fechadura.

11.3 Atribuir uma Wallet Key

Utilize esta opção para acesso Wallet no telemóvel.

1. No assistente, escolha Wallet Key.
2. Ative Send email with key se quiser que o portal envie automaticamente a ligação Wallet por e-mail.
3. Clique em Assign Key.

O acesso à aplicação móvel e ao Intercomunicador QR é concedido automaticamente para essa fechadura. Se o utilizador já tiver uma identidade de chave reutilizável, o portal pode reutilizá-la. O estado inicial de Send email with key e o acesso concedido seguem o comportamento predefinido configurado para a sua conta, pelo que poderá ver estas opções já preenchidas.

11.4 Atribuir acesso ao Intercomunicador QR

Utilize esta opção quando o utilizador precisa de acesso ao Intercomunicador QR sem uma Wallet Key.

1. No assistente, escolha QR Intercom.
2. Confirme o utilizador e a fechadura.
3. Clique em Grant Access.

11.5 Atualizar uma chave

Abra o menu de ações do cartão de uma chave. Consoante o tipo de chave, as ações disponíveis podem incluir:

• Set Validity (alterar as datas de início / fim de validade)
• Send Wallet Email
• Add to Another Lock (reutilizar o UUID da chave noutras fechaduras)
• Revoke Key

Add to Another Lock mantém a natureza da chave: adicionar uma chave física a outra fechadura adiciona lá o mesmo cartão como chave física — não concede acesso à aplicação móvel nem ao Intercomunicador QR, que continuam a ser funcionalidades da Wallet Key. Um cartão físico pode ser adicionado a outra fechadura em qualquer momento da sua vida; apenas um cartão revogado é recusado.

Pode assinalar várias fechaduras de destino de uma só vez. A mesma chave é adicionada a cada uma delas, e é apresentado um resultado por fechadura se alguma não puder ser concluída.

Também pode alternar as etiquetas de permissão Mobile e Intercom e copiar a ligação Apple Wallet ou Google Wallet diretamente a partir do cartão.

11.6 Revogar uma chave

1. Abra Keys.
2. Localize a chave.
3. Abra o menu de ações e escolha Revoke Key (ou utilize o botão Revoke nos cartões de intercomunicador).
4. Confirme a ação.

Revogar uma Wallet Key não a retira definitivamente. Uma pessoa mantém uma única Wallet Key enquanto estiver no sistema, pelo que voltar a conceder-lhe acesso — na mesma fechadura ou noutra — traz de volta exatamente a mesma chave em vez de emitir uma nova. O passe já guardado no seu telemóvel volta a funcionar; não há nada que a pessoa precise de adicionar novamente. Os cartões físicos são diferentes: um cartão revogado nunca é recuperado, e é necessário programar um novo cartão.

11.7 Utilizar ações em massa

Selecione chaves com as caixas de verificação para revelar a barra de ações em massa.

1. Abra Keys.
2. Selecione as chaves pretendidas (ou utilize Select All / Select Filtered).
3. Escolha uma ação em massa:
   • Bind (para chaves disponíveis)
   • Add to Lock (reutilizar UUIDs de chaves)
   • Send Emails (e-mails Wallet)
   • Revoke
4. Confirme e acompanhe o progresso até à conclusão.

Bind pede o utilizador na mesma caixa de pesquisa do assistente Assign Key: comece a escrever um nome, e-mail ou telefone para reduzir a lista e assinale Show address por baixo para ver e pesquisar moradas (ver 11.2).

Add to Lock permite assinalar várias fechaduras de destino, tal como na janela de chave única. Cada chave selecionada é então adicionada a cada fechadura selecionada, mantendo o seu próprio UUID, nível de acesso e período de validade. Uma chave que uma fechadura já tem é reportada apenas para essa fechadura e não interrompe o resto da operação.

11.8 Fechaduras offline e alterações pendentes

Uma chave só pode ser verdadeiramente adicionada a uma fechadura, ou dela removida, enquanto a fechadura estiver acessível. Quando atribui, atualiza ou revoga uma chave numa fechadura que está atualmente Offline — ou ainda Not connected, porque ainda não comunicou a sua ligação —, o portal informa-o de que não há ligação com a fechadura e guarda a alteração em espera em vez de falhar:

• O cartão da chave fica cinzento com um distintivo Pending e mostra o que está em espera — adição, remoção ou atualização.
• A única ação disponível num cartão pendente é Cancel, que retira a alteração em espera e devolve a chave ao seu estado anterior.
• Assim que a fechadura volta a estar online, as alterações em espera são aplicadas automaticamente, pela ordem em que as fez. Cada uma aparece duas vezes nos registos de auditoria: uma vez quando foi colocada em fila e outra quando foi efetivamente executada.
• Depois de as alterações serem aplicadas, vê uma janela pop-up única, como «A fechadura 999 voltou a ficar online às 12:45 21/08/2026», com o número de chaves adicionadas, removidas ou atualizadas. Se nada tiver sido colocado em fila enquanto a fechadura esteve offline, não aparece nenhuma janela pop-up.

Uma fechadura cuja acessibilidade ainda é Not connected é tratada exatamente como uma fechadura offline: a alteração fica em espera como Pending e é aplicada quando a fechadura comunica pela primeira vez que está online. Só uma fechadura apresentada como Online recebe o comando imediatamente.

Os cartões NFC físicos seguem a mesma regra. Um cartão gravado para uma fechadura offline é escrito no leitor como habitualmente; só o seu registo na fechadura fica em espera, e a coluna Delivered das listas de Physical Keys mostra Pending em vez de Delivered até a fechadura voltar a ficar online. Cancelar esse registo pendente revoga o cartão: um cartão gravado que a fechadura nunca chegou a conhecer não a consegue abrir.

As chaves de convidado são a exceção: o SmartKey guarda-as na nuvem e não na fechadura, pelo que uma chave de convidado é criada, atualizada ou eliminada de imediato, seja qual for o estado da ligação da fechadura (ver 12).

Criar e gerir chaves de convidado temporárias

Utilize uma chave de convidado temporária para acesso de visitantes com duração limitada.

As chaves de convidado não esperam pela fechadura (ver 11.8): o SmartKey guarda-as na nuvem, pelo que criar, atualizar ou eliminar uma chave de convidado tem efeito de imediato, mesmo numa fechadura Offline ou Not connected.

12.1 Criar uma chave de convidado

1. Abra Devices → Locks e clique no botão Guest Key na fechadura pretendida (a ação rápida Guest Key no Painel funciona da mesma forma).
2. Escolha o tipo de chave com os dois botões grandes no topo da janela. Link Key (selecionado por predefinição) emite a chave como uma ligação que partilha. Wallet Key emite uma Wallet Key válida durante o período que definir: é enviada para a fechadura como qualquer Wallet Key, por e-mail ao destinatário que escolher abaixo (as opções Max uses e Authorization não se aplicam) e removida da fechadura quando o período termina; na página Keys aparece entre as chaves de convidado como Guest Wallet Key, com o e-mail do destinatário no verso do cartão.
3. Confirme ou selecione a fechadura. Se o seu Objeto atual tiver apenas uma fechadura ativa, esta é selecionada automaticamente.
4. Para conceder acesso a várias fechaduras com uma única chave, ative Multiple locks junto ao seletor de fechadura e assinale todas as fechaduras a incluir. Uma chave partilhada funciona como uma ligação de deslizar para abrir, pelo que as opções de fechadura única abaixo ficam ocultas neste modo.
5. Defina Valid From e Valid Until. Se o início já tiver passado quando clicar no botão de criação, a chave é válida a partir desse momento.
6. *(Apenas fechadura única)* Opcionalmente, defina Max uses.
7. *(Apenas fechadura única e Link Key)* Opcionalmente, ative Authorization para restringir a chave a pessoas específicas e, em seguida, introduza os Authorized emails autorizados a utilizá-la. Com esta opção desativada, qualquer pessoa que tenha a ligação pode utilizá-la dentro do seu período de validade.
8. Para uma Link Key *(apenas fechadura única)*, introduza opcionalmente um destinatário de e-mail para enviar a ligação automaticamente. Para uma Wallet Key (fechadura única ou Multiple locks), escolha o destinatário: o campo abre a lista de utilizadores do Objeto, cuja primeira linha é uma caixa de pesquisa (nome ou e-mail). Se ninguém corresponder, o botão + (Create user) abre um formulário curto — nome e e-mail — e o novo utilizador passa a ser o destinatário; um e-mail que já tem conta adiciona essa pessoa ao Objeto em vez de criar uma segunda conta. Com Multiple locks ativado, o destinatário mantém-se e a Wallet Key é adicionada a cada fechadura selecionada.
9. Clique em Create Guest Key (ou Create Shared Key quando Multiple locks está ativado).

12.2 Partilhar uma chave de convidado

Depois de criar a chave, o painel de resultado mostra a ligação da chave de convidado como um código QR e permite-lhe:

• Tocar no código QR para o virar: o ícone de chave abre a ligação da chave de convidado, o ícone de transferência guarda o código como imagem; toque no mosaico virado (ou na pequena seta no seu canto) para voltar ao código.
• Copiar a ligação da chave de convidado com Copy Link.
• Introduzir um destinatário de e-mail e clicar em Send Email (pode reenviar enquanto a janela estiver aberta).

Para uma chave partilhada (várias fechaduras), o painel de resultado mostra a ligação a copiar e a lista de fechaduras que a chave abre.

12.3 Atualizar uma chave de convidado

1. Abra Keys e localize o cartão da chave de convidado.
2. Clique em Update.
3. Atualize o período de validade.
4. Guarde a alteração.

12.4 Eliminar uma chave de convidado

1. Abra Keys e localize o cartão da chave de convidado.
2. Clique em Delete.
3. Confirme a ação.

12.5 Gerir chaves de convidado partilhadas (várias fechaduras)

Uma chave de convidado partilhada que criou com Multiple locks é apresentada na página Keys como um cartão igual a qualquer outra chave, com Multiple onde um cartão de fechadura única indica a sua fechadura e o número de fechaduras no canto. Segue os filtros do topo da página, pelo que uma chave partilhada revogada fica fora de vista enquanto a página estiver filtrada por Active.

1. Toque no cartão para o virar: o verso indica as fechaduras que a chave abre, o seu estado e a sua validade.
2. No verso, clique em Open para ver a página de acesso de convidado.
3. Clique em Revoke e confirme para desativar a chave partilhada em todas as fechaduras que abrange.

Gerir Wallet Keys

Abra o separador Wallet Keys (em Keys) para consultar a disponibilidade de Wallet Keys.

13.1 Consultar o seu saldo de Wallet Keys

Cada cartão de proprietário mostra:

• Wallet Keys livres (disponíveis)
• Wallet Keys atribuídas
• Total de Wallet Keys
• Um indicador de utilização / estado

13.2 Comprar Wallet Keys

Esta opção está disponível apenas para utilizadores autorizados.

1. Abra o separador Wallet Keys.
2. Clique em Buy Keys.
3. Introduza a quantidade pretendida.
4. Clique em Checkout e conclua o pagamento.

Os Local Admins não podem comprar Wallet Keys. Têm de contactar o seu Community Manager.

13.3 Transferir Wallet Keys

Quando está autorizado a transferir chaves:

1. Abra o separador Wallet Keys.
2. Em Transfer to Local Admin, selecione o destinatário.
3. Introduza a quantidade.
4. Clique em Transfer Keys.

Pode transferir para qualquer administrador do Objeto. Se o destinatário ainda não tiver a função de Local Admin nesse Objeto, essa função é-lhe atribuída como parte da transferência, para que as chaves possam ser utilizadas de imediato.

13.4 De onde vêm as suas Wallet Keys e o que acontece quando se esgotam

O seu plano de subscrição inclui Wallet Keys: 50 com o Professional e 200 com o Enterprise. Pertencem à sua conta, e cada chave que atribui utiliza uma delas.

• Quando restam menos de duas Wallet Keys livres, o portal mostra um aviso assim

que o abre, com um atalho Buy Keys. Fechar o aviso oculta-o; volta a aparecer apenas depois de o seu saldo recuperar e voltar a ficar baixo.

• Se tentar atribuir uma chave sem nenhuma disponível, o portal informa-o de que a

sua subscrição não tem Wallet Keys livres e oferece Buy Wallet Keys logo na mensagem.

• Os Local Admins não veem um botão de compra. É-lhes pedido que contactem o seu

Community Manager, que lhes transfere Wallet Keys.

Programar chaves físicas NFC

Abra o separador Physical Keys (em Keys) para programar e revogar cartões NFC físicos. O separador tem duas vistas, alternadas com os botões Assigned / Unassigned por cima da lista:

• Assigned — os cartões que as pessoas têm na sua posse. Pode filtrar a lista por fechadura e por estado (Programmed, Pending, Draft, Failed, Revoked). Um cartão é listado a partir do momento em que é preparado, pelo que um cartão cuja gravação nunca foi confirmada continua visível e pode ser concluído ou reprogramado mais tarde. A coluna Delivered indica se a fechadura recebeu a chave: Delivered, ou Pending enquanto a fechadura estiver offline (ver 11.8).
• Unassigned — cartões gravados antecipadamente que ainda ninguém tem (ver 14.4). O botão mostra quantos estão à espera.

Antes de começar, confirme que está disponível um leitor programador ou o programador integrado de uma fechadura.

14.1 Programar uma nova chave física

1. Abra o separador Physical Keys.
2. Clique em Flash key para abrir o Physical Key Wizard.
3. Passo 1 — Selecione a fechadura e o utilizador. O campo de utilizador é uma caixa de pesquisa: comece a escrever um nome ou e-mail e a lista por baixo vai-se reduzindo à medida que escreve; cada entrada indica ainda quantas chaves físicas a pessoa já tem nessa fechadura. Assinale Show address por baixo do campo para ver a morada de cada pessoa por cima do nome e pesquisar também por morada — o estado inicial segue Settings → Defaults (ver 23.5).
4. Passo 2 — Selecione o dispositivo de programação (ou mantenha Use lock built-in programmer).
5. Inicie a gravação com o botão do tipo de cartão correspondente: Flash MIFARE Classic ou Flash DESFire EV3.
6. Encoste o cartão NFC ao programador quando lhe for pedido.
7. Aguarde a indicação do dispositivo.
8. Clique em Done no portal.
9. Confirme que o cartão aparece como programado.

Se a fechadura estiver offline durante a gravação, o assistente avisa: o cartão é gravado na mesma e a fechadura fica a conhecê-lo automaticamente assim que voltar a ficar online. Até lá, a chave aparece como Pending na página Keys e como Pending na coluna Delivered da lista de Physical Keys (ver 11.8). O dispositivo que grava o cartão é outra questão: quando o dispositivo de programação escolhido (ou o programador integrado da própria fechadura) aparece como Offline, o assistente para antes de fazer o que quer que seja e informa que a gravação não está disponível porque esse dispositivo está offline — escolha um programador acessível ou aguarde que o dispositivo volte.

O tipo de cartão escolhido (MIFARE Classic ou DESFire EV3) é guardado com a chave e apresentado no seu cartão de chave e na coluna Type da lista Physical Keys.

14.2 Apagar e reprogramar um cartão

Ao reprogramar, o assistente executa um passo de apagamento seguido de um passo de gravação.

1. Inicie o assistente de programação como descrito acima.
2. Siga o passo de apagamento: encoste o cartão e, em seguida, clique em Done.
3. Siga o passo de gravação: encoste o cartão novamente e, em seguida, clique em Done.

14.3 Revogar uma chave física

1. Abra o separador Physical Keys.
2. Localize o cartão.
3. Clique na ação de revogação.
4. Opcionalmente, introduza um motivo de revogação.
5. Confirme a ação.

14.4 Chaves não atribuídas: gravar cartões antecipadamente

Mude o separador Physical Keys para Unassigned para gravar um stock de cartões antes de saber quem os vai ter e entregá-los mais tarde. Cada chave não atribuída é listada com um nome de chave composto pela fechadura, pelo dia da gravação e por um número sequencial que continua a partir do último cartão gravado para essa fechadura, seja qual for o dia: `229/260914/1` é o primeiro cartão gravado para a fechadura 229, em 14 de setembro de 2026, `229/260914/3` o terceiro, e o cartão seguinte, gravado um dia depois, é `229/260915/4`. A lista mostra também a fechadura, o UUID, se a fechadura recebeu a chave (Delivered: Delivered ou Pending), o tipo de cartão, o estado, quando o cartão foi gravado e por quem. As chaves não atribuídas aparecem apenas aqui — não nas páginas Keys ou Users, nem nos mosaicos do Dashboard. A lista mostra 50 chaves por página — as ligações de página por baixo da tabela permitem mudar de página — e a caixa de pesquisa por cima dela encontra chaves por nome da chave, fechadura ou UUID.

Gravar vários cartões de uma só vez

1. Abra Unassigned e clique em Flash unassigned keys.
2. Escolha a fechadura, o tipo de cartão (MIFARE Classic ou DESFire EV3), o dispositivo de programação (ou mantenha Use lock built-in programmer) e o Number of keys. Opcionalmente, introduza um Start number: a primeira chave da série fica com exatamente esse número e as seguintes continuam a partir dele; se ficar vazio, a numeração continua a partir da última chave gravada para a fechadura. É recusado um número inicial cujos nomes de chave já estejam em uso nesse dia. Em seguida, clique em Start flashing.
3. A janela grava um cartão após outro. Para cada cartão, encoste-o ao leitor quando lhe for pedido e clique em Done — um cartão MIFARE Classic é primeiro apagado e depois gravado, exatamente como no fluxo de cartão único (ver 14.2).
4. Depois de cada cartão gravado, clique em Next para passar ao seguinte ou em Abort para parar. Abort termina a execução e indica quantas chaves foram gravadas; um cartão que estava a ser preparado quando interrompeu é descartado.
5. Quando o último cartão estiver concluído, a janela mostra quantas chaves foram gravadas. Fechar a janela antes do fim interrompe a execução da mesma forma.

Se a fechadura estiver offline durante a execução, os cartões são gravados na mesma; o seu registo na fechadura fica em espera na fila offline (ver 11.8) e Delivered mostra Pending para cada um deles até a fechadura voltar a ficar online.

Cada cartão preparado, apagado, gravado e descartado, bem como a própria execução, é registado em Logs.

Atribuir uma chave a um utilizador

1. Faça duplo clique (ou toque duas vezes) na linha, ou clique na ação + da chave.
2. Escolha a pessoa na janela Assign to user — a mesma lista pesquisável de Give Access, com a opção Show address (ver 11.2) — ou clique em Create User para adicionar um. A janela mostra também a fechadura, o tipo de cartão e as chaves que vão ser entregues. Em Also add to locks pode assinalar outras fechaduras que a chave deve abrir (opcional).
3. Clique em Assign. A pessoa passa a ser o titular do cartão, o nome da chave deixa de ser apresentado e a chave é listada com as suas outras chaves físicas em Assigned. As predefinições de chaves físicas de Settings → Defaults aplicam-se como a qualquer cartão recém-emitido, e a atribuição é registada em Logs. Se assinalou outras fechaduras, a chave é depois adicionada a cada uma delas, como com Add to Another Lock; uma fechadura que não tenha podido receber a chave é indicada na janela, e a chave continua atribuída.

Só um cartão totalmente gravado pode ser atribuído; um cartão ainda marcado como Draft, Pending ou Failed só pode ser eliminado. A fechadura não tem de estar online: enquanto estiver offline, a entrega fica em fila e a chave aparece como Pending entre as chaves da pessoa até a fechadura voltar (ver 11.8). Um cartão cuja própria entrega ainda está Pending também pode ser atribuído — o registo pendente passa então para a pessoa. Cancelar uma entrega em fila antes de a fechadura voltar — com Cancel na chave pendente da página Keys ou com a sua ação de revogar — devolve o cartão à vista Unassigned.

Várias chaves de uma vez

Assinale as caixas de verificação das chaves (ou Select all no cabeçalho). Aparece uma barra flutuante com Assign to user para as chaves gravadas da seleção e Delete para todas elas.

Eliminar uma chave

Clique na ação de eliminar da linha (ou em Delete na barra flutuante) e confirme. O cartão é removido da fechadura — enquanto a fechadura estiver offline, a remoção fica em fila e é executada assim que ela voltar a ficar online — e desaparece da lista. Eliminar um cartão cuja entrega ainda está Pending cancela essa entrega em vez disso. A eliminação é registada em Logs.

Gerir fechaduras

Abra Devices → Locks para adicionar, controlar e configurar fechaduras.

15.1 Estados da fechadura

Uma fechadura pode ser apresentada como:

• Unclaimed
• Claiming
• Active
• Inactive
• Error

As ações disponíveis dependem do estado atual. Uma fechadura ativa é o caso normal, pelo que o cartão não mostra nenhum distintivo para ela; todos os outros estados aparecem como um distintivo por baixo do nome da fechadura.

Por baixo do nome da fechadura, o cartão mostra o tipo de fechadura (Matter para uma fechadura que comunica através de um hub Matter) e um indicador de conectividade: Online ou Offline, com base nos eventos de ligação reais da fechadura. Uma fechadura que ainda não comunicou a sua ligação mostra Not connected. O ID, o número de série e o hub da fechadura estão na janela Lock Details (ver 15.14).

Os botões de filtro por cima dos cartões reduzem a lista, cada um com a sua contagem: All, Unclaimed, Online, Offline, Not connected, Inactive e Error. Os três filtros de ligação seguem o indicador de conectividade do cartão. O campo de pesquisa junto aos botões mantém apenas as fechaduras cujo nome contém o que escreve.

15.2 Adicionar uma fechadura

1. Abra Devices → Locks.
2. Clique em Add Lock.
3. Introduza o número de série da fechadura ou clique no ícone de código de barras para ler o número de série com a sua câmara.
4. Introduza o código Matter ou clique no ícone QR para ler o código QR Matter com a sua câmara.
5. Clique em Add.

A fechadura é adicionada ao Objeto atualmente selecionado. A leitura com a câmara requer um dispositivo com câmara e permissão para a utilizar; pode sempre, em alternativa, escrever os valores manualmente.

15.3 Abrir uma fechadura remotamente

1. Abra Devices → Locks.
2. Localize a fechadura ativa.
3. Clique em Open.
4. Na janela de confirmação, reveja o estado e confirme com Open Lock.

O portal mostra primeiro que o comando de abertura foi enviado e depois aguarda que a própria fechadura informe que abriu, o que costuma demorar alguns segundos. Em seguida, vê que a fechadura abriu ou que não confirmou a abertura; nesse caso, verifique se a fechadura está online e tente novamente.

Se o botão estiver temporariamente indisponível, aguarde até ao fim da contagem decrescente antes de tentar novamente.

15.4 Mudar o nome de uma fechadura

1. Abra Devices → Locks.
2. Localize a fechadura.
3. Clique no ícone de lápis (mudar o nome) junto ao nome da fechadura.
4. Introduza o novo nome.
5. Guarde a alteração.

15.5 Definir uma fechadura como leitor programador

Utilize esta opção quando um leitor compatível for utilizado para programar cartões NFC.

1. Abra Devices → Locks.
2. Localize a fechadura pretendida.
3. Abra o menu de ações da fechadura e escolha Lock Details.
4. Abra a página Maintenance — o ícone da chave inglesa na fila de separadores por baixo do título (o título indica que página está aberta).
5. Escolha Set as Programmer (ou Unset Programmer para o desativar).

15.6 Reivindicar uma fechadura

1. Abra Devices → Locks.
2. Localize a fechadura não reivindicada.
3. Abra o menu de ações e escolha Claim Lock.
4. Confirme a ação.

15.7 Desativar uma fechadura

1. Abra Devices → Locks.
2. Localize a fechadura ativa.
3. Abra o menu de ações e escolha Lock Details e, em seguida, abra a página Maintenance (o ícone da chave inglesa).
4. Escolha Deactivate Lock.
5. Confirme com Deactivate.
6. Se a fechadura ainda tiver chaves ativas, a janela indica-o e o botão passa a Force Deactivate: clique nele para colocar a fechadura como inativa na mesma. As chaves continuam associadas e a funcionar até serem revogadas ou a fechadura ser removida (15.9).

15.8 Reativar uma fechadura

1. Abra Devices → Locks.
2. Localize a fechadura inativa.
3. Clique em Reactivate.
4. Confirme a ação.

15.9 Remover uma fechadura

1. Abra Devices → Locks.
2. Localize uma fechadura elegível, não reivindicada ou inativa.
3. Clique em Remove.
4. Leia atentamente o aviso e verifique a lista What will be withdrawn.
5. Confirme com Remove Lock.
6. Mantenha a janela aberta enquanto a remoção decorre: uma barra de estado mostra cada passo. Feche o resumo com Done.

Remover uma fechadura liberta-a da sua conta e, antes disso, é retirado do SmartKey tudo o que foi enviado à fechadura: o acesso de cada pessoa pela aplicação móvel e ao intercomunicador QR, todas as chaves da fechadura (Wallet Keys e outras chaves digitais, cartões físicos, cartões gravados antecipadamente), as chaves de convidado, as chaves de convidado partilhadas que a abrem, os cenários que a utilizam (são eliminados) e as associações a câmaras (as próprias câmaras mantêm-se). Uma chave de convidado partilhada que também abre outras fechaduras é emitida novamente para essas fechaduras; o resumo mostra a sua nova ligação. Se a fechadura estiver offline, as remoções de chaves aguardam que volte a estar online e são então enviadas automaticamente; o acesso pela aplicação móvel e ao intercomunicador QR e as chaves de convidado são retirados de imediato. Depois de tudo retirado, a fechadura continua registada no sistema como um dispositivo não reivindicado sem nenhuma chave — nem as suas chaves integradas —, pelo que pode adicioná-la novamente mais tarde utilizando o seu número de série e o código de emparelhamento.

Se algo não puder ser retirado, a fechadura não é removida: continua inativa na sua conta e o resumo indica o que falhou. Clique novamente em Remove para repetir; o que já foi retirado fica como está. Se a janela tiver sido fechada durante a remoção, Remove propõe Continue the removal.

15.10 Enviar uma fechadura para outro Objeto

1. Abra Devices → Locks.
2. Localize a fechadura.
3. Abra o menu de ações e escolha Send to Another Entity.
4. Selecione o Objeto de destino.
5. Confirme a transferência.

15.11 Remover um utilizador de uma fechadura

1. Abra Devices → Locks.
2. Localize a fechadura.
3. Abra o menu de ações e escolha User List.
4. Localize o utilizador pretendido.
5. Clique em Remove.
6. Confirme a ação.

Isto remove o acesso do utilizador associado a essa fechadura.

O botão Keys no rodapé da janela Users on abre a página Keys filtrada por esta fechadura, para que as mesmas pessoas possam ser consultadas como chaves.

15.12 Ligar uma fechadura ao Wi-Fi

Pode enviar credenciais Wi-Fi para uma fechadura próxima diretamente a partir do portal, por Bluetooth. Isto requer um navegador que suporte Web Bluetooth (por exemplo, Chrome ou Edge num computador ou num dispositivo Android, ou Bluefy – Web BLE Browser num iPhone) e proximidade física da fechadura.

1. Abra Devices → Locks.
2. Localize a fechadura e escolha Configure Wi-Fi.
3. Confirme o pedido do navegador para emparelhar com a fechadura por Bluetooth.
4. Introduza o SSID (nome da rede). Pode clicar em Scan Wi-Fi para pedir à fechadura que procure redes, mas continua a ter de escrever o nome da rede manualmente.
5. Introduza a palavra-passe do Wi-Fi.
6. Clique em Connect Lock to Wi-Fi e aguarde a mensagem de sucesso ou de falha.

A palavra-passe é enviada diretamente para a fechadura por Bluetooth e não é guardada no portal.

15.13 Ligar uma fechadura a um hub Matter

Se o seu Objeto tiver um hub Matter, pode emparelhar uma fechadura reivindicada (leitor) com ele por Thread diretamente a partir do cartão da fechadura. A fechadura continua a funcionar como antes — isto apenas a associa ao hub; o controlo da fechadura continua a passar pelo serviço SmartKey.

1. Abra Devices → Locks.
2. Localize a fechadura e escolha Connect to Matter Hub no seu menu.
3. Escolha o hub. Se o seu Objeto tiver apenas um hub, este é selecionado automaticamente; se ainda não tiver nenhum hub, a janela explica que precisa de reivindicar um hub primeiro.
4. Siga as instruções no ecrã para colocar o leitor em modo de emparelhamento e, em seguida, clique em Next. O código de emparelhamento guardado com a fechadura é utilizado automaticamente; se a fechadura não tiver nenhum, introduza o código de emparelhamento Matter do leitor.
5. Aguarde enquanto o hub emparelha o leitor. Isto pode demorar alguns minutos; a janela mostra o progresso em direto e depois comunica o sucesso, um hub ocupado, um hub offline ou um tempo limite esgotado.
6. Em caso de sucesso, o cartão da fechadura mostra Matter como tipo de fechadura e a janela Lock Details indica o hub.

O cartão mostra Matter como tipo de fechadura enquanto a fechadura estiver ligada através de um hub Matter — incluindo leitores que foram comissionados como dispositivos Matter e movidos automaticamente para Locks; o nome do hub e o sinal Thread são indicados na janela Lock Details. O indicador Online/Offline do cartão segue a ligação que estiver ativa: um leitor que comunica através do hub mostra o estado do lado do hub, e uma fechadura que voltou a LTE ou Wi-Fi segue novamente a sua própria ligação. Quando uma fechadura volta à sua própria ligação LTE ou Wi-Fi, o cartão volta a mostrar o seu próprio tipo (por exemplo, Smart Lock) e a janela Lock Details mostra o hub Matter como Not connected; Matter volta por si só assim que a fechadura voltar a comunicar através do hub.

15.14 Lock Details e o código QR

Escolha Lock Details no menu da fechadura (os três pontos no canto do cartão) para ver tudo o que não está no cartão: o Objeto, o ID de fechadura SmartKey, o número de série, o estado, a ligação (Online/Offline e quando mudou pela última vez), o hub Matter através do qual a fechadura comunica, a localização e as câmaras associadas. A mesma janela abre a partir do botão Lock Details no verso de um cartão de chave (secção 11). A janela muda de página com os ícones por baixo do título — Overview (o ícone de informação), Linked Cameras (o ícone de câmara, para quem gere câmaras) e, se gerir a fechadura, Maintenance (o ícone da chave inglesa) — e o título indica a página aberta, por exemplo «Maintenance — Front Door». A página Maintenance oferece Set as Programmer (15.5), Replace Lock (15.15) e Deactivate Lock (15.7). Na página Linked Cameras associa uma câmara já existente; as câmaras em si são criadas na página Cameras.

Cada fechadura com número de série mostra o seu código de intercomunicador QR no lado direito do cartão — o mesmo código que um administrador imprime a partir das definições da fechadura. Toque no código para virar o mosaico:

• O ícone de câmara abre a página para onde o código conduz, aquela a que um visitante chega ao lê-lo à porta.
• O ícone de transferência guarda um PDF com o nome, o número de série e o código QR da fechadura, pronto a imprimir.

Toque no mosaico novamente para o virar de volta.

15.15 Substituir ou copiar uma fechadura

Utilize esta opção quando uma fechadura é trocada por um dispositivo novo, ou quando uma segunda fechadura deve receber a mesma configuração de uma fechadura existente.

1. Abra Devices → Locks, abra o menu da fechadura e escolha Lock Details.
2. Abra a página Maintenance (o ícone da chave inglesa) e, em seguida, clique em Replace Lock.
3. Escolha a ação com o comutador:
   • Replace — tudo passa para a fechadura de destino; depois, todas as chaves e acessos são removidos da fechadura antiga e a fechadura antiga é desativada. A fechadura de destino assume o nome introduzido em New lock name — o nome da fechadura antiga, salvo se o alterar — e, se assumir esse nome, a fechadura antiga é renomeada com "(replaced)".
   • Copy — tudo é adicionado também à fechadura de destino; a fechadura antiga fica como está.
4. Selecione a Target lock — uma fechadura ativa do mesmo Objeto — ou clique em Add a new lock e introduza o número de série e o Código Matter do novo dispositivo: a fechadura é reivindicada de imediato e selecionada como destino.
5. Verifique o campo New lock name — o nome que a fechadura de destino terá após a transferência (o nome da fechadura antiga no modo Replace, o nome próprio da fechadura de destino no modo Copy) — e altere-o se necessário.
6. Reveja a lista What will be transferred e clique em Replace Lock (ou Copy to Lock).

O que é transferido: a localização, a morada e o fuso horário da fechadura, as definições de alertas fora de horas, os utilizadores do portal, os Objetos adicionais, as atribuições de função limitadas à fechadura, a marca de leitor programador, o horário semanal (também enviado para a nova fechadura), todas as chaves com o respetivo titular — Wallet Keys e outras chaves digitais, chaves físicas, acesso ao Intercomunicador QR e chaves de convidado — juntamente com o acesso à aplicação móvel e ao Intercomunicador QR que cada titular tem, as chaves de convidado partilhadas (várias fechaduras) e os cenários que utilizam a fechadura, quando a nova fechadura está ligada ao mesmo hub Matter. No modo Replace, as câmaras associadas passam também para a nova fechadura; uma câmara só pode estar associada a uma fechadura, por isso, no modo Copy, ficam onde estão.

Enquanto a transferência decorre, a janela mostra uma barra de estado com o passo atual e as contagens de passos concluídos, ignorados e falhados; mantenha a janela aberta até terminar. Os comandos de chaves são enviados um de cada vez, com uma pequena pausa entre eles, pelo que uma fechadura com muitas chaves demora alguns minutos. Se a janela for fechada ou a ligação cair a meio, ao reabrir Replace Lock é proposto Continue the transfer a partir do passo em que parou.

No final, um resumo lista o que foi feito, o que foi ignorado e porquê, e qualquer passo que tenha falhado. As chaves de convidado e as chaves de convidado partilhadas são reemitidas na nova fechadura com novas ligações: uma chave de convidado que foi enviada por e-mail é enviada novamente com a sua nova ligação; as outras novas ligações são apresentadas no resumo. Tudo fica registado no separador Logs → Audit: uma entrada Replace Lock / Copy Lock em cada fechadura, além das entradas habituais de chaves, acessos e chaves de convidado.

Configurar o horário semanal da fechadura

Utilize o agendador para definir intervalos de acesso para cada dia da semana.

16.1 Definir o horário

1. Abra Devices → Locks.
2. Localize a fechadura pretendida.
3. Clique em Scheduler.
4. Selecione um dia da semana.
5. Adicione um ou mais intervalos de tempo.
6. Repita para os restantes dias.
7. Guarde o horário. Utilize a opção de guardar que também sincroniza com o dispositivo quando quiser que a alteração seja enviada imediatamente para a fechadura.
8. Quando sincroniza com o dispositivo, o portal mostra até onde a fechadura já chegou enquanto recebe o horário passo a passo. Mantenha o agendador aberto até que este comunique que o horário foi aplicado; se a fechadura parar a meio, o portal indica-lhe qual o passo que falhou.

16.2 Atualizar o estado do horário no dispositivo

1. Abra o agendador da fechadura.
2. Clique na ação de atualização de estado.
3. Aguarde até que o portal termine de carregar as informações do dispositivo.
4. Reveja o horário apresentado no portal.

Gerir hubs

Abra Devices → Hubs para gerir hubs Matter.

O cabeçalho de cada hub mostra dois indicadores: o estado do ciclo de vida do hub (por exemplo, Claimed ou Suspended) e um indicador de conectividade em direto — Online, Offline ou Unknown enquanto o hub ainda não tiver comunicado a sua ligação. O indicador de conectividade reflete os eventos de ligação reais do hub e é independente do estado do ciclo de vida.

17.1 Adicionar um hub

1. Abra Devices → Hubs.
2. Clique em Add Hub.
3. Introduza um nome para o hub, se necessário.
4. Selecione o Objeto.
5. Selecione o proprietário.
6. Introduza o UUID do hub.
7. Clique em Add Hub.

17.2 Atualizar o estado do hub

1. Abra Devices → Hubs.
2. Clique em Refresh.

17.3 Mudar o nome de um hub ou alterar a sua função

1. Abra Devices → Hubs.
2. Localize o hub e abra Edit Hub.
3. Atualize o nome e/ou utilize o interruptor Primary hub para o definir como Primary ou Secondary.
4. Clique em Save.

17.4 Suspender um hub

1. Abra Devices → Hubs.
2. Localize o hub e escolha Suspend.
3. Introduza o motivo.
4. Confirme a ação.

17.5 Reivindicar novamente ou mover um hub

Utilize esta ação para atribuir o hub a outro Objeto ou proprietário elegível.

1. Abra Devices → Hubs.
2. Localize o hub e escolha Re-claim.
3. Selecione o Objeto de destino.
4. Selecione o proprietário.
5. Introduza o motivo.
6. Confirme a ação.

17.6 Comissionar um dispositivo Matter

1. Abra Devices → Hubs e escolha Commission Device, ou abra Devices → Matter e clique em Add Device.
2. Selecione o hub.
3. *(Opcional)* Ative Matter over Wi-Fi se o dispositivo se ligar por Wi-Fi. Em seguida, escolha um Wi-Fi profile guardado, ou introduza um novo Wi-Fi network name (SSID) e a password (pode mostrar ou ocultar a palavra-passe e assinalar Save this network as a reusable Wi-Fi profile para a reutilizar mais tarde neste Objeto). Deixe o interruptor desativado para dispositivos que não precisam de credenciais Wi-Fi.
4. Introduza o código de comissionamento ou leia o código QR Matter com a sua câmara.
5. Clique em Commission. Quando Matter over Wi-Fi está ativado, a janela guarda as credenciais Wi-Fi, aguarda um momento e, em seguida, inicia o comissionamento — o botão mostra Saving Wi-Fi, Preparing commissioning e Commissioning enquanto trabalha.
6. Aguarde que o dispositivo apareça no separador Matter.

Quando Matter over Wi-Fi está ativado: guardar as credenciais Wi-Fi não verifica se a palavra-passe está correta — o dispositivo testa a ligação durante o emparelhamento. Se a gravação da rede Wi-Fi falhar, o comissionamento não é iniciado e pode corrigir a rede e tentar novamente. Se, mais tarde, o dispositivo não conseguir ligar-se à rede, verá uma mensagem a pedir-lhe que verifique o SSID, a palavra-passe, a intensidade do sinal e a acessibilidade da rede.

Se o emparelhamento falhar, o cartão do dispositivo mostra uma breve explicação em linguagem simples (por exemplo, que o dispositivo não respondeu a tempo). Os detalhes técnicos completos do erro continuam disponíveis para os administradores no back office e no registo de eventos do dispositivo.

Se o dispositivo comissionado for um leitor de fechadura SmartphoneKey, pertence à secção Locks e é movido para lá automaticamente: durante cerca de meio minuto, o separador Matter mostra um cartão Transferring to Locks para ele, após o que o dispositivo aparece em Devices → Locks, pronto a utilizar — é reivindicado para o Objeto a que pertence e recebe o nome do leitor. Emparelhar o mesmo leitor novamente mostra o habitual cartão Commissioning… no separador Matter enquanto o processo decorre.

Gerir dispositivos Matter

Abra Devices → Matter para consultar os dispositivos comissionados através de um hub.

18.1 Consultar dispositivos Matter

A lista pode apresentar:

• Nome ou UUID do dispositivo
• Hub
• Objeto
• Tipo de dispositivo
• Estado
• Disponibilidade (Online, Offline ou Unknown até que o dispositivo comunique a sua presença; os dispositivos atrás de um gateway Matter-Zigbee seguem o relatório de acessibilidade do gateway, e todos os dispositivos de um gateway aparecem offline enquanto o próprio gateway estiver offline)
• Utilizador atribuído
• Eventos
• Bateria, sinal, temperatura, humidade, ocupação ou outros valores disponíveis

Cada cartão de dispositivo mostra um ícone correspondente ao seu tipo de dispositivo Matter — o mesmo conjunto de ícones utilizado na aplicação móvel SmartphoneKey. Os dispositivos comutáveis (luzes, tomadas, interruptores) mostram o seu estado On/Off comunicado, e os detetores de fumo mostram o seu estado de alarme, incluindo alarmes recebidos de outros detetores interligados.

Se uma tentativa de emparelhamento falhar, o cartão explica-o brevemente durante algum tempo e a mensagem desaparece depois por si só; a falha permanece em Logs → Activity e nos detalhes do dispositivo durante o tempo que precisar. Emparelhar um dispositivo que já está emparelhado mostra a mesma mensagem passageira.

18.2 Atribuir um dispositivo Matter a um utilizador

1. Abra Devices → Matter.
2. Localize o dispositivo.
3. Clique em Assign.
4. Selecione o utilizador.
5. Confirme a atribuição.

Se o botão estiver desativado, leia a mensagem apresentada pelo portal.

18.3 Remover uma atribuição utilizador-dispositivo

1. Abra Devices → Matter.
2. Localize o dispositivo atribuído.
3. Abra os detalhes da atribuição.
4. Clique em Remove.
5. Confirme a ação.

18.4 Ver eventos do dispositivo

1. Abra Devices → Matter.
2. Localize o dispositivo.
3. Abra os seus eventos ou detalhes.
4. Consulte o histórico de eventos disponível.

18.5 Remover um dispositivo Matter do portal

1. Abra Devices → Matter.
2. Localize o dispositivo.
3. Escolha a ação de eliminar/remover.
4. Confirme a ação.

Para um dispositivo Matter, o portal pede primeiro ao hub que desemparelhe o dispositivo e, em seguida, elimina o seu registo. Os dispositivos ligados através de um gateway Zigbee não podem ser desemparelhados remotamente: apenas o registo do portal é eliminado, e o dispositivo continua emparelhado com o seu gateway até ser reposto.

Enquanto a remoção estiver em curso, a ação mostra Removing e não pode ser iniciada novamente: o desemparelhamento demora alguns segundos, e não se deve pedir ao hub que desemparelhe o mesmo dispositivo duas vezes.

Remover um gateway remove também todos os dispositivos Zigbee ligados através dele — esses dispositivos só são acessíveis através do seu gateway. A janela de confirmação indica o gateway e informa quantos dispositivos ligados o acompanham. Eliminar um hub funciona da mesma forma: todos os dispositivos nele comissionados, incluindo os gateways e os dispositivos Zigbee atrás deles, são removidos com ele.

Importante: remover o dispositivo do portal pode não repor as definições de fábrica do dispositivo físico. Reponha-o ou desative-o separadamente, quando necessário.

18.6 Controlar um dispositivo Matter

Alguns dispositivos Matter podem ser controlados a partir do portal quando a sua função o permite e o dispositivo o suporta.

1. Abra Devices → Matter.
2. Localize o dispositivo.
3. Utilize o controlo apresentado no cartão do dispositivo:
   • Um botão (por exemplo, para ligar ou desligar o dispositivo).
   • Um controlo deslizante, para dispositivos que suportam um nível (como o brilho). O controlo deslizante reflete o nível comunicado pela última vez pelo dispositivo, e o cartão mostra a percentagem de brilho enquanto o dispositivo está ligado.

Os controlos aparecem apenas para dispositivos que comunicam uma funcionalidade controlável; os outros dispositivos mostram o seu estado atual sem controlo.

18.7 Inverter a apresentação Open/Closed de um sensor de contacto

Utilize esta opção quando um sensor de contacto comunica Open e Closed de forma contrária à sua montagem.

1. Abra Devices → Matter.
2. Localize o dispositivo sensor de contacto e abra Edit.
3. Ative Invert Open/Closed display.
4. Guarde a alteração.

O portal troca então as etiquetas Open e Closed desse dispositivo, para que o estado apresentado corresponda à porta ou à janela.

18.8 Dispositivos Zigbee atrás de um gateway Matter-Zigbee

Alguns dispositivos Matter são gateways que fazem a ponte para dispositivos Zigbee (por exemplo, um hub Matter-Zigbee). Depois de um gateway deste tipo ser comissionado, o portal mostra-o como um sub-hub: um cabeçalho ao estilo de hub aninhado sob o seu hub principal, com a sua própria disponibilidade, painel de detalhes e ações.

• Os dispositivos Zigbee ligados ao gateway são listados sob o cabeçalho do gateway, separados dos dispositivos comissionados diretamente no hub.
• Quando um novo dispositivo Zigbee se liga ao gateway, aparece automaticamente sob o gateway — não é necessário nenhum passo de comissionamento adicional no portal.
• Os dispositivos Zigbee que já estavam ligados ao gateway são detetados automaticamente à medida que comunicam o seu estado.
• A janela de informação de um dispositivo Zigbee mostra o seu gateway e o seu endpoint Zigbee.
• O gateway comunica o fabricante, o modelo, o número de série e o nome configurado no gateway de cada dispositivo Zigbee; o portal preenche estes detalhes automaticamente (um nome que tenha definido no portal nunca é substituído).
• O indicador Online/Offline de um dispositivo Zigbee segue o relatório de acessibilidade do gateway para esse dispositivo; enquanto o próprio gateway estiver offline, todos os seus dispositivos Zigbee são apresentados como offline.
• Remover o gateway do portal remove também os seus dispositivos Zigbee, porque estes só existem no portal através do seu gateway.
• Um gateway só pode ser adicionado a um hub de cada vez. Se ainda estiver adicionado a outro hub, o emparelhamento é recusado e o cartão pede-lhe que o remova primeiro desse hub — os seus dispositivos Zigbee permanecem com esse hub, pelo que, caso contrário, ficariam lá abandonados.

Gerir câmaras

Abra Cameras (o separador Cameras) para adicionar e gerir câmaras. Pode filtrar por estado e escolher a densidade da grelha.

19.1 Adicionar uma câmara

1. Abra Cameras.
2. Clique em Add Camera.
3. Introduza o nome da câmara.
4. Selecione o tipo de câmara.
5. Selecione o Objeto.
6. Selecione o proprietário, se necessário.
7. Introduza os detalhes de ligação necessários:
   • Para uma câmara RTSP, introduza o URL RTSP.
   • Para uma câmara HTTP, introduza o URL HTTP.
   • Para uma câmara Push Module, introduza o código de registo impresso na câmara (ou fornecido pelo seu push module), juntamente com o nome de utilizador e a palavra-passe de administrador.
   • Para outros tipos de câmara suportados, introduza o nome de utilizador e a palavra-passe necessários.
   • Sempre que o formulário mostrar o campo do URL RTSP, colar a ligação completa (por exemplo, `rtsp://login:password@192.168.1.10:554/stream?channel=1`) preenche a partir dela o nome de utilizador, a palavra-passe, o URL HTTP e um nome de câmara; o que tiver escrito por si é mantido.
8. Opcionalmente, selecione uma fechadura associada do mesmo Objeto (as câmaras Push Module podem ser associadas a uma fechadura depois de criadas).
9. Clique em Create.

Para uma câmara RTSP, o formulário tem ainda a secção Camera access, para que a câmara possa ser partilhada com utilizadores logo ao ser criada: escolha a pessoa no campo de utilizador — a mesma caixa de pesquisa de Manage access (ver 19.9), com a linha da morada quando Show the address when choosing a user está ativo — e clique no botão com o sinal de mais; repita para cada pessoa. Quando a subscrição inclui a opção Video archive, assinale Add a manager role antes de adicionar alguém para lhe dar a função Manager (vídeo em direto e gravações) em vez de Viewer (apenas vídeo em direto). A lista por baixo do campo mostra quem vai receber acesso e com que função, com uma cruz para remover alguém.

19.2 Ver a transmissão de uma câmara

1. Abra Cameras. Cada mosaico mostra o último fotograma da sua câmara, por isso a página diz o que cada uma vê antes de abrir seja o que for. Uma câmara que nunca enviou um fotograma mantém o marcador de posição.
2. Clique na câmara para abrir a sua janela. O leitor mostra esse mesmo último fotograma, com a data, até iniciar o vídeo.
3. Prima Play Live para ver a imagem em direto.

A janela tem um único leitor. Uma gravação do bloco Archive é reproduzida nele e o título do bloco muda de Live Video para Archive; Play Live traz o direto de volta.

19.3 Atualizar uma câmara

1. Abra Cameras.
2. Localize a câmara.
3. Clique em Edit.
4. Atualize os campos necessários.
5. Clique em Save.

19.4 Associar uma câmara a uma fechadura

1. Abra Cameras.
2. Localize a câmara.
3. Clique em Link.
4. Selecione uma fechadura ativa do mesmo Objeto.
5. Confirme a ação.

19.5 Desassociar uma câmara de uma fechadura

1. Abra Cameras.
2. Localize a câmara.
3. Escolha a ação de desassociação.
4. Confirme a ação.

19.6 Desativar uma câmara

1. Abra Cameras.
2. Localize a câmara.
3. Escolha Disable.
4. Introduza o motivo.
5. Confirme a ação.

19.7 Eliminar uma câmara

1. Abra Cameras.
2. Localize a câmara.
3. Escolha Delete.
4. Confirme a ação.

19.8 Iniciar ou parar a transmissão de uma câmara RTSP

1. Abra Cameras.
2. Localize a câmara RTSP.
3. Abra o seu menu de ações.
4. Escolha Start stream ou Stop stream.

19.9 Partilhar o acesso a uma câmara RTSP

Cada pessoa com quem partilha uma câmara recebe uma de duas funções:

• Viewer — vê o vídeo em direto.
• Manager — vê o vídeo em direto e o vídeo gravado (o arquivo).

A função Manager faz parte da opção Video archive da subscrição, tal como a própria gravação (ver 19.11). Sem a opção, todas as pessoas com quem partilha a câmara são Viewer, e a janela indica que os gestores requerem a opção.

1. Abra Cameras.
2. Localize a câmara RTSP.
3. Escolha Manage access.
4. Para partilhar a câmara como Manager, assinale Add a manager role; deixe-a por assinalar para um Viewer.
5. Selecione o utilizador: o campo de utilizador é uma caixa de pesquisa; comece a escrever um nome, e-mail ou telefone e a lista por baixo vai-se reduzindo à medida que escreve. Quando Show the address when choosing a user está ativo em Settings → Defaults (ver 23.5), a morada de cada pessoa é mostrada por cima do nome e também pode ser pesquisada.
6. Adicione o utilizador para partilhar o acesso.
7. Para alterar a função de alguém que já tem acesso, escolha Viewer ou Manager junto ao seu nome.
8. Para remover o acesso, revogue-o junto ao utilizador.

Para partilhar a câmara de uma só vez com todas as pessoas que vivem numa morada, ative Grant by address: escolha a morada, mantenha os residentes pré-selecionados (todas as pessoas dessa morada começam assinaladas — desmarque quem quiser excluir) e adicione-os de uma só vez. A caixa Add a manager role também se aplica a estas pessoas.

Se a subscrição perder a opção Video archive, cada Manager passa automaticamente a Viewer e a lista indica que voltará a ser gestor quando a subscrição incluir a opção; quando isso acontecer, recupera a função Manager sem que ninguém tenha de voltar a partilhar a câmara.

19.10 Estado da câmara

Cada mosaico de câmara RTSP tem uma etiqueta de estado no canto inferior esquerdo, e a janela da câmara mostra o mesmo estado com a hora em que foi comunicado. O estado é o que a caixa de vídeo comunica sobre a câmara neste momento:

• Live — a câmara está a transmitir.
• Ready — ninguém está a ver, por isso a caixa colocou o vídeo em pausa; volta a arrancar no primeiro Play Live. É uma câmara saudável.
• Connecting / Restarting — a caixa está a iniciar o vídeo; aguarde um momento.
• Picture frozen / No picture — a caixa não recebe vídeo utilizável da câmara; verifique a câmara e os seus dados de ligação.
• Setting up — uma câmara que acabou de adicionar está a ser ligada a uma caixa de vídeo; normalmente demora menos de um minuto. Se terminar em Setup failed, o motivo é mostrado com um botão Retry.
• Reconnecting — a caixa de vídeo da câmara acabou de reiniciar; a câmara volta sozinha dentro de poucos minutos.
• Not placed / Not running — a câmara não está em nenhuma caixa de vídeo, ou a sua caixa não a está a executar; prima Retry para a iniciar de novo.
• Video box silent — a caixa de vídeo deixou de comunicar; a imagem pode ficar indisponível até que volte.
• Stopped — a transmissão foi parada com Stop stream; escolha Start stream para a retomar (ver 19.8).

Qualquer outro valor é mostrado exatamente como a caixa o comunica. A hora junto ao estado («há 5 min») indica quando a caixa comunicou pela última vez; a pré-visualização na janela da câmara é o último fotograma captado e tem indicada a sua antiguidade. Os estados atualizam-se sozinhos enquanto a página Cameras está aberta: o serviço de vídeo comunica cada alteração assim que acontece, por isso não é preciso recarregar a página.

19.11 Gravar vídeo de uma câmara RTSP

A gravação faz parte da opção Video archive de um pacote de subscrição (3, 7, 14 ou 30 dias). Sem a opção, o bloco Recording da janela da câmara está bloqueado e Unlock abre a página da subscrição.

1. Abra Cameras e abra a câmara RTSP.
2. No bloco Recording, escolha durante quanto tempo o vídeo gravado é mantido — Off ou um número de dias até ao que o seu pacote permite — e clique em Save.
3. A gravação precisa de uma transmissão em curso: se a câmara estiver parada ou ainda a ser configurada, inicie-a primeiro com Start stream.

Se o arquivo já contiver mais dias do que os que vai manter, o portal avisa-o antes de guardar e oferece duas saídas: manter tudo (a retenção é aumentada para cobrir o arquivo) ou eliminar o vídeo mais antigo e manter o período mais curto. Desligar a gravação não elimina nada: o vídeo já gravado mantém-se até expirar. O mosaico de uma câmara a gravar mostra uma etiqueta vermelha com o número de dias. Se a câmara já gravava quando o pacote perdeu a opção, o bloco bloqueado indica os dias que ainda conserva e oferece Turn recording off.

19.12 Ver vídeo gravado (arquivo)

O arquivo faz parte da mesma opção Video archive que a gravação. Quando o seu pacote a inclui, a janela de uma câmara RTSP tem um bloco Archive por baixo de Recording.

1. Abra Cameras e abra a câmara RTSP.
2. No bloco Archive, escolha um dia. A barra por baixo são as 24 horas desse dia: os troços verdes são vídeo gravado e os intervalos vazios o tempo em que nada foi gravado (a transmissão estava parada, a câmara estava em espera ou o vídeo expirou).
3. Clique num momento da barra. O leitor começa nesse momento; um clique num intervalo vazio começa no troço gravado seguinte.

A reprodução decorre em janelas de até uma hora e continua sozinha com o troço seguinte do dia; o cursor vermelho na barra acompanha a posição. Stop termina a reprodução. A gravação é reproduzida no leitor da janela, cujo título passa a Archive enquanto isso. Cada janela vista fica registada em Logs. Os dias e as horas seguem o relógio do seu computador, e o arquivo recua tantos dias quantos o pacote conserva.

Gerir funções de câmara

As funções de câmara definem que utilizadores podem aceder a determinadas câmaras e o que estão autorizados a fazer.

20.1 Criar uma função de câmara

1. Abra Cameras.
2. Abra o separador Camera Roles.
3. Clique em Create Role.
4. Introduza o nome da função.
5. Introduza a descrição.
6. Selecione o Objeto.
7. Clique em Create Role.

20.2 Adicionar uma câmara a uma função

1. Abra a função de câmara pretendida.
2. Clique em Add Camera.
3. Selecione uma câmara do mesmo Objeto.
4. Selecione pelo menos uma permissão.
5. Clique em Add.

20.3 Remover uma câmara de uma função

1. Abra a função de câmara.
2. Localize a câmara.
3. Escolha Remove.
4. Confirme a ação.

20.4 Atribuir um utilizador a uma função de câmara

1. Abra a função de câmara pretendida.
2. Clique em Add User.
3. Selecione um utilizador do mesmo Objeto.
4. Confirme a atribuição.

20.5 Remover um utilizador de uma função de câmara

1. Abra a função de câmara.
2. Localize o utilizador.
3. Escolha Remove.
4. Confirme a ação.

20.6 Eliminar uma função de câmara

1. Abra o separador Camera Roles.
2. Localize a função.
3. Escolha Delete.
4. Confirme a ação.

Consultar os registos de atividade (Activity)

Abra Logs → Activity para consultar os eventos de acesso.

21.1 Monitorização de rotina

Por predefinição, a lista de atividade centra-se nos eventos de acesso mais relevantes, tais como:

• Chave aceite
• Fechadura destrancada
• Abertura não confirmada
• Chave adicionada à fechadura
• Chave removida da fechadura

Uma abertura remota só aparece como Lock Unlocked depois de a própria fechadura informar que abriu. Até lá, e se a fechadura nunca a confirmar, o pedido aparece como Open Not Confirmed, juntamente com a pessoa que o enviou.

21.2 Detalhes avançados

Ative o interruptor Advanced na barra de filtros quando precisar de informações mais detalhadas sobre os eventos.

21.3 Filtrar os registos de atividade

Os filtros disponíveis podem incluir:

• Fechadura
• Tipo de evento
• Intervalo de datas (de / até)
• UUID da chave
• E-mail do utilizador
• Localização
• Interruptor Advanced

Aplique os filtros para atualizar a lista.

A caixa Search acima dos filtros encontra eventos com um único termo: o nome, o e-mail, o telefone ou a morada de um utilizador, um UUID (do dispositivo, do utilizador ou da chave) ou o nome ou o número de série de um dispositivo. Um telefone ou uma morada também correspondem apenas pelos seus dígitos. Prima Enter, clique no botão de pesquisa ou em Apply Filters para executar a pesquisa; o × limpa-a. A pesquisa combina-se com os outros filtros, restringe as respetivas listas pendentes e aplica-se a Export CSV.

21.4 Exportar os registos de atividade

1. Abra Logs → Activity.
2. Aplique os filtros pretendidos.
3. Clique em Export CSV.
4. Guarde o ficheiro.

Consultar os registos de auditoria (Audit)

Abra Logs → Audit para consultar as ações administrativas realizadas no portal.

Cada linha mostra quem realizou a ação (Performed by) e a quem dizia respeito (Target user, com o e-mail ou o telefone da pessoa). Filtre por um utilizador-alvo para seguir o histórico de uma pessoa: quando foi criada, quando lhe foi emitida uma Wallet Key ou uma chave física ou adicionada a outra fechadura, e quando o acesso à aplicação móvel ou ao Intercomunicador QR foi concedido ou removido. As adições de chaves que foram recusadas ou falharam, incluindo cada fechadura de uma adição a várias fechaduras, aparecem como linhas com o estado Failed e o motivo. Se a pessoa for eliminada mais tarde, as linhas que lhe dizem respeito mantêm-se e continuam a mostrar o seu nome e contacto, marcados como eliminados, para que o seu histórico permaneça completo.

Os dispositivos Matter também ficam aqui registados. É escrita uma linha Matter Device Commissioning por cada tentativa de adicionar um dispositivo a um hub: fica pendente enquanto o hub emparelha o dispositivo e passa depois a concluída com o nome do dispositivo, ou a falhada com o motivo indicado pelo hub — também quando o hub nunca respondeu ou quando a tentativa foi recusada porque o hub estava ocupado ou offline ou a Hub API não aceitou o comando. É escrita uma linha Matter Device Removed por cada dispositivo retirado de um hub, incluindo os dispositivos Zigbee removidos juntamente com o seu gateway, e uma linha Matter Device Joined por cada dispositivo Zigbee que apareceu através de um gateway.

22.1 Filtrar os registos de auditoria

Os filtros disponíveis podem incluir:

• Pesquisa (pela pessoa que realizou a ação, pelo nome, e-mail ou telefone do utilizador-alvo, ou pela descrição)
• Tipo de operação
• Estado
• Fechadura
• Realizada por
• Utilizador-alvo
• Intervalo de datas (de / até)

22.2 Ordenar e paginar os resultados

1. Clique no título de uma coluna ordenável (Timestamp, Operation, Status) para ordenar.
2. Selecione o número de linhas por página, se necessário.
3. Utilize os controlos de paginação para se deslocar entre páginas.

22.3 Ver detalhes

1. Localize a operação pretendida.
2. Clique na linha para abrir os seus detalhes.
3. Consulte as informações disponíveis, incluindo o utilizador-alvo e, para uma ação falhada, o motivo.

22.4 Exportar os registos de auditoria

1. Aplique os filtros pretendidos.
2. Clique em Export CSV.
3. Guarde o ficheiro. A exportação inclui as colunas Performed By, Target User e Target Contact.

Definições (Settings)

Abra Settings para gerir o seu perfil, a subscrição, as notificações, os pedidos de acesso, a faturação e o seu feedback à equipa SmartphoneKey (ver a secção 34). Cada área é um separador no topo da página.

23.1 Atualizar o seu perfil

1. Abra Settings → Profile.
2. Atualize o seu nome completo, telefone ou telemóvel.
3. Clique em Save.

O seu endereço de e-mail é apresentado, mas não pode ser alterado a partir desta página.

23.2 Subscrição e pacotes

1. Abra Settings → Subscription.
2. Reveja o seu plano atual e o seu estado.
3. Em Available Packages, consulte os pacotes de subscrição oferecidos para a sua conta. Os pacotes que vê dependem da sua função; cada cartão mostra o preço, o período de faturação e tudo o que o pacote inclui.
4. Clique em Buy num pacote para abrir o checkout: abre-se uma página de encomenda normal, onde paga com o método de pagamento configurado pelo seu operador. Após o pagamento, as funcionalidades e os limites do pacote aplicam-se à sua conta.

Base Access. Todos os proprietários de fechaduras têm a subscrição Base Access: histórico de acessos com registos e auditoria, chaves de convidado, até 10 utilizadores e a página Matter Devices. Quando reivindica a sua primeira fechadura, o primeiro ano é gratuito — uma mensagem de boas-vindas no portal lembra-o de a ativar. Para ativar, clique em Add payment method no separador Subscription e guarde um cartão na página de pagamento que se abre; o sistema de pagamento executa uma verificação normal do cartão e a subscrição é ativada logo a seguir. Se a faixa de ativação continuar a ser apresentada depois de ter adicionado o cartão, clique em Check activation.

Uma semana antes do fim de uma subscrição de duração fixa, o portal mostra um lembrete único; renove o pacote em Available Packages para manter o seu acesso sem interrupção.

Se a sua conta utilizar o plano Managed Access Control Service (parceiro), o separador mostra também uma secção Add-ons com o Resident Digital Access Package. O complemento adiciona 2 chaves Apple / Google Wallet por apartamento, chamadas de intercomunicador para a aplicação móvel e chaves de convidado. Para o comprar, clique no botão de compra — a loja abre com o complemento, onde define o número de apartamentos e conclui o checkout. O complemento requer uma subscrição Managed Access Control Service ativa.

23.3 Consultar a utilização

O separador Subscription mostra também medidores de utilização para Objetos, fechaduras e utilizadores.

Preste atenção aos indicadores de aviso quando estiver perto de um limite.

23.4 Configurar notificações

1. Abra Settings → Notifications.
2. Ative ou desative os interruptores disponíveis:
   • Key Pool Alerts
   • Lock Activity
   • Subscription Reminders

As alterações entram em vigor quando alterna cada opção.

23.5 Definir o comportamento predefinido

1. Abra Settings → Defaults.
2. Para cada item, escolha Use default (manter a definição de toda a empresa), On ou Off. A sua escolha aplica-se apenas às suas próprias ações.
3. Em Grant access defaults, decide o que é entregue juntamente com uma chave:
   • Grant Mobile App access e Grant Intercom access — aplicados quando atribui uma Wallet Key. Ambos estão ativados por predefinição.
   • Give a physical key with Mobile App access e Give a physical key with Intercom access — aplicados quando emite uma chave física. Ambos estão desativados por predefinição, porque um cartão físico abre a fechadura por si só e não inclui nenhum dos dois tipos de acesso, a menos que o solicite.
4. Em Display, decide o que o portal mostra:
   • Show the Physical Keys column on the Users page — desativado por predefinição. Ative-o para adicionar uma coluna que conta os cartões físicos que cada pessoa possui (ver 9.3).
   • Show the address when choosing a user — desativado por predefinição. Ative-o para mostrar a morada de cada pessoa por cima do nome ao escolher um utilizador no assistente Assign Key (onde também define o estado inicial de Show address, ver 11.2) e na janela Manage access de uma câmara (ver 19.9), e para pesquisar aí por morada.
5. Na secção de e-mail, cada evento envia a sua mensagem apenas quando está aqui ativado (todos desativados por predefinição) — incluindo o e-mail de boas-vindas que um utilizador recém-criado recebe (ver 9.1).
6. Clique em Save.

23.6 Consultar a faturação

1. Abra Settings → Billing.
2. Consulte as faturas.
3. Abra o PDF de uma fatura a partir da lista.

Se a fatura não puder ser aberta, inicie sessão novamente ou contacte o seu administrador.

Consultar e aprovar pedidos de acesso

Consoante a sua função, poderá receber pedidos de instaladores ou de Community Managers.

24.1 Aprovar um pedido

1. Abra Settings → Access Requests.
2. Em Incoming Requests, localize o pedido.
3. Reveja o tipo de pedido, o Objeto ou a lista de fechaduras, a duração pedida e o motivo.
4. Ajuste a duração da aprovação, se esta opção for apresentada.
5. Clique em Approve.

24.2 Rejeitar um pedido

1. Abra Settings → Access Requests.
2. Em Incoming Requests, localize o pedido.
3. Clique em Reject.
4. Confirme a ação.

24.3 Consultar os pedidos submetidos

Em Settings → Access Requests, consulte a lista Submitted Requests para verificar se o seu próprio pedido está pendente, aprovado ou rejeitado.

Pedir acesso temporário de instalador

Utilize esta página quando precisar de acesso temporário a determinadas fechaduras pertencentes a outro utilizador.

1. Abra a página de pedido de acesso de instalador.
2. Introduza o endereço de e-mail do proprietário.
3. Introduza um ou mais números de série de fechaduras.
4. Introduza a duração pretendida.
5. Introduza o motivo.
6. Submeta o pedido.
7. Aguarde que o proprietário o aprove ou rejeite.
8. Verifique o estado na lista de pedidos submetidos.

Pedir acesso de gestão de Objetos

Os Community Managers elegíveis podem pedir acesso a outro Objeto.

1. Abra a página de pedido de acesso de gestão de Objetos.
2. Introduza o endereço de e-mail do proprietário.
3. Introduza o código do Objeto.
4. Submeta o pedido.
5. Aguarde a aprovação.
6. Verifique o estado na lista de pedidos submetidos.

Resolução de problemas

Falta uma secção do menu

A secção pode não estar incluída na sua função. Contacte o seu administrador se considerar que precisa de acesso.

São apresentados dados do Objeto errado

Utilize o seletor de Objeto e escolha o Objeto correto. Aguarde que a página seja atualizada.

Um botão está desativado

Leia a mensagem apresentada pelo portal. A ação pode exigir:

• Uma função diferente
• Um utilizador ativo
• Uma fechadura ativa
• Wallet Keys disponíveis
• Um estado de dispositivo válido
• Um Objeto selecionado
• Um passo prévio concluído (por exemplo, uma fechadura tem de ter chaves antes de os botões de acesso aparecerem)

Uma ação remota na fechadura falha

Verifique o estado da fechadura e a hora da última atividade. Tente novamente após o fim da contagem decrescente se o portal bloquear temporariamente comandos repetidos.

Um cartão físico não é programado corretamente

Confirme que:

• A fechadura e o utilizador corretos estão selecionados.
• O dispositivo programador correto está selecionado.
• Foi escolhido o tipo de cartão correto (MIFARE Classic ou DESFire EV3).
• O cartão foi encostado ao programador.
• Clicou em Done após a indicação do dispositivo.

Uma fatura não abre

Inicie sessão novamente e tente de novo. Se o problema persistir, contacte o seu administrador.

Lista de verificação rápida para um novo administrador

1. Registe a sua conta e reivindique a primeira fechadura.
2. Inicie sessão no SPK Portal.
3. Confirme o Objeto atual.
4. Reveja o Painel.
5. Crie Objetos adicionais, se necessário.
6. Adicione Local Admins.
7. Crie utilizadores.
8. Adicione fechaduras (Devices → Locks) e hubs (Devices → Hubs).
9. Atribua Wallet Keys, acesso ao Intercomunicador QR ou chaves físicas.
10. Configure horários de fechadura, se necessário.
11. Adicione dispositivos Matter e câmaras, se forem utilizados.
12. Consulte os registos de atividade e de auditoria.
13. Configure as notificações.
14. Consulte regularmente a utilização e o saldo de Wallet Keys.

Notas importantes

• As secções disponíveis dependem da sua função e das suas permissões.
• Confirme sempre o Objeto selecionado antes de fazer alterações.
• Leia atentamente as mensagens de confirmação antes de eliminar recursos.
• Os Local Admins podem receber Wallet Keys, mas não podem comprá-las.
• Remover um dispositivo Matter do portal pode não repor o dispositivo físico.
• Utilize chaves de convidado temporárias para o acesso de visitantes, em vez de chaves de utilizador permanentes.

Assistente de IA (chatbot)

O Assistente de IA opcional responde a perguntas sobre o portal e pode operar os seus dispositivos por si. O administrador do sistema ativa-o globalmente; quando está ativo, aparece no canto inferior direito do SPK Portal um botão com a forma do leitor SmartphoneKey e as letras «AI». Nos telemóveis, o chat abre em ecrã inteiro.

Conversar com o assistente:

1. Clique no botão de chat para abrir o painel do assistente.
2. Escreva a sua pergunta ou pedido e prima Enter (ou clique no botão de enviar).
3. O assistente responde com base neste guia do utilizador e nos dados reais dos seus dispositivos.

Ações em dispositivos. Pode pedir ao assistente que atue sobre os dispositivos disponíveis para si, por exemplo:

• «Abre a fechadura da porta da frente.»
• «Liga a luz do corredor.»
• «Põe a luz da sala a 50%.»

Os comandos são executados imediatamente — o assistente localiza os seus dispositivos, executa a ação pedida e comunica o resultado no chat.

Mais do que controlo de dispositivos. O assistente também pode:

• Criar uma chave de convidado temporária para uma fechadura e enviar a ligação de acesso para o endereço que indicar — p. ex. «Dá uma chave temporária para a porta do escritório durante 3 dias e envia-a para john@example.com»; o assistente diz-lhe se o e-mail foi enviado, e por baixo da resposta é mostrado o código QR da chave com um botão para o guardar.
• Emitir uma Wallet Key de convidado para uma fechadura — p. ex. «Dá uma Wallet Key de convidado para a porta do escritório a anna@example.com durante 24 horas»; o assistente emite a mesma chave que o modo Wallet Key da janela de chave de convidado (secção 12), envia-a por e-mail ao destinatário e mostra o código QR da Wallet Key por baixo da resposta. Se o destinatário ainda não for utilizador do Objeto da fechadura, o assistente pede o nome da pessoa e cria primeiro o utilizador, como faz o formulário + da janela.
• Criar um cenário para os seus dispositivos Matter — p. ex. «Quando o sensor de movimento do corredor detetar movimento, acende a luz do corredor» ou «Acende a luz do alpendre às 18:30 nos dias úteis»; o assistente constrói-o como o editor Simple (secção 31), envia-o para o hub e comunica a resposta do hub. Também pode listar os seus cenários e ligar ou desligar qualquer um.
• Ler os valores dos sensores dos seus dispositivos — p. ex. «Qual é a temperatura na cozinha?»
• Pesquisar o histórico de acessos — p. ex. «Quem abriu a porta hoje entre as 15:00 e as 17:00?»
• Registar uma nova câmara — p. ex. cole uma ligação rtsp:// e o assistente pede os detalhes em falta (como o tipo de câmara) e cria-a.
• Gerir utilizadores — p. ex. «Cria um utilizador Anna Petrenko, anna@example.com», criar utilizadores limitados por telefone, desativar ou reativar um utilizador.
• Conceder e revogar acessos — p. ex. emitir uma chave digital a um utilizador por e-mail, conceder ou revogar o acesso à aplicação móvel e ao intercomunicador, partilhar uma câmara RTSP com um utilizador.
• Registar dispositivos — p. ex. adicionar uma nova fechadura pelo seu número de série e código de emparelhamento, mudar o nome de uma fechadura ou adicionar um dispositivo Matter através de um hub com o seu código de emparelhamento numérico.
• Criar um novo Objeto (organização) com um nome e um código curto.
• Preparar um relatório CSV transferível do histórico de acessos — p. ex. «Quem abriu a porta ontem?» — com um botão de transferência diretamente no chat.

Entrada de voz. Quando a entrada de voz está configurada, aparece um botão de microfone junto à caixa de mensagem. Mantenha-o premido enquanto fala e solte-o para parar — o comando reconhecido é enviado automaticamente ao assistente. Um toque breve não grava; mostra um lembrete para manter o botão premido enquanto fala.

Notas:

• O assistente só vê as fechaduras e os dispositivos a que a sua conta tem acesso, e nunca pode fazer mais do que o que o próprio utilizador poderia fazer no portal.
• O assistente pode estar temporariamente indisponível se o limite mensal de utilização definido pelo administrador tiver sido atingido.

Cenários

A página Scenarios permite que um dispositivo reaja a outro: o seu hub Matter executa os cenários que aqui constrói. Um cenário é um acionador (algo que um dispositivo comunica, ou um momento no tempo) e as ações que o hub executa nos seus dispositivos quando isso acontece.

Onde encontrar. O Scenario Builder não tem entrada no menu principal: abra Devices → Matter Devices e utilize o botão Scenarios no cabeçalho da página. A página faz parte da sua subscrição: fica disponível quando um dos seus pacotes inclui a funcionalidade Scenario editor.

Dois editores. Um novo cenário abre no editor Simple, que funciona exatamente como o construtor de cenários da aplicação móvel; o editor Advanced é a tela de blocos para cenários com vários acionadores, condições, atrasos ou grupos de dispositivos. Alterne entre eles com o controlo Simple / Advanced no cabeçalho do editor: um cenário Simple pode sempre ser aberto no editor Advanced, e um cenário Advanced só volta a Simple enquanto for um acionador e uma ação.

Editor Simple. Dê um nome ao cenário e, em seguida, preencha os dois cartões. When — escolha o dispositivo, o evento que este comunica (contacto, fuga de água, movimento, fumo, estado da fechadura, alimentação, botão, temperatura, humidade, luminosidade, qualidade do ar, bateria, …), a condição (*é*, *não é*, *muda para*; *é superior a*, *é inferior a* ou *é igual a* para medições) e o valor. Then — escolha o dispositivo e o que este deve fazer (ligar, desligar, alternar, trancar, destrancar, abrir ou fechar uma válvula ou um estore, definir o brilho com uma predefinição de 25 / 50 / 75 / 100 %). More settings contém a descrição, o hub, o fuso horário e as definições de execução. Na lista de dispositivos, e nos cartões When / Then depois de escolhido um dispositivo, cada dispositivo tem o ícone e a cor do seu cartão na página Matter Devices.

Editor Advanced. Arraste blocos do painel esquerdo para a tela e ligue-os arrastando da margem direita de um bloco até à margem esquerda de outro; selecione um bloco para o configurar no painel direito.

• Os Triggers iniciam o cenário: um Device event (os mesmos atributos, condições e valores de dispositivo do editor Simple, mais *Outro atributo…* para qualquer atributo que o dispositivo comunique) ou um Schedule (hora e dias da semana).
• Condition é uma proteção opcional com regras que têm de se verificar todas (ou qualquer uma): um atributo de dispositivo, uma janela de tempo, dias da semana ou um intervalo de datas que se repete todos os anos; cada regra pode ser negada com Not.
• Actions são o que o hub faz: um comando de dispositivo (também *Outro comando…* para qualquer comando que o dispositivo aceite, com os seus parâmetros), brilho com uma transição opcional, uma rampa gradual ou um atraso. Um comando pode dirigir-se a um dispositivo ou a um grupo — todas as luzes, todas as tomadas e interruptores. O hub executa as ações uma após outra, pelo que um atraso só pode estar no último de vários ramos.
• Keep until executa as suas ações de saída quando a sua condição se torna verdadeira — por exemplo, manter a tomada do ar condicionado ligada até a divisão arrefecer. O hub recebe-o como um segundo cenário.

As definições do cenário (apresentadas quando nenhum bloco está selecionado) contêm a descrição, o hub, o fuso horário que todas as janelas de tempo, dias e intervalos de datas seguem, o que fazer quando é acionado de novo enquanto está em execução (ignorar, reiniciar as ações, colocar a execução em fila, executar em paralelo), um debounce que volta a verificar a condição antes de agir, um período de arrefecimento entre duas execuções e um tempo limite para toda a lista de ações.

Publicação e a resposta do hub. Validate verifica o cenário e realça os blocos com problemas. Save guarda um rascunho sem tocar no hub. Publish envia o cenário para o hub, que o confirma: o distintivo junto ao nome mostra *A enviar para o hub…*, depois *Em execução no hub* ou *Rejeitado pelo hub* com o motivo do hub. Quando o hub não responde, o distintivo indica-o e Resend envia o cenário novamente. Depois de editar um cenário publicado, este aparece como Modified — o hub mantém a versão anterior até que volte a publicar. O interruptor num cenário ativa-o ou desativa-o no hub sem eliminar nada; Unpublish remove-o do hub e mantém o rascunho.

Notas:

• Os cenários só podem utilizar dispositivos comissionados no mesmo hub; um dispositivo que está a ser removido desaparece do editor.
• As medições são introduzidas em unidades do dia a dia (°C, %, lux); o portal converte-as nas unidades do próprio hub quando envia o cenário.
• O número de blocos, regras e ações é limitado; a validação informa-o quando um limite é atingido.

Configurador de suporte (Support Configurator)

O botão Support na aplicação móvel abre uma página de suporte servida pelo Admin Panel. O que essa página mostra às pessoas que utilizam as fechaduras da sua empresa é definido no back office em Configuration → Support Configurator. Existe uma configuração por empresa, e o menu abre diretamente o registo da sua empresa.

Modos. O modo *Simple* mostra os seus canais de contacto, o horário de funcionamento e um formulário Leave a message que envia um e-mail para o seu endereço de suporte. O modo *Advanced* adiciona um balcão de pedidos para os seus próprios agentes de suporte e um assistente de IA opcional.

Idioma. Support page language está definido como *Follow the user's language* por predefinição: a página abre no idioma em que a aplicação está a funcionar (ou no da conta). Escolha *Fixed language* e um dos idiomas do portal para mostrar a página nesse idioma a todos os utilizadores, independentemente da configuração da sua aplicação.

Separador Contacts. Preencha apenas os canais que utiliza; cada um torna-se um cartão que abre com um toque no telemóvel:

• Emergency phone (24/7) — apresentado em primeiro lugar e marcado como disponível 24 horas por dia.
• Phone e Email.
• WhatsApp, Viber e Signal — um número em formato internacional; a página abre um chat com ele.
• Telegram — um nome de utilizador (por exemplo, `@acme_support`) ou uma ligação `t.me`.
• Facebook Messenger — o nome da página ou uma ligação `m.me`.
• Website / help center — uma ligação para uma página com mais ajuda.
• Office address — abre na aplicação de mapas do telemóvel.

Um valor que não pode tornar-se uma ligação (um nome de utilizador com espaços, um endereço que não seja `http`/`https`) é recusado ao guardar, e a mensagem indica o canal.

Separador Working Hours. Mantenha Show working hours ativado para apresentar o horário semanal juntamente com uma nota Open now / Closed now calculada no fuso horário selecionado. Marque um dia como encerrado ou defina a hora a que abre e fecha.

Separador Message Form. Quando o formulário está ativado, cada mensagem deixada na página é enviada por e-mail para Send messages to (ou para o e-mail de suporte quando esse campo está vazio), com o nome, o e-mail e o telefone do remetente, para que possa responder diretamente. No modo Simple, o formulário precisa de um endereço para onde enviar. Por isso, começa desativado numa empresa sem e-mail na sua ficha de contacto e volta a ativar-se assim que preencher um endereço, ou quando escolher o modo Advanced, em que os pedidos vão para o balcão.

Pré-visualização. Preview Support Page no cabeçalho do formulário abre a página exatamente como os seus utilizadores a veem na aplicação.

Separador Support Desk (modo Advanced). No modo Advanced, uma mensagem deixada na página abre um pedido em vez de enviar um e-mail. Neste separador escolhe os agentes — utilizadores do portal da sua empresa com uma função acima de User (Portal Tier 2, Customer, Installer, Community Manager, Local Admin ou uma função Customer personalizada) — que respondem aos pedidos no Support Desk (secção 33). Decide também se os agentes recebem um e-mail sobre novos pedidos e o requerente sobre as respostas, após quantas horas um pedido sem resposta é novamente trazido à atenção, após quantos dias um pedido resolvido se fecha por si só, quantos pedidos uma pessoa pode ter abertos ao mesmo tempo (1 a 10), se é pedida uma avaliação ao requerente e as respostas predefinidas que os agentes podem inserir. O botão Requests no canto do formulário lista os pedidos da empresa. O grupo Chat contém Offer a chat with the support team: com esta opção ativada, a página de suporte mostra uma janela de chat com o estilo da do assistente, onde a pessoa escreve à equipa de suporte — a primeira mensagem abre um pedido (origem *Support chat*), as mensagens seguintes continuam-no, e as respostas dadas no Support Desk aparecem na janela; It is solved resolve o pedido. Quando o assistente está ativado, a sua janela ocupa o lugar do chat.

Separador Assistant (modo Advanced). Ative o AI assistant para adicionar um chat no topo da página de suporte. Responde a partir da base de conhecimento da aplicação móvel SmartphoneKey (uma descrição detalhada de cada ecrã, mensagem e limite da aplicação, com uma tabela de resolução de problemas), dos contactos e do horário acima e das Company FAQ que introduz neste separador (pares de pergunta e resposta, citados exatamente). Trata cada pergunta primeiro como uma pergunta sobre a aplicação móvel: procura o assunto na base de conhecimento e verifica as chaves da pessoa, o estado da fechadura e os eventos recentes da porta antes de responder, dá conselhos gerais apenas onde a base de conhecimento nada diz, e a uma pergunta que não seja sobre a SmartphoneKey responde com uma proposta direta de deixar um pedido (ou os contactos, conforme escolhido abaixo) em vez de uma resposta. Vê apenas as chaves e os eventos da própria pessoa, não pode abrir portas nem alterar acessos, e não existe nenhum prompt de texto livre — o comportamento é construído a partir de opções: o tom e o comprimento das respostas, o idioma (o do utilizador ou um fixo), que tópicos da base de conhecimento pode utilizar (como a ler, o que a aplicação é e o que não faz estão sempre incluídos), o que pode fazer pela pessoa (mostrar as suas chaves e o seu estado, os seus eventos recentes da porta, se a sua fechadura está online, reenviar o e-mail da sua Wallet Key, abrir um pedido), quando encaminha (propor um pedido, mostrar os contactos, ou ambos; propor um humano após um certo número de respostas sem solução; colocar o telefone de emergência em primeiro lugar perante palavras de emergência; fora do horário de funcionamento continuar a responder ou deixar apenas os contactos e o formulário) e os limites — mensagens por pessoa por dia (20, 50 ou 100) e por conversa (10 a 30), para que um chat resolva uma questão técnica e deixe uma mensagem sem se prolongar durante horas. A empresa pode executar o assistente com a sua própria chave de API de LLM, URL e modelo em vez dos globais das Settings, com um orçamento mensal de tokens opcional; os tokens utilizados este mês são apresentados no separador. O chat é anexado ao pedido quando a pessoa deixa um, para que o balcão veja o que já foi dito, e as estatísticas do balcão mostram a percentagem de assuntos que o assistente resolveu por si só.

O que os utilizadores veem. Um utilizador abre a página a partir do separador Profile da aplicação e vê os contactos da empresa que opera os Objetos a que pertence. As pessoas que utilizam a aplicação apenas com um número de telefone, sem e-mail, chegam à mesma página através de uma ligação assinada que a aplicação pede por elas; a ligação expira por si só, e as ligações dentro dos e-mails de suporte são emitidas da mesma forma. Até uma empresa preencher a sua configuração, a página mostra os contactos de suporte da SmartphoneKey que o administrador do sistema introduziu em Settings → Support, para que ninguém encontre uma página vazia. A página segue o idioma da aplicação, a menos que Support page language, no topo do Support Configurator, a fixe num único idioma para todos.

Balcão de suporte (Support Desk)

O Support Desk é onde os agentes escolhidos no Support Configurator respondem aos pedidos deixados na página de Suporte da aplicação móvel. Um agente chega até ele a partir do cartão Support Desk por baixo do cartão SmartphoneKey Portal na sua página inicial do portal; o cartão mostra quantos novos pedidos estão à espera. Os administradores veem os mesmos números no Dashboard do portal: um mosaico Support Requests com os pedidos abertos por estado e o tempo médio até à primeira resposta.

A lista. Os pedidos são agrupados por separadores — Open, Unread, Mine, New, In progress, Waiting for user, Resolved, Closed, All — com uma caixa de pesquisa (assunto, nome, e-mail, telefone ou número do pedido), uma ordenação e uma exportação CSV da lista atual. Um agente que serve várias empresas escolhe a empresa no cabeçalho, que contém também o seletor de idioma da interface e o comutador de tema. O cabeçalho mostra ainda os últimos 30 dias: pedidos abertos e novos, os tempos médios de primeira resposta e de resolução, a avaliação média e a percentagem de pedidos resolvidos pelo assistente de IA.

Um pedido. Abrir um pedido mostra a conversa — as mensagens do requerente, as respostas dos agentes, as notas internas e a transcrição do assistente quando existe — e o painel do requerente: nome, Objetos, morada, telefone, e-mail, o tipo de conta e as chaves e fechaduras que a pessoa possui; Open the SmartphoneKey Portal, por baixo, abre o portal diretamente na janela User Information dessa pessoa. A partir do cabeçalho, pode assumir o pedido com Take, resolvê-lo com Resolve ou alterar o seu Status, a Priority, a Category e o Agent.

Responder. Escreva na caixa de resposta e clique em Send answer: o requerente vê a resposta na página do seu pedido e recebe um e-mail quando tem um endereço. Assinale Internal note para deixar uma nota que só os outros agentes veem. Insert a canned reply adiciona um dos textos predefinidos da configuração; Attach adiciona até três fotografias ou ficheiros PDF. Uma resposta a um pedido aberto a partir da janela de chat (origem *Support chat*) aparece também nessa janela na página de suporte.

Ciclo de vida. Um novo pedido passa a In progress com a primeira resposta; Waiting for user indica que a vez é do requerente; um pedido Resolved fecha-se por si só após o número de dias configurado, a menos que o requerente volte a escrever, o que o reabre. Uma vez resolvido, é pedido ao requerente que avalie a ajuda de 1 a 5; a avaliação é apresentada no pedido e nas estatísticas.

Feedback e sugestões (Feedback & Suggestions)

Use Settings → Feedback & Suggestions para dizer à equipa SmartphoneKey o que adicionar ou melhorar e para acompanhar o que acontece a cada ideia. O separador lista tudo o que enviou, e as respostas da equipa aparecem dentro de cada item.

34.1 Deixar feedback

1. Abra Settings → Feedback & Suggestions e clique em New feedback.
2. Escolha o tipo de feedback: Idea (algo novo que gostaria de ter), Improvement (algo que existe, mas podia funcionar melhor), Problem (algo que não funciona como esperado) ou Other.
3. Escolha a área a que diz respeito: dispositivos e fechaduras, chaves físicas, utilizadores e acesso, Wallet Keys, câmaras e vídeo, intercomunicador, hubs e Matter, o Admin Portal, a aplicação móvel, faturação e subscrição, suporte ou outra.
4. Dê-lhe um Title curto (uma linha) e, em seguida, descreva o que gostaria de adicionar ou melhorar, que problema resolve e, se quiser, como deveria funcionar idealmente — o resultado que espera, um exemplo de outro produto, ligações.
5. Escolha a importância que tem para si: Nice to have, Important ou Critical.
6. Anexe capturas de ecrã ou um PDF se ajudarem (até 5 ficheiros, 5 MB cada) e clique em Send feedback.

O seu nome, o endereço de e-mail, a empresa e o Objeto selecionado no portal são adicionados automaticamente, por isso não há nada a escrever sobre si.

34.2 Acompanhar o seu feedback

O separador mostra todos os itens que enviou, do mais recente para o mais antigo, com o respetivo estado: New, Under review, Planned, In progress, Done ou Declined. Abra um cartão para ler o texto completo, os anexos e a conversa.

Quando a equipa responde ou altera o estado, o portal mostra um aviso único da próxima vez que o abrir; clique em View para abrir esse feedback ou em Later para fechar o aviso. Até abrir o item, o seu cartão apresenta a marca *novo* e o separador Feedback & Suggestions mostra quantos itens têm respostas que ainda não leu.

34.3 Responder à equipa

Abra o feedback e escreva em Your reply, por baixo da conversa, e depois clique em Send reply. A equipa vê a sua resposta no back office e pode responder de novo na mesma conversa.

34.4 Convites para partilhar feedback

O seu operador pode convidá-lo a partilhar feedback: uma mensagem única aparece quando abre o portal. Clique em Leave feedback para ir diretamente para o formulário de novo feedback, ou em Later para a fechar. A mensagem é mostrada uma vez por convite.

Portal de parceiros (Partner Portal)

O Partner Portal é a área de autosserviço dos parceiros de integração: empresas que ligam a sua própria plataforma ao SmartphoneKey através da API. É independente do Admin Portal: uma conta com o papel Partner (atribuído pela equipa SmartphoneKey a partir do back office) vê um cartão Partner Portal na sua página inicial do portal, por baixo dos cartões SmartphoneKey Portal e Support Desk, e nada mais muda para ela. Todas as contas da mesma organização que têm o papel trabalham sobre o mesmo registo.

35.1 Configurar a integração

A página guia-o por três passos, mostrados no topo como uma barra de progresso:

1. Register organization. Introduza o Organization name e o Organization ID — de 3 a 64 letras minúsculas, algarismos e hífens; o portal sugere um a partir do nome da sua empresa e verifica se está livre. O ID identifica a sua plataforma em cada chamada à API e não pode ser alterado depois. O endereço de e-mail da sua conta fica registado como proprietário.
2. Create API key. A chave que a sua plataforma envia no cabeçalho X-API-Key de cada pedido. É mostrada uma única vez, numa caixa de diálogo que só fecha depois de confirmar que a guardou; depois disso a página mostra apenas o início e o fim.
3. Register webhook. O endereço HTTPS na sua plataforma onde o SmartphoneKey entrega os eventos, e os eventos que pretende: All events ou uma lista de tipos de evento. O secret do webhook também é mostrado uma única vez — cada entrega leva-o no cabeçalho X-Webhook-Secret, para que o seu servidor possa rejeitar as chamadas que não o tragam.

Se a admin API não confirmar um passo, a página mantém-no como não confirmado com os botões Finish, Check e Discard em vez de o repetir; o SmartphoneKey vê o mesmo no back office.

35.2 Gerir a integração

Depois de configurada, a página mostra o cartão Organization, o cartão API key, o cartão Webhook e o registo de atividade, além de Webhook health e Delivery stats enquanto houver um webhook registado.

• Rotate API key pede à admin API uma chave nova, mostrada uma única vez. Enquanto a chave atual continuar ativa, a admin API recusa; peça primeiro ao SmartphoneKey que a revogue e depois atualize a sua plataforma de imediato.
• Update webhook URL passa as entregas para um novo endereço HTTPS; a subscrição é verificada de novo no novo endereço. Replace webhook cria primeiro uma subscrição nova com um novo secret e remove a atual assim que a nova existir — para um secret perdido ou um conjunto de eventos diferente; se a remoção falhar, ambas ficam ativas até o SmartphoneKey remover a antiga.
• Webhook health mostra as entregas falhadas dos últimos 15 minutos e 24 horas com as contagens de entregues e correspondidas, o último erro de entrega e os erros recentes.
• Delivery stats mostra os totais desde a referência (total, entregues, falhadas, repetições), a percentagem entregue e um gráfico diário; Reset stats inicia uma nova referência a partir de agora sem apagar nada do lado do SmartphoneKey.
• Activity lista quem registou, criou, rodou ou alterou o quê, e quando. A equipa SmartphoneKey vê a mesma lista no back office em Configuration → Partner Integrations; a chave e o secret nunca são mostrados aí.

O cabeçalho tem uma ligação de regresso a My account, o seletor de idioma da interface, o comutador de tema e Sign out. Enquanto o SmartphoneKey não tiver ligado o portal à API de parceiros, a página di-lo e as ações ficam desativadas.