# Telegram

> Ligar o Telegram em Integrações › Integrações prontas: criar um bot no BotFather, colar o token, adicionar o bot ao grupo e usar Encontrar meu grupo. As mensagens levam só o primeiro nome, no idioma da comunidade.

O Telegram publica uma mensagem curta num grupo ou canal pelo **seu** bot: *"Publica uma mensagem curta num grupo ou canal do Telegram pelo seu bot."*

*Papel: proprietário e administrador.* Como ligar, testar, desligar e remover qualquer app está em [Integrações prontas](/integracoes/integracoes-prontas).

## 1. Crie o bot

1. No Telegram, abra uma conversa com o **@BotFather**.
2. Envie `/newbot`, escolha o nome que aparece nas mensagens e o nome de utilizador do bot (termina em `bot`).
3. O BotFather responde com o **token**, algo como `123456789:AAH…`. Copie-o.

Use um bot só para a Memberfy. Um bot que já está ligado a outro serviço por webhook não deixa a Memberfy encontrar os grupos (*"Este bot está ligado a outro serviço (webhook) e o Telegram não mostra os grupos. Use um bot só para a Memberfy."*).

## 2. Coloque o bot no grupo

1. Adicione o bot ao grupo (ou, num canal, como administrador com permissão para publicar).
2. **Envie uma mensagem no grupo.** É ela que faz o grupo aparecer ao bot.

## 3. Ligue na Memberfy

1. Em **Definições › Integrações e APIs › Integrações**, clique em **Telegram**.
2. Cole o token em **Token do bot**.
3. Em **Grupo ou canal**, clique em **Encontrar meu grupo** e escolha o grupo na lista. O id é preenchido automaticamente. Se nada aparecer: *"Nenhum grupo encontrado. Adicione o bot ao grupo, envie uma mensagem lá e tente de novo."*
4. Escolha os eventos e marque **Este app vai receber: …**.
5. Clique em **Ligar** e depois em **Enviar teste**.

Quem já sabe o id do grupo (um número negativo, como `-1001234567890`) ou o `@utilizador` de um canal público pode escrevê-lo diretamente no campo.

## O que chega ao grupo

As mesmas mensagens do [Discord](/integracoes/discord#o-que-chega-ao-canal), em texto simples, sem pré-visualização de ligação, para os seis eventos (membro entrou, compra concluída, subscrição começou, subscrição cancelada, inscrição em evento, curso concluído). Só o **primeiro nome**, nunca o e-mail, no **idioma da comunidade**.

## Problemas comuns

- **"O provedor recusou as credenciais."** O token foi trocado no BotFather (`/revoke`). Cole o novo e guarde.
- **"O provedor não encontrou o canal ou o grupo."** O bot saiu ou foi removido do grupo. Adicione-o de novo e teste.
- **A app ficou Com falha.** Ver [Desligado por falha](/integracoes/integracoes-prontas#desligado-por-falha).

## Relacionados

- [Integrações prontas](/integracoes/integracoes-prontas)
- [Discord](/integracoes/discord)
- [Slack](/integracoes/slack)