Versão: 0.1
Data: 11/08/2025
Autor: Gusthavo Nóbrega Furuhashi
Documentos relacionados:
1. Objetivo
Este tutorial tem como objetivo orientar sobre como funciona a integração com IXC Soft
Conhecimentos: Familiaridade com o Painel Administrativo Mambo.
Ferramentas/Softwares: Painel Administrativo Mambo, ter acesso à plataforma IXC
Acessos/Permissões: Será necessário ter acesso Administrador ao Painel Administrativo Mambo, ter o módulo de integração com IXC ativado em sua conta Mambo WiFi.
3. Links Úteis
Ativação de um Painel Administrativo Mambo: https://mambowifi.com/contato/
4. Informações
4.1. A integração possui 02 possibilidades de uso:
Captação de dados dos visitantes e enviando como leads para a IXC
Autenticação dos seus clientes para acessar o captive portal.
4.2. Campos de cadastro:
Para garantir que o lead seja criado corretamente no IXC, é preciso definir alguns campos no formulário de cadastro para criar o lead corretamente. Certifique-se de que o formulário capture todos os dados de contato que você deseja captar. O campo de E-mail é obrigatório para criar o lead corretamente.
Os campos que você pode solicitar estão na lista abaixo:
Email*
Nome
Telefone
Celular
CEP
Endereço
Bairro
Cidade
Número
Assim que o visitante acessar a rede WiFi e preencher seus dados cadastrais, será gerado automaticamente esse lead lá no CRM do IXC, para posteriormente trabalhar com esses dados.
O outro cenário de utilização é permitir que os usuários/clientes se autentiquem no captive portal da Mambo usando as mesmas credenciais que utilizam para acessar o IXC (central do assinante). Isso é útil para provedores que desejam oferecer “WiFi fora de casa” dando um benefício a seu cliente para poder usar o WiFi daquele local com os mesmo dados que utiliza para acessar a sua central do assinante.
5. Procedimento
5.1. Gerar credenciais de API (Token de acesso)
Para gerar o token, é preciso ir em Configurações do sistema > Usuários > Novo>
As permissões e logs de usuários para o webservice funcionam da mesma forma que de um usuário logado no sistema, por isso, para que não haja nenhuma restrição o usuário webservice deve estar em um grupo administrador, ou seja, que tenha acesso total ao sistema.
Após clicar em novo, este é o formulário que deverá ser preenchido, é de suma importância que esteja marcado o botão Permite acesso ao webservice.
Após salvar, o token será gerado automaticamente.
Na guia de parâmetros recomendamos remover os filtros de filtrar setor e filtrar funcionário para o usuário da API caso o mesmo vá trabalhar com ordens de serviço.
5.2. Ativar a integração
Na sua conta MAMBO WIFI Acesse o menu "Integrações" e clique em "IXC Soft".
Preencha os campos de Host da API e API TOKEN (token de acesso) e clique em [Testar Credenciais]. Se as credenciais estiverem corretas, prossiga com a configuração.
5.3. Autenticar clientes via IXC? [Sim ou Não]
Nossa integração permite que os usuários se autentiquem no captive portal da Mambo usando as mesmas credenciais que utilizam para acessar o IXC (central do assinante). Isso é útil para provedores que desejam oferecer uma experiência integrada, permitindo que o acesso ao Wi-Fi seja realizado com E-mail e senha do IXC, as mesmas que o cliente utiliza para acessar a sua área do assinante.
Botão de Autenticação: Será adicionado no captive portal um botão como "Sou Cliente Provedor". O visitante poderá se autenticar com E-mail e senha do IXC.
Regra de Acesso: Defina em qual regra de acesso o visitante será cadastrado no Mambo WiFi.
Texto do Botão: Insira o texto que será exibido no botão de login.
5.3. Enviar dados do lead no cadastro do visitante? [Sim ou Não]
Este recurso permite que, automaticamente, todos os visitantes cadastrados no captive portal tenham seus dados enviados para o IXC, criando um novo lead.
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.