Recursos do Desenvolvedor



Acrescentar Queue-Fair

A Sala de Espera Virtual Queue-Fair é facilmente adicionada a uma grande variedade de plataformas web e de aplicações em minutos. Basta usar um dos nossos Adaptadores. Pode encontrar mais informações sobre a melhor forma de integrar Queue-Fair com o seu sistema existente no Guia Técnico, ou na secção Portal Queue-Fair > Ajuda.

O Adaptador Client-Side

Para websites, a forma mais simples de integrar com Queue-Fair é adicionar a etiqueta JavaScript do Adaptador Queue-Fair do lado do Cliente às suas páginas. Pode seguramente adicionar o Adaptador a todas as páginas do seu site, e usar as Regras de Activação no Portal Queue-Fair para determinar quais as páginas que podem lançar uma fila.

Como funciona nos browsers dos seus visitantes, o Adaptador Client-Side pode ser desactivado por visitantes tecnicamente qualificados, mas é muito eficaz na prevenção de sobrecarga, visto que apenas uma minoria muito pequena de pessoas tentará saltar a fila adulterando o JavaScript. A maioria dos nossos clientes utiliza o Adaptador Client-Side porque é eficaz na prevenção de um local falhado, simples de instalar e não introduz qualquer dependência entre o nosso sistema e o seu.

Pode adicionar uma camada de segurança substituindo a etiqueta JavaScript por um Adaptador do lado do servidor, ou combinar a flexibilidade do Adaptador JavaScript com o Modelo Híbrido de Segurança descrito nesta página; ambos os métodos são então seguros.

Linha única de código

Para adicionar o Adaptador Client-Side ao seu site, basta adicionar a seguinte linha única de código ao <head> secção das suas páginas:

Adicione a nossa Sala de Espera Virtual ao seu site com esta única linha de código e evite que o site caia

Alguns clientes acrescentam a palavra defer à etiqueta, o que faz com que o script do Adaptador seja carregado em paralelo com a análise da página e também só comece a execução do script no browser do visitante quando a página tiver terminado a análise (por isso, normalmente depois de qualquer outro script na sua página ter terminado).

Acrescentar a palavra adiar pode melhorar o Tempo à Primeira Tinta por uma pequena fracção de segundo em alguns casos, mas se optar por fazer isto, significará que qualquer visitante que deva ser deixado em fila verá a sua página protegida por uma fracção de segundo mais tempo antes de ser enviado para a fila.

Gestor de etiquetas Google

Também fornecemos o JavaScript Adapter Tag através do Google Tag Manager. Pesquise Queue-Fair na Galeria de Modelos Comunitários, em Add Tag. Note que alguns bloqueadores de anúncios impedem o download do gtm.js mestre do Google, que bloqueia todas as operações do Google Tag Manager, incluindo a execução do Adaptador para esses visitantes.A nossa etiqueta de Sala de Espera Virtual para Google Tag Manager

Repositórios GitHub

Gestor de etiquetas Google

Gestor de etiquetas Google

O repositório GitHub para a Sala de Espera Virtual Queue-Fair Google Tag Manager Client-Side Adapter Tag.

Páginas Dinâmicas de Fila de Espera

Quaisquer dados que deseje podem ser passados do seu site para os nossos servidores e as Páginas de Fila de Espera que os seus visitantes vêem, utilizando o atributo data-queue-fair-extra que está disponível na Tag JavaScript do lado do Cliente e na implementação do Google Tag Manager. Contacte o suporte se desejar activar as Páginas de Fila Dinâmicas na sua conta.

Pode utilizar esta funcionalidade para personalizar as Páginas de Fila na mosca. Também pode utilizar Queue-Fair para passar os dados que nos envia com os seus visitantes de volta ao seu site à medida que são passados pela fila, para uma camada adicional de segurança.

Também fornecemos uma API de Página de Fila Dinâmica que utiliza os dados extra para personalizar qualquer aspecto de uma Página de Fila, para que possa criar uma fila para todo o seu site e personalizá-la automaticamente para diferentes eventos ou produtos no seu site, sem ter de fazer quaisquer alterações às suas Páginas de Fila no Portal Queue-Fair

.



Wordpress & WooCommerce

Se estiver a utilizar um site baseado em Wordpress, tal como o sistema de carrinho de compras WooCommerce, pode facilmente adicionar a etiqueta Adaptador JavasScript do lado do Cliente utilizando o Plugin de Inserção de Cabeçalhos e Rodapés do Wordpress, sem ter de modificar nenhum dos seus Temas ou tocar em qualquer código Wordpress.

