ipagesoftware/Telegram_Bot

Robô para gerir faturas

Telegram_Bot

Robô para gerir faturas

Sobre o Bot

Este Bot é uma ferramenta criada para auxiliar os clientes da Ipage Software:

https://www.ipage.com.br

Você pode procurar no Telegram por @IpageSoftwareBot.

Assista o vídeo no Youtube

https://www.youtube.com/watch?v=wiihNRlDoWU

NOSSOS CANAIS

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)

ACESSANDO O BOT DA IPAGE.

Digite na caixa de pesquisa do Telegram por: Ipage Software

INICIANDO O BOT.

Digite o comando: /start para iniciar o bot.

CONHECENDO AS OPÇÕES DO MENU INICIAL.

Ao iniciar o bot com o comando /start uma mensagem de saudação será exibida e logo abaixo algumas opções preliminares do menu.

MENSAGEM INICIAL.

• 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

MENU ADMINISTRAÇÃO

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.

MENU ADMINISTRAÇÃO → ENVIAR LEMBRETES

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.

MENU ADMINISTRAÇÃO → MANUTENÇÃO

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.

MENU ADMINISTRAÇÃO → USUÁRIOS

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.

MENU ADMINISTRAÇÃO → USUÁRIOS – LISTAGEM USUÁRIO.

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.

MENU ADMINISTRAÇÃO → USUÁRIOS – LOG DO USUÁRIO.

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.

MENU ADMINISTRAÇÃO → USUÁRIOS – LOG DO USUÁRIO.

MENU ADMINISTRAÇÃO → USUÁRIOS – LOG DO USUÁRIO.

Nota: esta opção só será visualizada pelo usuário administrador.

MENU ADMINISTRAÇÃO → FATURAS.

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.

MENU ADMINISTRAÇÃO → FATURAS – À RECEBER.

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.

MENU ADMINISTRAÇÃO → FATURAS – À RECEBER.

Nota: esta opção só será visualizada pelo usuário administrador.

MENU ADMINISTRAÇÃO → FATURAS → QUITADAS.

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.

MENU ADMINISTRAÇÃO → FATURAS – EMITIR.

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.

MENU ADMINISTRAÇÃO → FATURAS – EMITIR.

Nota: esta opção só será visualizada pelo usuário administrador.

MENU ADMINISTRAÇÃO → FATURAS → ENVIAR.

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.

MENU MINHAS FATURAS.

Nesta opção de menu o usuário poderá consultar as faturas pendentes, pagas e canceladas.

MENU MINHAS FATURAS → PENDENTES.

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.

MENU MINHAS FATURAS → PENDENTES → COMUNICAR PAGAMENTO FATURA.

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.

MENU MINHAS FATURAS → PENDENTES → COMUNICAR PAGAMENTO FATURA → MEIOS DE PAGAMENTO.

Você também poderá consultar as formas de pagamento selecionando a opção do menu “Meios de Pagamento”.

MENU MINHAS FATURAS → PAGAS

Nesta opção do menu o funcionamento é o mesmo das faturas pendentes. Favor consultar MENU MINHAS FATURAS → PENDENTES para maiores informações.

MENU MINHAS FATURAS → CANCELADAS

Nesta opção do menu o funcionamento é o mesmo das faturas pendentes. Favor consultar MENU MINHAS FATURAS → PENDENTES para maiores informações.

MENU SERVIÇOS CONTRATADOS

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

MENU MANUAL DE OPERAÇÃO

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

CONSIDERAÇÕES FINAIS

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.

BASTIDORES

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.