Nesta matéria, abordaremos como realizar a integração do ISPFY com o Telegram para avisos.
¶ Passo 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 mais tarde;
Agora, você precisa do seu ID de usuário, que será utilizado para enviar uma mensagem de teste.
7. Na barra de mensagens, digite “@getidsbot” e aperte a tecla “espaço”;
8. Logo acima da barra de mensagens, será exibido um pop-up escrito “You”;
9. Clique sobre o pop-up para receber informações sobre seu usuário no Telegram;
10. Você receberá uma mensagem com algumas informações, incluindo seu ID, que será utilizado mais tarde;
 |
 |
Para que as mensagens possam ser recebidas, você precisará ativar o BOT criado anteriormente, caso contrário, as mensagens não serão entregues.
11. Busque pelo seu BOT no campo de pesquisa e, clique em “Start”.
¶ Passo 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”.
9. A janela será fechada e a lista de gateways será exibida, agora você pode seguir para a próxima etapa.
¶ Passo 3 - Testar gateway
Com o BOT e o ISPFY integrados, podemos agora enviar uma mensagem de teste:
- Na lista de gateways, procure pelo gateway criado anteriormente;
- Ao lado direito de seu gateway, clique no botão amarelo escrito “Testar”;
- Uma nova janela com o nome do seu gateway será exibida, preencha os campos como descrito abaixo:
- Enviar para: Cole o ID de usuário disponibilizado anteriormente pelo Telegram;
- Após escrever o texto da mensagem, clique em “enviar mensagem”.
Lembre-se: Você só recebera a mensagem caso tenha ativado o seu BOT no Telegram.
¶ Passo 4 - Configurar usuário
Com a mensagem de teste recebida, podemos agora configurar os usuários no ISPFY para receberem as mensagens.
- Para configurarmos os usuários, precisaremos de seus IDs do Telegram:
Oriente seu técnico para realizar o passo a passo a seguir.- Na barra de pesquisa do Telegram, procure por “@getidsbot”;
- Em “GetIDs Bot”, clique em “start”;
- Uma mensagem será exibida, esta mensagem deverá conter algumas informações, incluindo o ID de usuário.
Utilizaremos este ID no próximo passo.
2. Com o ID do seu técnico disponível, vamos agora configurar o usuário no ISPFY:
- No “menu principal”, navegue até “sistema > usuários > cadastro”;
- A lista de usuários será exibida, procure pelo usuário que você deseja enviar as mensagens e clique em editar;
- A janela “Editar usuário”, será exibida;
- No campo “Telegram”, informe o ID do seu técnico e clique em “Salvar”.
¶ Passo 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.
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”.
Conheça o ISPFY: O sistema completo para gestão do seu provedor! Clique aqui e teste agora.