Basta descarregar o Insert Headers & Footers Plugin, descompactá-lo para a sua pasta /wp-content/plugins/, activar o plugin no menu Plugins, abrir o plugin no menu Settings, adicionar a tag aos Scripts no Cabeçalho como mostrado, carregar em Save no fundo da página, e já está!

O Painel de Controlo do Portal Queue-Fair

Adaptador do lado do cliente Recursos adicionais

O Adaptador Client-Side está totalmente descrito no Guia Técnico. O Guia Técnico está disponível na secção Portal Queue-Fair > Ajuda, ou pode solicitar-nos uma cópia.


Adaptadores do lado do servidor

Sempre que o Adaptador Client-Side for executado em JavaScript nos navegadores dos seus visitantes, os Adaptadores Queue-Fair Server-Side são executados no seu servidor Web.

Adaptadores de Servidor Web

Isto significa que o seu servidor web pode tirar partido de características de segurança adicionais para negar o acesso a pessoas que não tenham sido enfileiradas. Isto também significa que o seu servidor web evita a carga de gerar e servir páginas contendo o script do Adaptador.

Adicionar as bibliotecas do Queue-Fair Server-Side Adapter leva apenas alguns minutos com alterações mínimas de código para activar e executar o Adaptador.

A maioria dos nossos clientes começa com o Adaptador JavaScript do lado do cliente e passa para o Adaptador Server-Side apenas onde existe uma necessidade comercial específica.

Modo simples e seguro

Os Adaptadores Queue-Fair Server-Side podem operar em modo simples ou seguro.

No Modo Simples, todos os visitantes são enviados para os Servidores Queue-Fair para serem contados, quer se tenha formado ou não uma Fila de espera. Quando não há fila, são devolvidos imediatamente ao seu Servidor Web, sem verem uma Página de Fila - mas com a assinatura do seu Servidor Web precisa de assegurar que apenas pessoas que tenham sido passadas pela fila possam aceder aos seus recursos protegidos.

No Modo Seguro, os visitantes só são enviados para os Servidores Queue-Fair quando existe uma Fila de espera. O seu servidor Web consulta directamente os nossos Servidores de Fila de Espera para fazer esta determinação. Os visitantes continuam a ser assinados digitalmente com segurança, quer seja ou não mostrada uma Página de Fila de espera.

O Modo Seguro é recomendado para as filas do dia-a-dia. O modo simples é apropriado para um evento cronometrado quando se espera milhares de pessoas, pois elimina a latência devido à chamada de verificação do seu servidor web para os nossos Servidores de Fila, o que significa que pode enviar pessoas para a fila de forma mais eficiente.

Repositórios GitHub

Adaptador de Sala de Espera Virtual PHP') ?>

PHP

O repositório GitHub para o Queue-Fair Adaptador do lado do servidor da sala de espera virtual em PHP.

Adaptador de Sala de Espera Virtual Java

Java

O repositório GitHub para o Queue-Fair Adaptador do lado do servidor da sala de espera virtual para Java, incluindo JBoss e Tomcat.

Adaptador da Sala de Espera Virtual Ruby

Ruby

O repositório GitHub para o Queue-Fair Adaptador do lado do servidor da sala de espera virtual em Ruby e (opcionalmente) Rails.

Adaptador da Sala de Espera Virtual Python

Python

O repositório GitHub para o Queue-Fair Adaptador de Sala de Espera Virtual Server-Side em Python e (opcionalmente) Django.

Adaptador de Sala de Espera Virtual dotNet

.NET

O repositório GitHub para o Queue-Fair Adaptador de Sala de Espera Virtual Server-Side para .NET, ASP e C#.

Node.js & JavaScript Adaptador de Sala de Espera Virtual

Node.js & JavaScript

O repositório GitHub para o Queue-Fair Virtual Waiting Room Server-Side Adapter for Node.js e (opcionalmente) Express.



Páginas Dinâmicas de Fila de Espera

Tal como acontece com o Adaptador do lado do Cliente, quaisquer dados que deseje podem ser passados do seu servidor web para os nossos servidores e as Páginas de Fila de Espera que os seus visitantes vêem ao passar esta informação na chamada do Adaptador do lado do Servidor. Isto facilita a Página de Fila Dinâmica ou outra personalização em tempo real da mesma forma - todas as características do Adaptador Client-Side são totalmente suportadas. Por favor contacte o suporte se desejar activar as Páginas de Fila Dinâmicas na sua conta.

Adaptador do lado do servidor Recursos adicionais

Os nossos adaptadores do lado do servidor são descritos na íntegra no Guia Técnico. O Guia Técnico está disponível na secção Portal Queue-Fair > Ajuda, ou pode solicitar-nos uma cópia. Pode também encontrar mais informações sobre cada um dos Adaptadores no README.md de cada repositório GitHub.


