Telegram

Telegram se conecta de duas formas. Escaneie com seu celular adiciona o bot OmniBrand ao seu canal: nada para criar ou colar. O Avançado usa um bot próprio de @BotFather.

Escaneie com seu celular (recomendado)

1. Na OmniBrand, como Proprietário ou Admin: Configurar → Contas → clique em Telegram em Conectar uma conta. A janela Conectar o Telegram se abre.
2. Escaneie com seu celular, escaneie o código com a câmera do seu celular (no celular, toque Abrir Telegram). Telegram abrir o bot OmniBrand: toque em Iniciar.
3. O bot responde "Vinculado a [seu espaço de trabalho] ([sua organização]). Continue apenas se você acabou de escanear este código no seu próprio computador." Confira se o espaço de trabalho e a organização são seus: se não forem (alguém enviou o código dele para você), não adicione o bot a lugar nenhum. Depois toque em "Adicionar ao canal" (ou "Adicionar ao grupo"), escolha seu canal, mantenha Post Messages ativado e toque em Concluir. O código funciona por 10 minutos; depois de Iniciar, você tem 30 minutos para adicionar o bot.
4. A janela diz "Conectado: [nome do canal]". O bot também diz isso em Telegram.

O que saber:

• Somente alguém que possa adicionar administradores ao canal pode adicionar o bot, e somente a pessoa que escaneou o código o conecta, ao espaço de trabalho que mostrou o código.
• Um canal pode pertencer a um espaço de trabalho. "Já conectado a outro OmniBrand espaço de trabalho" significa: desconectá-lo ali primeiro.
• "Postar Mensagens está desligado": no canal, abra Administradores, toque no bot OmniBrand , ative Postar Mensagens e toque em Salvar. A janela fica em "Conectado" sozinha enquanto está aberta.
• Remover o bot do canal (ou desativar as Postar Mensagens) mostra a conta como Login expirado; adicionar o bot novamente (escanear um novo código) para reconectar.
• Com o bot OmniBrand, mensagens em um grupo conectado chegam à caixa de entrada. Mensagens enviadas privadamente ao bot não chegam, e Transmissões do Telegram precisam do seu próprio bot (Avançado).
• Quando Escaneie com seu celular não é mostrada, este servidor OmniBrand ainda não tem bot compartilhado configurado; use o Avançado.

Avançado: seu próprio robô

Use isso quando quiser seu próprio nome de bot, mensagens privadas para o bot na sua caixa de entrada ou Transmissões do Telegram. Na janela Conecte Telegram, use Use Usar seu próprio bot (avançado)

1. No Telegram, abra @BotFather e envie /newbot. Escolha um nome e um nome de usuário que terminem em "bot". BotFather responde com um token como 123456789:AAE.... Trate como uma senha.
2. Abra seu canal (ou grupo) do Telegram → Administradores → Adicionar Administrador, e adicione o bot. Dê a ele Publicar Mensagens e Excluir Mensagens se quiser que a Retração funcione.
3. Na OmniBrand, como Proprietário ou Admin: Configurar → Contas → clique em Telegram em Conectar uma conta. Na janela Conectar o Telegram, vá para Usar seu próprio bot (avançado).
4. Preencha Token do bot (do BotFather) e Canal: @yourchannel para um canal público, ou o id numérico como -1001234567890 para um privado. Um link t.me/yourchannel também funciona. Para descobrir o id de um canal privado, abra-o no Telegram Web (web.telegram.org/a): o endereço termina com ele, por exemplo #-1001234567890.
5. Clique em Conectar conta. Antes de salvar, a OmniBrand verifica se o token funciona, se o bot vê o canal e se ele é administrador com permissão para publicar (em um grupo, se é membro).

O que acontece depois

• Publicar texto (até 4.096 caracteres), ou uma imagem ou vídeo com legenda de até 1.024 caracteres. Vários anexos em uma postagem: o primeiro é postado (preferido um vídeo) e você é informado.
• Retratar funciona por 48 horas após a postagem; depois disso, o Telegram se recusa a excluir.
• Uma postagem em um canal público recebe um link t.me; postagens em canais e grupos privados não têm nenhum.
• Qualquer pessoa que escreva diretamente para seu bot, e as mensagens dos grupos em que o bot está, chegam à caixa de entrada; sua resposta volta para o mesmo chat. Em um grupo, o Telegram só passa as mensagens endereçadas a ele para um bot, a menos que você desative o modo de privacidade do bot em @BotFather (/setprivacy).

Se algo der errado

• A conexão é recusada com "O Telegram não aceitou este token de bot." - copie o token novamente do @BotFather (envie /mybots, escolha o bot e depois API Token) e cole em Token do bot. Com "O Telegram não encontrou este canal para o bot." - confira Canal: @username para um canal público, o id numérico que começa com -100 para um privado, e se o bot foi adicionado. Com "O bot não é administrador deste canal com permissão para publicar." - no Telegram abra o canal → Administradores, adicione o bot e ative Publicar mensagens, depois clique de novo em Conectar conta. Com "Esse é o chat de uma pessoa com o bot, não um canal nem um grupo." - informe em Canal o @username do canal ou o ID -100. Com "Este grupo foi convertido em supergrupo e agora tem um novo ID" - informe esse ID em Canal.
• A conexão é recusada com "Este bot Telegram envia suas mensagens para outra ferramenta (um webhook está configurado), então OmniBrand não poderia recebê-las. Remova o webhook nessa ferramenta e conecte novamente." - outra ferramenta (um construtor de chatbots, um CRM) pegou as mensagens do bot. Remova o bot dessa ferramenta, ou crie um novo bot em @BotFather para OmniBrand, e depois clique em Conectar conta novamente.
• A conexão é recusada com "Este bot do Telegram já está conectado no OmniBrand, a outro chat ou em outro espaço de trabalho." - Telegram dá a cada bot uma fila de mensagens, então um bot atende um canal ou grupo aqui. Crie um segundo bot em @BotFather para esse canal, ou desconecte o outro primeiro. Reconectar o mesmo canal com o mesmo bot é aceitável.
• Mensagens param de chegar - use este bot apenas com OmniBrand. Um bot que outra ferramenta também lê (ou que tenha um webhook configurado em outro lugar) não pode entregar para ambos; a linha da conta então explica o motivo em Detalhes.
• Login expirado - o token foi revogado no BotFather ('/revoke') ou o bot foi removido do canal. Crie um novo token e conecte novamente. Se uma publicação falhar dizendo que o grupo "foi convertido em supergrupo" com um novo id: desconecte o grupo e conecte-o de novo com esse id em Canal.