Robô para gerir faturas
Este Bot é uma ferramenta criada para auxiliar os clientes da Ipage Software:
Você pode procurar no Telegram por @IpageSoftwareBot.
Assista o vídeo no Youtube
https://www.youtube.com/watch?v=wiihNRlDoWU
IpageTelegram
Versão: 2.0.3 Beta
Última atualização: 01 Apr 2021 03:14:02
- Site da Ipage (https://www.ipage.com.br/)
- Twitter (https://twitter.com/ipage_software)
- Suporte Técnico (https://www.ipage.com.br/helpdesk/)
- suporte@ipage.com.br
- Telegram do autor @diogenesdias (https://t.me/diogenesdias)
Digite na caixa de pesquisa do Telegram por: Ipage Software
Digite o comando: /start para iniciar o bot.
Ao iniciar o bot com o comando /start uma mensagem de saudação será exibida e logo abaixo algumas opções preliminares do menu.
- Na mensagem inicial você verá seu nome cadastrado no Telegram.
- A versão do bot.
- A data da última atualização realizada no bot.
São elas:
MENU INICIAL
No menu inicial temos as seguintes opções:
- Menu Administração
- Menu Minhas faturas
- Serviços Contratados
- Manual de Operações
Este menu é composto por 04 (quatro) submenus, são eles:
- Enviar Lembretes
- Manutenção
- Usuários
- Faturas
Ver figura abaixo:
Nota: esta opção só será visualizada pelo usuário administrador.
Ao clicar neste menu, um lembrete é disparado via e-mail para todos os clientes que estão com faturas a vencer ou vencidas.
O bot também comunica o fato a outro bot mensageiro chamado Ipage Bot.
Modelo de uma mensagem a ser recebida após o envio do lembrete:
Nota: esta opção só será visualizada pelo usuário administrador.
Ao selecionar esta opção do menu, o bot entra automaticamente no modo manutenção ficando totalmente inoperante.
Este recurso foi criado para que ajustes possam ser realizados ou alguma atualização possa ser implantada.
O usuário que tentar utilizar o bot no momento em que a manutenção estiver ativa, receberá uma mensagem informando o motivo da sua inoperância temporária.
Nota: esta opção só será visualizada pelo usuário administrador.
Ao selecionar esta opção você poderá visualizar a listagem de usuários que utilizam o bot. Poderá ativar ou desativar um usuário para ter acesso aos recursos do bot. Você poderá monitorar as ações que um determinado usuário faz no bot gerando um log no robô mensageiro.
Nota: esta opção só será visualizada pelo usuário administrador.
Ao selecionar esta opção será exibida uma listagem dos usuários que utilizam o bot.
Nota: esta opção só será visualizada pelo usuário administrador.
MENU ADMINISTRAÇÃO → USUÁRIOS – ATIVAR/DESATIVAR.
Ao selecionar esta opção do menu, o usuário administrador poderá selecionar qual o usuário poderá ou não ter acesso ao bot.
Na imagem acima o usuário Danny encontra-se desativado. Ao desativar um usuário, o bot exibirá uma mensagem informando ao mesmo a sua situação.
Nota: esta opção só será visualizada pelo usuário administrador.
Nesta opção do menu o usuário administrador pode ativar ou não o log do usuário. Se o logo do usuário estiver ativo, o usuário será monitorado e um log de atividades será enviado o nosso robô mensageiro.
Nota: esta opção só será visualizada pelo usuário administrador.
Nesta opção do menu temos as faturas que foram geradas pelo nosso robô de cobranças que é gerido pela nossa plataforma de retaguarda.
Aqui podemos gerir as faturas a receber, faturas quitadas, baixar uma fatura que ainda encontra-se pendente, cancelar uma fatura emitida, reenviar uma fatura ao cliente, dentre outras operações.
Nesta opção de menu pode-se gerir todas as faturas que ainda estão pendentes.
Você poderá selecionar a fatura por mês e ano, selecionado no menu abaixo:
Ao selecionar o mês e ano clique no botão Consultar mês/ano (mês selecionado/ano selecionado).
Ver figura abaixo:
Resultado:
Ao selecionar a opção do menu “Consultar ano(ano corrente)”, serão exibidas todas as faturas pendentes do ano corrente.
Nota: esta opção só será visualizada pelo usuário administrador.
Nesta opção do menu o funcionamento é o mesmo das faturas a receber, o que muda é a situação da fatura. Apenas as faturas pagas serão geridas.
Favor consultar MENU ADMINISTRAÇÃO → FATURAS → A RECEBER para maiores informações.
Nesta opção de menu pode-se mudar a situação da fatura para emitida. No nosso robô de cobrança, a fatura possui 04 (quatro) estágios de situação financeira, são elas:
- Emitida
- Enviada
- Paga
- Cancelada
Vamos esclarecer as regras de negócio:
Uma fatura é considerada emitida quando ela é gerada pelo nosso robô de cobranças mas ainda não foi comunicada a sua emissão ao cliente.
Uma fatura é considerada enviada quando ela foi gerada pelo nosso robô de cobranças e comunicada ao cliente a sua existência.
Uma fatura é considerada paga quando ela foi gerada pelo nosso robô de cobranças e comunicada ao cliente a sua existência e o cliente paga esta fatura.
Uma fatura é considerada cancelada pelo nosso robô de cobranças quando ela foi emitida e ainda não foi comunicada ao cliente a sua existência.
A fatura só poderá ter a situação modificada se foi enviada ao cliente e o mesmo discorda de algum critério, tais como: data de vencimento, cobrança de multas e encargos e/o valor da fatura.
Assim sendo, a fatura é ajustada e volta a situação de emitida.
Para modificar a situação da fatura para emitida, é necessário selecionar o cliente e só depois as faturas geradas para aquele cliente serão exibidas para a seleção e mudança da sua situação.
Nota: esta opção só será visualizada pelo usuário administrador.
Nesta opção do menu o funcionamento é o mesmo das faturas emitir, a diferença é que a situação será de fatura enviada.
Favor consultar MENU ADMINISTRAÇÃO → FATURAS → EMITIR para maiores informações.
Nota: esta opção só será visualizada pelo usuário administrador.
Nesta opção de menu o usuário poderá consultar as faturas pendentes, pagas e canceladas.
Ao selecionar a opção do menu Pendentes, serão exibidas informações a respeitos de todas as faturas que constam em aberto e que devem ser pagas pelo usuário.
Como podemos perceber, são exibidas as informações referentes ao número da fatura, a sua data de vencimento e o total da fatura.
Ainda nesta opção o usuário poderá comunicar o seu pagamento, realizando a baixa automaticamente em nosso sistema financeiro.
Ao selecionar esta opção, você deverá selecionar o cliente para que as faturas pendentes sejam exibidas para seleção e confirmação do pagamento.
Você também poderá consultar as formas de pagamento selecionando a opção do menu “Meios de Pagamento”.
Nesta opção do menu o funcionamento é o mesmo das faturas pendentes. Favor consultar MENU MINHAS FATURAS → PENDENTES para maiores informações.
Nesta opção do menu o funcionamento é o mesmo das faturas pendentes. Favor consultar MENU MINHAS FATURAS → PENDENTES para maiores informações.
Ao selecionar esta opção do menu, serão exibidos todos os serviços cadastrados para o usuário do Telegram.
Estes serviços são cadastrados em nossa plataforma de retaguarda, ver figura acima. As informações apresentadas são:
- O serviço contratado
- A descrição do serviço
- Um link opcional que te encaminhará para um manual ou aplicação de exemplo.
Temos duas opções:
- Recorrer ao suporte conversando diretamente com o autor que desenvolveu este bot @diogenesdias.
- Retornar ao menu inicial
Ao selecionar esta opção do menu, você poderá visualizar/baixar o manual de operação deste bot em formato PDF.
Você também poderá acessar diretamente através do link:
http://www.ipagesoftware.com.br/telegram/IpageTelegram/assets/manual/IpageSoftwareBot.pdf
Se você chegou até aqui é porque este assunto despertou o seu interesse.
Este projeto foi desenvolvido em PHP 07 (sete) puro sangue, sem o auxílio de frameworks.
Ele foi baseado na documentação da API do Telegram: https://core.telegram.org/bots/api.
Este bot é capaz de trabalhar com base de dados MySql, paginar dados, utilizar em suas solicitações GET com múltiplos parãmetros, acessar API de terceiros, comunicar-se com outros bot, dentre outras peripécias que vão além da programação tradicional.