REST APIs

Queue-Fair dá aos programadores acesso a seis Módulos API REST. Será necessária uma conta Queue-Fair para utilizar o API. Para permitir o acesso API à sua conta, por favor contacte o Suporte Queue-Fair. Os nossos Módulos API REST estão em conformidade com as normas OpenAPI, RFC 7807 e RFC 3339.

O nosso conjunto de Módulos API é abrangente - qualquer coisa que possa fazer no Portal, também pode fazer com a API, excepto gerir Utilizadores do Portal, o que é excluído por razões de privacidade.

Cada módulo API está totalmente documentado em api.queue-fair.net, onde também encontrará uma interface Swagger para facilidade de utilização e teste. Para segurança, todas as chamadas API são protegidas por encriptação TLS segura e requerem uma chave API específica para a sua conta.

Módulos API

API de relatórios

Para relatórios ao vivo, em tempo real, relatórios históricos e estatísticas agregadas das filas de espera.

API de Gestão de Filas de Espera

Para a criação e modificação programática de filas de espera em tempo real.

API de Gestão de Contas

Para visualizar e actualizar as configurações de toda a sua conta.

API de gestão de activos

Para gerir os bens utilizados pelas suas Páginas de Fila de Espera servidas pelo Google CDN.

Apresentação API

Para alterar qualquer aspecto do HTML das suas Páginas de Fila de Espera e para a actualização e criação de variantes em tempo real.

Activação API

Para configurar as Regras de Activação que determinam que páginas do seu sítio podem desencadear uma fila, e que página é mostrada.



Páginas Dinâmicas de Fila de Espera

Também pode modificar as suas Páginas de Fila de Espera em tempo real sem ter de actualizar a base de dados utilizando o Portal ou a API de Apresentação - Contacte o Suporte para mais detalhes e para activar as Páginas de Fila Dinâmicas na sua conta.

REST API Recursos adicionais

Como requerido pelo RFC 7807, pode encontrar documentação sobre mensagens de erro que podem ser devolvidas pelos nossos Módulos API REST em queue-fair.com/api-error


Aplicações nativas

O Queue-Fair fica óptimo em navegadores móveis, bem como em computadores de secretária e portáteis.

Também pode utilizar o Queue-Fair directamente nas suas aplicações nativas iOS e Android, e também aplicações React Native no iOS, Android, Windows e MacOS, para proteger actividades ou operações de recursos intensivos.

Os Adaptadores de Aplicação Queue-Fair utilizam um Cliente Web para exibir Filas de espera personalizadas aos seus utilizadores quando os seus serviços estão demasiado ocupados, com a flexibilidade e facilidade de utilização do Queue-Fair Portal.

Pode fazer fila de utilizadores na mesma fila que os visitantes do seu website, ou criar uma fila separada para os utilizadores da sua aplicação - a decisão é sua.

Tal como as nossas filas baseadas na web, o lugar de cada utilizador é automaticamente guardado se ele também navegar para longe da sua aplicação.

Repositórios GitHub

Adaptador de sala de espera virtual iOS, MacOS e Apple

iOS & MacOS

O repositório GitHub para a Sala de Espera Virtual Queue-Fair Adaptador iOS e MacOS.

Adaptador de Sala de Espera Virtual Android

Android

O repositório GitHub para o Adaptador de Sala de Espera Virtual Queue-Fair para Android.

Adaptador da Sala de Espera Virtual da aplicação nativa React

React Native

O repositório GitHub para o Adaptador de Sala de Espera Virtual Queue-Fair para aplicações nativas React para Android, iOS, MacOS e Windows.

Notificações em fila

O Adaptador Queue-Fair facilita o envio de Notificação Push aos utilizadores que não estejam a utilizar a sua aplicação ou fila quando a sua vez é chamada. O lugar do utilizador na fila é automaticamente armazenado de forma persistente pelo Adaptador na sua aplicação. Se o utilizador navegar para longe da sua aplicação, a sua aplicação diz ao seu servidor de Notificação Push que deve ser enviada uma notificação, enviando a informação armazenada da posição da fila como parte dessa mensagem para o seu servidor de Notificação Push.

É a mesma tecnologia que usamos para a nossa aplicação de consumo WeQ4U, que já teve cerca de 2 milhões de downloads só no Reino Unido.

O seu servidor de Notificação Push consulta periodicamente a API de estado Queue-Fair para consultar a posição da fila actualmente a ser servida. Quando esta é maior do que a posição de um determinado utilizador na fila, é altura de enviar a notificação a esse utilizador. Se o utilizador regressar à fila ou for Passado antes de uma Notificação Push ter sido enviada, o Adaptador notifica a sua aplicação, e a sua aplicação diz ao seu servidor de Notificação Push que a notificação já não é necessária.

