Como criar e conectar um chatbot do Telegram

Ao configurar um grupo privado no Telegram, você precisará conectar um bot. Ele é necessário para que o participante possa receber notificações de pagamento, bem como para vincular o contato no Kwiga ao participante no Telegram e, no futuro, também para envios e outras notificações no Telegram. A adição de participantes ao grupo e a remoção deles do grupo acontecerão automaticamente. Você pode usar um bot existente ou criar um novo que será usado apenas para um grupo privado específico ou para todas as notificações no seu projeto. Na maioria das vezes, um único bot é usado para todas as notificações no seu projeto.

Importante! Todas as ações descritas abaixo devem ser realizadas juntamente com a criação de um grupo privado na plataforma. 

Criando um bot

Abra uma conversa com @BotFather (você pode usar este link).

Se você ainda não interagiu com este bot, digite \/start e depois o comando \/newbot.

O bot pedirá que você crie um nome para o seu bot. Esse é o nome que será exibido na lista de contatos (no nosso exemplo - kwiga example)

Em seguida, você precisa criar um nome de usuário para o bot - este é um nome exclusivo pelo qual o bot pode ser encontrado no Telegram, e ele deve terminar com bot (no nosso exemplo, KwigaExample_bot).

Depois disso, o bot será criado e você receberá informações sobre como adicionar uma descrição, um avatar, um link para o próprio bot e, o mais importante, o token, que é necessário para que este bot possa enviar notificações.

Obtendo o token de um bot criado anteriormente

Abra uma conversa com @BotFather (você pode usar este link). Digite o comando \/token e selecione na lista de qual bot o token deve ser exibido:

Depois de selecionar o bot (usando @alanaschool3_bot como exemplo), você receberá o token.

Prossiga para a criação do grupo privado. Na etapa de configurações do bot de notificações, você precisa preencher 2 campos: nome e token.

Criando um grupo ou canal no Telegram

O Telegram oferece dois tipos de comunicação com assinantes: um canal e um grupo. Em um grupo, todos os participantes podem enviar mensagens, enquanto em um canal apenas o administrador do canal pode publicar mensagens.

Dependendo dos seus objetivos, crie um grupo ou um canal. Os exemplos abaixo descrevem as configurações do grupo, pois esta é a ferramenta mais popular.

Atenção! Você pode conectar ao Kwiga um grupo criado anteriormente com participantes existentes, mas ele funcionará incorretamente devido às limitações do Telegram. O bot não poderá remover nem adicionar participantes que entraram no grupo antes da configuração no Kwiga.

Adicionando o bot ao grupo

Abra o grupo criado e selecione Gerenciar grupo.

Selecione Adicionar administrador, digite o nome do seu bot e adicione-o como administrador. Certifique-se de que as permissões do bot incluam Adicionar e remover usuários.

Depois disso, digite o comando \/chatid no grupo, e o bot mostrará o número que precisa ser especificado no Kwiga. Atenção: o comando deve ser inserido não na conversa com o bot, mas especificamente no grupo/canal para o qual você está configurando o acesso. 

Se você não vir a resposta do bot ao comando inserido, certifique-se de que está criando o grupo na plataforma, ou seja, de que concluiu a primeira etapa e especificou a API do bot  ao criar o grupo. Se você apenas criou o bot, mas não o especificou na plataforma, o comando não produzirá o resultado necessário.

Outras configurações

Você pode configurar outras opções no grupo da forma que for mais conveniente para você; elas não afetam a funcionalidade do grupo.

Grupo público ou grupo oculto - após adicionar o bot ao grupo, ele monitorará todos os usuários novos no grupo. Se um usuário não tiver acesso ao grupo, o bot o removerá assim que ele entrar, então você pode tornar o grupo público ou oculto - ele conterá apenas os participantes que receberam ou pagaram pelo acesso.

Se o histórico do chat é visível para usuários que acabaram de entrar e se os usuários podem salvar conteúdo - tudo isso pode ser configurado adicionalmente ou alterado a qualquer momento.

O que os participantes do grupo podem fazer e com que frequência podem enviar mensagens.