Enviando uma mensagem documento no bot Telegram
Mensagem documento no Telegram - método universal para enviar arquivos de qualquer formato no Telegram. É usado para transferir PDFs, Excel, Word, arquivos e outros tipos de dados que não podem ser enviados por meio de métodos especializados (`sendPhoto`, `sendAudio`). O Telegram mantém a qualidade original dos arquivos, adiciona visualizações (para formatos suportados) e permite acompanhar o documento com uma assinatura formatada. O tamanho máximo é de 2 GB, tornando o método ideal para a troca de dados profissional
Quais formatos de mensagem de áudio são aceitos no Telegram e quais são as restrições?
O mensageiro permite enviar, por exemplo:
- Documentos de escritório - PDF, DOCX, XLSX e outros.
- E-books.
- Planilhas Excel.
Restrição
- Tamanho máximo do ficheiro a enviar - 2 GB (com Telegram Premium 4 GB).
- Comprimento máximo do nome do ficheiro — 60 caracteres.
- Ao adicionar arquivos através do aplicativo Telegram para Smartphone eles são enviados sem assinatura por padrão-você pode adicioná-los a cada arquivo após a publicação.
Erros comuns ao enviar uma mensagem de Documento
400 pedido inválido: identificador de ficheiro incorrecto
- Causa: URL inválido, file_id quebrado ou acesso restrito ao arquivo.
- Solução: Verifique o Content-Type e a disponibilidade do recurso.
413 Pedido De Entidade Demasiado Grande
- Razão: Arquivo > 2 GB.
- Solução: compacte o arquivo ou divida o arquivo.
400 pedido inválido: a miniatura deve ser JPEG e <200 KB
- Solução: Aperte pré-visualização personalizada:
400 Solicitação incorreta: não é possível analisar entidades de legenda
- Causa: erro na marcação de assinatura HTML/Markdown.
- Solução: Verifique a blindagem das tags.
403 Proibido: o Bot não pode enviar mensagens no chat
- Solução: dê ao bot privilégios de administrador no chat / canal.
Informação
Informações técnicas para"API BOT-MARKET"
- Código do tipo de mensagem ('messageType`): "8" (para`sendDocument').
- Velocidade máxima de envio: 10 Mensagens / segundo (devido ao grande tamanho dos arquivos).
Conselhos para uma utilização eficaz
1. Otimização de nome de arquivo:
- Use o alfabeto latino e underscores: sales_report_Q2_2024.xlsx em vez de relatório para o trimestre 2 2024.xlsx.
2. Pré-visualização de documentos:
- Para PDF: O Telegram gera automaticamente uma pré-visualização da primeira página.
- Para outros formatos: crie uma captura de tela JPEG.
3. Segurança:
- Senha arquivos com dados confidenciais → envie uma senha por mensagem separada.
