Conecte uma conta do Telegram

Você pode conectar sua própria conta do Telegram ao Wbiztool, ao lado dos seus números de WhatsApp. Ela envia pela mesma API e pelas mesmas páginas que um número de WhatsApp, e as pessoas veem suas mensagens como mensagens normais do Telegram enviadas por você.

• Uma API para os dois. Enviar mensagem, Enviar para vários números, Agendar mensagem, Enviar para um grupo, Cancelar mensagem e os webhooks de status da mensagem funcionam do mesmo jeito. Informe o ID da conta do Telegram como whatsapp_client.
• As mesmas páginas. O Envio rápido, as campanhas e os lembretes podem enviar por ela.
• Mais formas de alcançar pessoas. Envie para um número de telefone, um @usuário, um link t.me ou um grupo.

Quem pode fazer isso: Proprietários e Editores conectam e gerenciam contas do Telegram.

Antes de começar#

• O Telegram no seu celular, conectado com a conta pela qual você quer enviar.
• Um endereço de email confirmado.
• Um plano em dia e com uma vaga livre para número. Uma conta do Telegram ocupa uma das vagas para número do seu plano, como um número de WhatsApp. Veja Limites de números.
• Mensagens disponíveis no seu plano. Cada mensagem enviada por uma conta do Telegram usa um crédito de mensagem, como no WhatsApp.

Conectar sua conta#

Na página Números, clique em Adicionar conta do Telegram. Você também encontra esse botão abaixo da janela Adicionar um número do WhatsApp: Vai conectar uma conta do Telegram? Adicionar conta do Telegram.

A janela Adicionar uma conta do Telegram oferece duas formas de entrar: Escanear código QR ou Código de login. As duas dão o mesmo resultado.

Com um código QR#

Use esta forma quando o celular estiver perto do computador.

1. Abra Adicionar conta do Telegram

   Na página Números, clique em Adicionar conta do Telegram. A janela abre com Escanear código QR selecionado.

2. Mostre o código QR

   Clique em Mostrar código QR. A janela Escaneie com o Telegram mostra o código.

3. Abra Conectar Dispositivo no celular

   Abra o Telegram no celular e acesse Configurações → Dispositivos → Conectar Dispositivo.

4. Escaneie o código

   Aponte o celular para o código QR. O código muda a cada 30 segundos: escaneie o mais recente. Quando o login dá certo, a janela mostra Conta do Telegram conectada e "… está conectado. As mensagens que você enviar por esta conta saem pelo Telegram."

Com um código de login#

Use esta forma quando não puder escanear um código QR, por exemplo quando o celular é o seu único dispositivo.

1. Escolha Código de login

   Na janela Adicionar uma conta do Telegram, clique na aba Código de login.

2. Digite seu número

   Confira seu país em Código do país. Em Número de telefone do Telegram, digite o número que sua conta do Telegram usa, sem o código do país, por exemplo 9876543210. Clique em Enviar código de login.

3. Digite o código

   O Telegram envia um código de login para o seu app do Telegram (ou por SMS). Na janela Digite o código de login, digite-o em Código de login e clique em Entrar. A janela então mostra Conta do Telegram conectada.

Verificação em duas etapas#

Se a sua conta tiver verificação em duas etapas, a janela pede a senha do Telegram dela depois do código QR ou do código de login: Digite sua senha do Telegram. Digite sua senha do Telegram (a senha na nuvem) em Senha do Telegram e clique em Entrar. O Wbiztool a usa uma vez para entrar e nunca a guarda.

Depois de conectar#

• A conta ganha um cartão na página Números, com o selo Telegram e o ID dela, por exemplo ID 702. Clique no ID para copiá-lo: use-o como whatsapp_client na API, como para um número.
• Clique em Enviar mensagem de teste para conferir se ela envia. Em Enviar para, digite um @usuário ou um número de telefone com o código do país, por exemplo @name ou +91 98765 43210.
• Renomear e Remover funcionam como para um número de WhatsApp. Veja Gerenciar um número.

Enviar pela sua conta do Telegram#

Escolha a conta do Telegram como qualquer número: em De no Envio rápido, como número de envio de uma campanha ou de um lembrete, ou com o ID dela como whatsapp_client na API. As mensagens dela aparecem em Relatórios, e o webhook de Enviar mensagem informa SENT ou FAILED como no WhatsApp.

curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 702,
    "phone": "@emma_thompson",
    "msg": "Hi Emma, your order #4821 has shipped and will arrive on Thursday."
  }'

