Neste manual, vamos explicar como integrar o Telegram ao ISPFY para o envio de avisos aos técnicos.
¶ Etapa 1 - Criar BOT
- Na barra de pesquisa do Telegram, digite “@BotFather”;
- Em BotFather, clique no botão “start” para começar;
- Você receberá uma mensagem com uma lista de comandos, responda com o comando “/newbot”;
- Defina um “nome” para seu BOT, enviando uma mensagem com o nome que você deseja;
Por exemplo: “Provedor ISPFY”. - Defina um “nome de usuário” para seu BOT;
O nome de usuário deve sempre terminar com “bot”, como, por exemplo, “ispfyprov_bot”. - Com seu BOT criado, você recebera uma mensagem contendo o Token de acesso, utilizaremos este token na próxima etapa;
¶ Etapa 2 - Cadastrar gateway
Com o Token de acesso disponível, você poderá integrar seu BOT ao ISPFY:
- No “menu principal”, navegue até “sistema > mensagens”;
- Uma nova janela será exibida, clique na aba “gateways”;
- Clique no botão “novo gateway” localizado no canto superior direito;
- A janela “Gateway para envio” será exibida, preencha os campos como descrito abaixo:
- Módulo: Selecione a opção “Telegram (tgm)”;
- Nome do gateway: Escolha um nome para seu gateway;
Recomendamos utilizar o mesmo nome escolhido para o BOT no Telegram. - Token: Cole o token de acesso disponibilizado anteriormente pelo Telegram;
- Com todos os campos preenchidos corretamente, clique em “Salvar gateway”.
5. A janela será fechada e você poderá seguir para a próxima etapa.
¶ Etapa 3 - Configurar usuário
Para que o usuário receba mensagens os avisos pelo Telegram, é necessário configurá-lo no ISPFY e ativar o bot para no Telegram. Primeiro passo nessa etapa, e ter o ID do usuário em mãos.
Para conseguir o ID, faça os seguintes passos:
- Acesse o Telegram, na barra de pesquisa, busque por “@getidsbot”;
- Ao entrar no “GetIDs Bot”, clique em “Start”
- Uma mensagem será exibida, a mensagem conterá algumas informações, incluindo o ID do usuário.
Com o ID do usuário disponível, vamos agora configurará-lo no ISPFY.
4. No “menu principal”, navegue até “sistema > usuários > cadastro”;
5. A lista de usuários será exibida, procure pelo usuário que você deseja enviar as mensagens e clique em editar;
6. A janela “Editar usuário”, será exibida;
7. No campo “Telegram”, informe o ID do seu técnico e clique em “Salvar”.
Com o usuário configurado no ISPFY, agora é necessário habilitar o bot no Telegram do usuário configurado.
8. Acesse o Telegram do usuário que deve receber a mensagem;
9. No campo de busca do Telegram, encontre o Bot que você criou;
10. Acesse o bot e clique em “Start”.
Observação: Todas as etapas são indispensáveis, caso alguma dessas etapas tenham sido ignoradas, o usuário não irá receber as mensagens.
¶ Etapa 5 - Configurar avisos
- No menu de atalhos, localizado parte inferior do ISPFY, clique “POP's”;
- Siga até o POP desejado e clique em “⚙” para editar;
3. A janela “Editar POP” será exibida;
4. Selecione “quem deve receber aviso”;
5. Em “Enviar aviso entre”, defina em quais horários o sistema deverá enviar avisos;
6. Defina se o sistema deverá enviar “Avisos sobre baixa tensão”;
Se sim, será necessário um device com sensor de tensão.
7. Defina se o sistema deverá enviar “Avisos sobre queda”;
Confira também: Como cadastrar um POP no ISPFY.
8. Para que seu técnico receba as mensagens, será necessário que ele ative o BOT no Telegram.
- Para ativar o BOT, basta buscar por ele no campo de pesquisa do Telegram e clicar em “Start”.
Confira o manual: Como configurar envio de mensagens.
Confira também: Manual para edição dos templates de mensagens.
Conheça o ISPFY: O sistema completo para a gestão do seu provedor! Acesse o sistema e faça um teste sem compromisso.
Confira todos os módulos e funcionalidades do ISPFY.