Para utilizar a integração com o Telegram, siga estes passos:
Acesse a plataforma da Kirvano com seus dados
Selecione a opção "Integrações" no menu.
Escolha Telegram na lista.
A integração está disponível exclusivamente para Canais no Telegram. No momento, não há suporte para grupos.
Para começarmos, será necessário criar um canal no Telegram, caso ainda não tenha.
Depois de criar o canal, vamos identificar os campos necessários para integrar a plataforma Kirvano ao Telegram.
Essa integração requer duas informações essenciais: o token do bot e o ID do canal.
Na imagem abaixo, onde está escrito Vincule o ID do grupo, considere como ID do canal. Da mesma forma, substitua nome do grupo por nome do canal.
O token do bot é único e deve ser obtido utilizando os passos abaixo.
Os IDs dos canais do Telegram correspondem aos canais que o infoprodutor deseja fazer a integração com o produto vendido. Podem ser cadastrados quantos canais o infoprodutor desejar.
Como obter o token do seu bot?
Na conversa com o BotFather, digite /mybots.
Selecione o bot que deseja conectar à Kirvano. Caso ainda não tenha criado um, use o comando /newbot para iniciar a criação. (Neste teste, um novo bot foi criado).
O BotFather solicitará um nome para o bot. Digite o nome desejado e pressione Enter.
Em seguida, será necessário criar um nome de usuário para o bot. (No exemplo, o mesmo nome foi utilizado para ambos.) Digite o nome de usuário e pressione Enter.
Os bots da imagem abaixo são exemplos, você precisa selecionar o seu bot. Se ainda não criou, use o comando /newbot
Logo após, uma mensagem em inglês confirmará que seu bot foi criado com sucesso. Nessa mensagem, você encontrará o token da API.
Copie esse token e guarde-o, pois será necessário colá-lo no campo TOKEN da plataforma Kirvano.
Após concluir as etapas anteriores, o próximo passo é adicionar o seu bot como administrador no canal que você criou. Isso é essencial para que a integração com a Kirvano funcione corretamente.
Como adicionar o bot como administrador?
Abra o aplicativo do Telegram no celular ou no computador – recomendamos essa opção, pois, em alguns casos, o bot pode não aparecer na lista quando o processo é feito pelo navegador web.
Acesse o canal que você criou e toque no nome dele na parte superior da tela.
Vá até a opção "Administradores" e selecione "Adicionar administrador".
Pesquise pelo nome de usuário do seu bot (aquele que você criou no BotFather).
Selecione o bot e conceda as permissões necessárias para que ele possa interagir no canal.
Confirme a ação e finalize.
Certifique-se de que o bot foi adicionado corretamente como administrador e não apenas como membro. Os prints fornecidos são de um sistema IOS, mas o processo é semelhante em dispositivos Android.
o seu bot precisa ser adicionado como admin no canal (Não o bot da Kirvano).
Como obter o ID do Canal?
Para encontrar o ID do seu canal no Telegram, siga estes passos:
Acesse o canal que você criou.
Envie qualquer mensagem no canal.
Encaminhe essa mensagem para o bot @userinfobot o KivanoInfoBot está indisponivel no momento (Neste teste, utilizamos o @userinfobot.)
Anote esse ID, pois ele será necessário para configurar a integração com a plataforma Kirvano.
A mensagem encaminhada será respondida pelo bot com o ID do canal.
Copie esse ID e cole no campo correspondente na plataforma Kirvano.
Lembre-se de incluir o sinal de negativo (-) antes do número, pois ele faz parte do ID e é essencial para a integração funcionar corretamente.
Caso não encontre o bot ao tentar encaminhar a mensagem: acesse https://t.me/KirvanoInfoBot e digite /start.
Encaminhe uma mensagem para o bot KirvanoInfoBot e copie o ID do canal.
Com o Token, ID e nome do grupo preenchidos escolha o produto e clique em Adicionar e depois confirmar.
Pronto a sua integração com o telegram foi criada.
Como é feita a gestão de usuários?
Os acessos aos grupos serão liberados aos compradores quando houver uma compra aprovada.
O link de acesso ao grupo fica disponível na seção de Compras da plataforma.
Esse link também é enviado por e-mail.
Cada link gerado é único e só pode ser usado uma vez.
Caso a compra seja cancelada (reembolso ou assinatura expirada), o comprador é retirado do grupo.
Observações adicionais:
Caso tenha algum problema na integração para adicionar ou remover usuários no canal, remova e adicione o bot do canal como admin;
Nos logs da integração, é possível ver o(s) link(s) gerado(s) para o comprador;
Caso o link esteja cinza na seção de Compras, isso significa que link já foi utilizado;
Ficou alguma dúvida? Entre em contato com o nosso Suporte!