Telegram
O plugin Telegram permite gerenciar automaticamente o acesso de clientes a grupos do Telegram com base nos eventos de venda da Keoto.
O que é
A integração com o Telegram usa um bot para gerar links de convite únicos e gerenciar a entrada e saída de membros em grupos privados. É ideal para infoprodutores que entregam conteúdo ou suporte via grupos do Telegram.
O que faz
- Gera links de convite únicos para cada comprador quando a venda é aprovada
- Remove membros automaticamente quando a assinatura expira, é cancelada, ou a venda é reembolsada/contestada
- Revoga links de convite ao remover o acesso, garantindo segurança
- Suporta múltiplos grupos — vincule vários grupos a um mesmo produto
- Suporta order bumps — produtos adicionais podem ter seus próprios grupos
Como configurar
1. Crie um bot no Telegram
- Abra o Telegram e procure por @BotFather
- Envie o comando
/newbot - Siga as instruções para criar o bot e receber o Token do Bot
- Adicione o bot como administrador nos grupos que deseja gerenciar
Importante: O bot precisa ter permissão de administrador para gerar links de convite e gerenciar membros.
2. Obtenha os IDs dos grupos
Para obter o ID de um grupo do Telegram:
- Adicione o bot ao grupo
- Envie uma mensagem no grupo
- Acesse
https://api.telegram.org/bot<SEU_TOKEN>/getUpdates - Localize o campo
chat.id— este é o ID do grupo (geralmente um número negativo)
3. Acesse o plugin Telegram na Keoto
- No painel da Keoto, clique em Plugins no menu lateral
- Selecione Telegram
- Clique em Criar nova integração
4. Preencha os dados da integração
| Campo | Descrição |
|---|---|
| Nome | Nome identificador da integração |
| Token | Token do bot (recebido do BotFather) |
| IDs dos grupos | IDs dos grupos separados por vírgula (ex: -1001234567890,-1009876543210) |
5. Vincule ao produto
Selecione o produto da Keoto que dará acesso aos grupos configurados.
6. Salve a integração
Clique em Salvar para ativar a integração.
Eventos e ações
| Evento na Keoto | Ação no Telegram |
|---|---|
| Venda aprovada | Gera link de convite único e envia ao cliente |
| Assinatura cancelada | Revoga link e remove membro do grupo |
| Assinatura expirada | Revoga link e remove membro do grupo |
| Venda reembolsada | Revoga link e remove membro do grupo |
| Venda contestada | Revoga link e remove membro do grupo |
Solução de problemas
”Link de convite não foi gerado”
- Verifique se o bot é administrador do grupo
- Confirme que o token do bot está correto
- Certifique-se de que o ID do grupo está correto (incluindo o sinal de menos)
“Membro não foi removido do grupo”
- O bot precisa ter permissão para banir membros no grupo
- Verifique se o membro entrou pelo link gerado pela integração
”Erro de validação do bot”
- O bot deve estar adicionado e ser administrador de todos os grupos configurados
Precisa de mais ajuda? Entre em contato com nosso suporte.
Last updated on