Segundo o nosso conhecimento, somos o único fornecedor de Sala de Espera Virtual que apoia esta funcionalidade.

Recursos de Vídeo

Aqui está um vídeo do Adaptador Nativo em acção, mostrando que o lugar do utilizador é guardado mesmo que a aplicação esteja completamente parada, e também mostrando os ganchos do Adaptador que a sua aplicação utiliza para enviar Notificações Push.

Recursos adicionais

Os nossos Adaptadores de Aplicação Nativa são descritos no Guia Técnico. O Guia Técnico está disponível na secção Portal Queue-Fair > Ajuda, ou pode solicitar uma cópia de nós. Pode também encontrar mais informações sobre cada um dos Adaptadores específicos para iOS e Android no README.md de cada repositório GitHub.


Adaptadores de ECommerce

Queue-Fair pode ser adicionado facilmente a qualquer sistema de eCommerce usando o Adaptador JavaScript do lado do Cliente descrito acima.

Também oferecemos código Adaptador para trabalhar no lado do servidor com muitos servidores de eCommerce populares.

Repositórios GitHub

Magento Plugin

Magento

O repositório GitHub para o Queue-Fair Adaptador de Sala de Espera Virtual para Magento.

Adaptador de Sala de Espera Virtual WooCommerce/PHP

WooCommerce

O repositório GitHub para o Queue-Fair Adaptador de Sala de Espera Virtual para o WooCommerce em PHP.

Adaptador de Sala de Espera Virtual PrestaShop/PHP

PrestaShop

O repositório GitHub para o Queue-Fair Adaptador de Sala de Espera Virtual para PrestaShop em PHP.

Recursos adicionais

Os nossos Adaptadores estão descritos no Guia Técnico. O Guia Técnico está disponível na secção Portal Queue-Fair > Ajuda, ou pode solicitar-nos uma cópia.

Temos também guias suplementares disponíveis para a maioria das plataformas de comércio electrónico - basta pedir aquele que deseja.


Segurança Híbrida

Pode facilmente combinar a flexibilidade do Adaptador JavaScript do lado do cliente com a camada de segurança adicional fornecida pelo nosso código do lado do servidor.

Queue-Fair assina cada visitante que passamos com uma impressão digital que é única para esse Visitante. Única na indústria, a assinatura também inclui código específico do browser do visitante, para evitar que os tokens de acesso sejam partilhados.

O seu servidor web pode validar a assinatura utilizando um segredo conhecido apenas por si e por nós - não pelos seus visitantes - para garantir que cada visitante foi passado de forma justa pelos servidores Queue-Fair.

Assim, pode utilizar o Adaptador JavaScript do lado do Cliente para enviar e receber visitantes de e para a fila de espera, e verificar a existência de adulteração antes de estes encomendarem com um código mínimo do lado do Servidor, e evitar introduzir uma dependência do nosso sistema.

O código de exemplo está incluído nos nossos Repositórios GitHub em todas as principais linguagens de programação web.

Repositórios GitHub

PHP

PHP

O repositório GitHub para o Queue-Fair Adaptador do lado do servidor da sala de espera virtual em PHP.

Java

Java

O repositório GitHub para o Queue-Fair Adaptador do lado do servidor da sala de espera virtual para Java, incluindo JBoss e Tomcat.

Ruby

Ruby

O repositório GitHub para o Queue-Fair Adaptador do lado do servidor da sala de espera virtual em Ruby e (opcionalmente) Rails.

Python

Python

O repositório GitHub para o Queue-Fair Adaptador de Sala de Espera Virtual Server-Side em Python e (opcionalmente) Django.

.NET

.NET

O repositório GitHub para o Queue-Fair Adaptador de Sala de Espera Virtual Server-Side para .NET, ASP e C#.

Node.js & JavaScript Virtual Waiting Room Adapter') ?>

Node.js & JavaScript

O repositório GitHub para o Queue-Fair Virtual Waiting Room Server-Side Adapter for Node.js e (opcionalmente) Express.

Recursos adicionais

O Modelo de Segurança Híbrido é descrito na íntegra no Guia Técnico. O Guia Técnico está disponível na secção Portal Queue-Fair > Ajuda, ou pode solicitar-nos uma cópia.


Licença

O nosso código publicado disponível no The GitHub Queue-Fair Repository é licenciado sob a Licença MIT, que se encontra entre as licenças Open Source mais permissivas.


Quer saber como funciona o Queue-Fair?