Documentos relacionados:
1. Pré-requisitos
Conhecimentos: Familiaridade com o Painel Administrativo Mambo Old Mambo
Ferramentas/Softwares: Painel Administrativo Old Mambo
Acessos/Permissões: Será necessário ter acesso Painel Administrativo Old Mambo.
2. Links Úteis
Ativação de um Painel Administrativo Mambo: https://mambowifi.com/contato/
3. Procedimentos em vídeo
3.1. Vídeo de treinamento da plataforma Old Mambo:
3.2. Vídeo de treinamento da API da Old Mambo:
3.3. Vídeo de demandas recorrentes na API da Old Mambo:
4. Procedimento em texto
4.1. Painel Administrativo (manual em texto)
Acesse o Painel Administrativo através da URL https://clients.mambowifi.com/ e faça seu login.
Neste painel, temos os seguintes módulos:
Campanhas: Aqui fica agrupado todos os módulos que temos no painel da New Mambo (regras de acesso, formulários, mídias, etc). É neste módulo que configuramos todo o Captive Portal.
Relatórios de Campanha: Aqui ficam todos os relatórios das Campanhas, que contempla um relatório similar ao Histórico de Acesso, um relatório que contém informações sobre os dispositivos, e um relatório que informa a performance da campanha desde sua criação.
Relatórios de Ambientes: Aqui ficam os gráficos da quantidade de autenticações filtrados pelas Regiões, que é em tempo real. Aqui, ao contrário dos Relatórios de Campanha, não é possível baixar os Relatórios de Ambiente.
Galeria: Neste módulo é feito o upload das mídias (imagens, vídeos) e também a criação de pesquisas. Posteriormente aplicamos as mídias cadastradas aqui nas Campanhas.
Usuários: Aqui é cadastrado todos os usuários que acessam o Painel Administrativo.
Termos de Uso: Neste módulo são inseridos os Termos de Uso.
Voucher: No módulo Voucher são cadastrados os vouchers, que são os Códigos de Acesso. Para isso, é necessário ter uma Campanha que tenha a Experiência selecionada como Voucher.
Ajuda: Aqui possui uma breve explicação sobre as funcionalidades da Old Mambo.
4.2. API (manual em texto)
Acesse a API através da URL https://api.mambowifi.com/admin/ e faça seu login.
Na API, é importante termos algumas noções antes de começar a navegar:
Evite excluir dados (regiões, painéis, etc). Tudo que é cadastrado na API possui dados atrelados a ele, é sempre preferível inativar do que excluir. A única exceção são os usuários, que podem ser excluídos.
Tudo que é criado possui um código único (regiões, painéis, campanhas, mídias, etc). Sempre que abrimos uma task para o Time de Desenvolvimento é interessante inserir o código referente ao que estamos reportando, por exemplo o código do painel do cliente. Isso facilitará a consulta para a resolução do problema.
Cuidado ao inativar um painel, pois todos os usuários atrelados a ele serão inativados também. Então caso seu usuário esteja neste painel, você perderá o acesso à API
Dentro da API, em nosso dia a dia utilizaremos os seguintes módulos:
Usuários: Aqui você gerencia todos os usuários, tanto de clientes quanto de colaboradores da empresa Mambo. É possível criar, editar, inativar e excluir os usuários. É aqui também que trocamos de painel, acessando nosso usuário e acessando o client que ele está atrelado.
Clients: Neste módulo gerenciamos os painéis dos clientes. Aqui criamos, editamos e inativamos os painéis. Lembrando que, para criar um painel, lembre-se de marcar a opção External Media e também Has Region Report. Também atente-se ao código do painel, que nunca deve se repetir, e sempre deverá ser inserido numa crescente ( número anterior +1)
Regions: Aqui gerenciamos as regiões, que são os pontos de acesso. Cada painel terá pelo menos uma região. Cada região possui uma HASH, que é utilizada para fazer o apontamento nas configurações dos equipamentos de rede que farão a gestão do hotspot. As regiões não devem ser excluídas, pois existem dados atrelados a ela. Caso seja necessário retirar uma região de um painel, mova-a para o painel Mambo Desativados. A criação de região é uma das demandas mais comuns na Old Mambo.
Unifi Controller: Para que o hotspot funcione em uma controladora UniFi, é preciso cadastrá-la aqui. Ao criar uma nova, a atrelamos a um painel, colocamos a URL de acesso junto com sua porta, e o usuário e senha gerado na controladora. Este módulo também serve de consulta para que os analistas possam verificar as controladoras dos clientes.
SMS Packs: Aqui gerenciamos os pacotes de SMS, que são utilizados para marketing e para confirmação. O processo de aquisição de um pacote de SMS é feito pelo Comercial e repassado ao Financeiro. Quando formos acionados, criamos um novo pacote, atrelando-o a um painel e inserindo a quantidade de SMS que foi adquirida.
Em nossa API existem diversos outros módulos, como os de Campanhas ou de Banners (imagens). Porém estes são os que mais utilizaremos.
4.3. Tools (manual em texto)
O Tools é uma ferramenta criada pelo Time de Tecnologia com o intuito de nos auxiliar. Nele, existem diversas ferramentas que podemos utilizar em nosso dia a dia. Acesse a URL https://tools.mambowifi.com/ e faça seu login.
No Tools teremos os seguintes serviços:
Consultar:
Cadastro: Aqui consultamos um cadastro de um visitante, inserindo suas informações pessoais.
UUID (HASH): Esta ferramenta foi desenvolvida após uma necessidade de verificar qual cliente já foi migrado para a nova URL de apontamento. Porém, ela também é extremamente útil para verificarmos qual equipamento o cliente usa, basta inserir sua HASH que será mostrado toda a URL de apontamento, que consta o nome do equipamento.
Relatório: Aqui pode ser gerado um relatório de toda a base, com alguns filtros.
Serviços:
Captive: Este serviço é utilizado para auxiliar a montar a URL de apontamento que será configurada no equipamento. Basta preencher as informações que a URL completa será gerada.
GoogleTag: Este serviço apenas um cliente usa, a Eletromidia S.A.. Ele serve para que o microserviço de Mídia Externa funcione corretamente.
Flower: Descontinuado.
Migração: Este serviço é utilizado na migração de Old Mambo para New Mambo. Aqui é feita a migração da base de visitantes, onde são cadastrados via API todos os visitantes no painel da New Mambo. A ferramenta possui um tutorial de utilização já embutido. Para utilizá-la, é necessário ter o token de seu usuário, disponibilizado pelo Nelson. Caso não tenha um, entre em contato com o mesmo.
WalledGarden: Aqui possui uma "base de conhecimento" com todos os Walled Gardens que precisão ser liberados para cada tipo de serviço.
Whitelabel: Aqui temos todos os painéis que são White Label na Old Mambo. Ao clicar em um deles você será redirecionado para o painel White Label.
Se houver alguma dúvida ou dificuldade, você pode entrar em contato com nosso suporte através do e-mail suporte@mambowifi.com informando sua dificuldade, número de telefone para contato e URL do painel administrativo.