Telegram
Venda acesso a grupos e canais privados do Telegram, com convite de uso único e remoção automática quando o acesso termina.
Com o Telegram conectado, um produto pode liberar acesso a grupos e canais privados. O bot da MinePag envia ao cliente um convite que só ele consegue usar e remove o cliente do chat quando o acesso é revogado ou expira.
Antes de começar
- O grupo ou canal precisa ser privado. Em um chat público, qualquer pessoa entra sem comprar.
- Você precisa ser administrador do grupo ou canal.
- Na loja, você precisa ser Proprietário ou Administrador. Veja Membros e permissões.
Conectar um grupo ou canal
Gere o código de conexão
No painel da loja, abra Entregas › Telegram e clique em Conectar grupo ou canal. O painel mostra o nome do bot da MinePag, um código e o comando pronto para copiar. O código vale por 30 minutos e só pode ser usado uma vez.
Adicione o bot como administrador
No Telegram, adicione o bot ao grupo ou canal e promova-o a administrador com as permissões:
- Convidar usuários via link;
- Banir usuários.
O bot usa a primeira para criar os convites e a segunda para remover clientes quando o acesso termina.
Publique o comando no chat
Envie o comando no grupo, como administrador, ou publique no canal:
/conectar 7KQ2M9XPO bot responde no chat em alguns segundos.
Confira no painel
Clique em Já publiquei o código. O chat aparece com a situação Conectado, como Grupo ou Canal.
Use o chat em um produto
Em Catálogo › Produtos, abra o produto, adicione o benefício Acesso ao Telegram e marque os chats em Grupos e canais. Se quiser um acesso com prazo, preencha Duração do acesso em dias.
Se o bot responder "Não foi possível conectar", confira se o chat não é uma conversa privada e se o bot é administrador com as duas permissões. Em grupos, só um administrador pode conectar o chat a uma loja.
O que o cliente faz
Vincula o Telegram
Na vitrine, o cliente abre Minha conta › Conexões e clica em Abrir o bot no Telegram. O Telegram abre a conversa com o bot, e o vínculo é feito ao tocar em Iniciar. O link de vínculo vale por 15 minutos.
Recebe o convite
Com a conta vinculada, o bot envia na conversa: "Seu acesso a "VIP Sinais" foi liberado pela loja Minha Loja. Toque no botão para pedir a entrada: a aprovação é automática. O convite vale por 24 horas." O convite também aparece em Minha conta › Conexões, com o botão Entrar no chat.
Pede a entrada
Ao tocar no convite, o Telegram envia um pedido de entrada. O bot aprova só se quem pediu é o cliente com acesso ativo àquele chat, e revoga o convite logo depois. Um convite repassado a outra pessoa é recusado.
Se o cliente comprar antes de vincular o Telegram, a entrega fica Na fila sem gastar tentativas e roda assim que ele vincula. Detalhes em Vincular contas.
Convite vencido
O convite vale por 24 horas. Depois disso, o cliente vê "O convite venceu." em Minha conta › Conexões e pode clicar em Pedir novo convite: o bot envia outro na conversa. Esse é o único reenvio que o cliente consegue fazer sozinho.
Se o cliente já está no chat, a entrega é dada como concluída sem enviar convite.
Remoção do chat
Quando o acesso é revogado (reembolso total, contestação ou cancelamento, conforme as opções do benefício), quando a assinatura termina ou quando a duração do acesso acaba, o bot remove o cliente do chat. A remoção não apaga as mensagens dele e não o impede de entrar de novo com uma compra futura.
Gerenciar a conexão
Cada chat conectado aparece em Entregas › Telegram com quantos benefícios o usam.
- Verificar permissões: confere de novo se o bot continua administrador com as permissões necessárias.
- Cancelar conexão: aparece enquanto o código não foi publicado. O código deixa de valer.
- Desconectar: o chat sai dos benefícios dos produtos e as entregas pendentes para ele passam a falhar. Quem já entrou continua no chat. Exige digitar o nome do chat.
Se alguém remover o bot do chat ou tirar o cargo de administrador dele, a conexão passa para Com erro com o motivo. Enquanto isso, as entregas para esse chat são repetidas a cada 30 minutos e gastam tentativas. Corrija no Telegram e clique em Verificar permissões.
Solução de problemas
| Mensagem ou situação | O que fazer |
|---|---|
| "Código inválido ou expirado. Gere um novo código no painel da MinePag." | O código venceu (30 minutos) ou já foi usado. Gere outro em Conectar grupo ou canal. |
| "Só administradores do grupo podem conectá-lo a uma loja." | Envie o comando com uma conta administradora do grupo. |
| "O bot não tem permissão para convidar ou remover membros neste chat." | Dê ao bot as permissões Convidar usuários via link e Banir usuários, clique em Verificar permissões e reprocesse a entrega. |
| "O bot foi removido do chat no Telegram." | Adicione o bot de novo como administrador e conecte o chat de novo. |
| O cliente diz que o pedido de entrada foi recusado | Confira se a entrega dele está Entregue e se o acesso está ativo. O pedido só é aprovado para a conta do Telegram vinculada pelo próprio cliente. |
| "Integração com o Telegram indisponível" | A integração não está habilitada na plataforma. Fale com o suporte da MinePag. |
Quando o Telegram fica fora do ar ou limita as requisições, a MinePag tenta de novo sozinha, até 8 vezes. Veja Acompanhar entregas.