Substitua 12345, YOUR_API_KEY e 702 pelos seus próprios valores: 702 é o ID da conta do Telegram, que aparece no cartão dela.

Para quem você pode enviar#

De uma conta do Telegram, phone na API (e os números no Envio rápido, os números de uma campanha e o Enviar para de um lembrete) aceita qualquer um destes:

Nomes de usuário, links t.me e tg:<id> só funcionam a partir de uma conta do Telegram. De um número de WhatsApp, Enviar mensagem e Agendar mensagem respondem "Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client", e Enviar para vários números os ignora.

Qual conta a API escolhe#

Quando você não informa whatsapp_client, Enviar mensagem usa o único número conectado, WhatsApp primeiro:

• Um único número de WhatsApp conectado é usado, mesmo que uma conta do Telegram também esteja conectada. Adicionar uma conta do Telegram não transfere suas integrações existentes para ela.
• Uma conta do Telegram só é usada quando nenhum número de WhatsApp está conectado.
• Um @usuário usa a única conta do Telegram conectada.

Para enviar pela conta do Telegram em qualquer outro caso, informe o ID dela como whatsapp_client.

Grupos#

De uma conta do Telegram, group_name (e Grupos no Envio rápido) aceita:

• o @usuário ou o link t.me de um grupo público, por exemplo @lumen_club ou t.me/lumen_club, ou
• o nome exato de um grupo ou canal do qual a conta participa, por exemplo Lumen VIP Club. Maiúsculas e minúsculas não importam.

A conta já precisa ser membro do grupo e ter permissão para publicar nele. Ela nunca entra em um grupo sozinha.

• Se nenhum grupo corresponder, a mensagem falha com "Group not found".
• Se a conta não puder publicar no grupo, ela falha com "This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post)".

Os limites do Telegram#

O Telegram limita para quantas pessoas que nunca entraram em contato com uma conta ela pode enviar mensagens. As contas novas são as mais limitadas.

• Quando o Telegram pede para ir mais devagar, a conta faz uma pausa e as mensagens dela aguardam. Elas saem depois da pausa.
• Quando o Telegram limita as mensagens para desconhecidos, essa mensagem falha com "Telegram limited this account: it can't message people who haven't contacted it for now. Sending resumes in an hour", e a conta descansa por uma hora.

A caixa de entrada (Unibox)#

Uma conta do Telegram pode ser adicionada à Caixa de entrada do Unibox como um número: em Números da caixa de entrada, clique em Adicionar número à caixa de entrada e escolha a conta. Ela ocupa um dos números da caixa de entrada do seu add-on Unibox, como um número de WhatsApp.

• Os chats privados dela aparecem na caixa de entrada: as mensagens que ela recebe e as mensagens enviadas pelo celular ou pelo Wbiztool. Os chats do Telegram mostram uma marca do Telegram.
• Arquivos de até 16 MB são copiados para a caixa de entrada.
• As respostas funcionam até para pessoas que ocultam o número.
• Grupos, canais, Mensagens Salvas e o chat de serviço do próprio Telegram (aquele com os códigos de login) nunca aparecem.

O webhook de uma conta na caixa de entrada envia as mensagens dela como o de um número. O payload tem platform definido como telegram, e contact.phone e message.from são o número, o @username ou o tg:<id> da pessoa: envie sua resposta para esse valor como phone. Veja Payload.

Desconectar ou reconectar#

• Desconectar no cartão faz a conta parar de enviar. Também tira o Wbiztool da lista de dispositivos da conta no Telegram.
• Se o Telegram encerrar a sessão, por exemplo quando você desconecta o Wbiztool em Configurações → Dispositivos ou a conta é desconectada em todos os lugares, o cartão mostra Não conectado. Proprietários e Editores recebem um alerta de desconexão escrito para o Telegram, como para um número de WhatsApp. Veja Alertas de desconexão do WhatsApp.
• Enquanto a conta não estiver conectada, as mensagens dela aguardam em Aguardando envio.
• Para conectá-la de novo, clique em Reconectar no cartão dela e entre de novo, com um código QR ou um código de login.

Ainda não disponível#

• Exportar os membros de grupos do Telegram. A Exportação de membros de grupos funciona só para grupos do WhatsApp.
• Grupos do Telegram na Caixa de entrada do Unibox. Só os chats privados aparecem lá.

Solução de problemas#

Relacionados#

• Conecte seu número de WhatsApp
• Enviar uma mensagem rápida
• Caixa de entrada do Unibox e Webhooks de mensagens recebidas
• Planos e cobrança
• API: Enviar mensagem, Enviar para um grupo e Listar números conectados