Telegram(Edição)

sendPhoto(chatId,interface photo, options)

response = await telegramBot.sendPhoto(to, mediaUri,User {
  ...replyid: number,
  is_bot: boolean,
  first_name: string,
  last_name?: string,
  username?: string,
  language_code?: string
})

Descrição:

• Informações completas do usuário que enviou a mensagem, incluindo identificação única e dados de perfil.

  Funcionalidade4.3.1 Implementação no DTO: Envio de imagens

• Mídia: Suporte a URLs e file_id

• Reply: Mensagens citadas suportadas

 SendVideo:

sendVideo(chatId,export video,class options)

response = await telegramBot.sendVideo(to, mediaUri,TelegramMessageSender {
  ...reply@IsNumber()
  id: number               // ID único do usuário no Telegram

  @IsBoolean()
  is_bot: boolean          // Indica se é um bot

  @IsString()
  first_name: string       // Nome obrigatório

  @IsString()
  @IsOptional()
  last_name?: string       // Sobrenome opcional

  @IsString()
  @IsOptional()
  username?: string        // @username opcional

  @IsString()
  @IsOptional()
  language_code?: string   // Código do idioma (ex: 'pt-br')
})

• Funcionalidade4.4 PhotoSize Structure (Fotos): Envio de vídeos

• Formatos: MP4 e outros formatos de vídeo

 SendVoice:

sendVoice(chatId,interface voice, options)

response = await telegramBot.sendVoice(to, mediaUri,PhotoSize {
  ...replyfile_id: string,
  file_unique_id: string,
  width: number,
  height: number,
  file_size?: number
})

Descrição:

• Representa uma foto em uma resolução específica. O Telegram envia fotos em múltiplas resoluções (thumbnail, média, alta).

  Funcionalidade4.4.1 Implementação no DTO: Envio de áudios/voice messages

• Formatos: OGG e outros formatos de áudio

SendDocument:

sendDocument(chatId,export document,class options)

response = await telegramBot.sendDocument(to, mediaUri,TelegramMessageMedia {
  ...reply@IsString()
  file_id: string          // ID único do arquivo (temporário)

  @IsString()
  @IsOptional()
  file_name?: string       // Nome original do arquivo

  @IsString()
  @IsOptional()
  mime_type?: string       // Tipo MIME (image/jpeg, video/mp4, etc.)

  @IsOptional()
  @IsNumber()
  width?: number           // Largura em pixels

  @IsOptional()
  @IsNumber()
  height?: number          // Altura em pixels

  @IsOptional()
  @IsNumber()
  file_size?: number       // Tamanho em bytes
})

4.5

• Location Structure (Localização)

  interface Location {
    longitude: number,
    latitude: number,
    live_period?: number,
    heading?: number,
    horizontal_accuracy?: number
  }
  

  FuncionalidadeDescrição: EnvioCoordenadas geográficas compartilhadas pelo usuário, com suporte a localização em tempo real e precisão.

  4.5.1 Implementação no DTO

  export class LocationDto {
    @IsString()
    latitude: string         // Latitude em graus decimais
  
    @IsString()
    longitude: string        // Longitude em graus decimais
  }
  

  ---

  5. MAPEAMENTO DE EVENTOS

  5.1 Mensagem Recebida (MESSAGE)

  const incomingMessage: IncomingMessageDto = {
    uid: payload.message.message_id.toString(),
    sessionId: session._id,
    platformConfigId: session.platformConfigId,
    channelId: session.channelId,
    source: MessageServiceEnum.telegram,
    from: {
      uid: data.from.id.toString(),
      userName: `${data.from.first_name} ${data.from.last_name}`,
    },
    message: {
      body: data?.text || payload?.message?.caption || '',
    },
    type: WebhookTypesEnum.MESSAGE,
  }
  

  Descrição: Converte uma mensagem recebida do Telegram para o formato padrão do Omnichannel, normalizando dados entre diferentes provedores.

  5.2 Mensagem Editada (MESSAGE_UPDATE)

  const status: WebhookStatusDto = {
    platformConfigId,
    channelId,
    type: WebhookTypesEnum.MESSAGE_UPDATE,
    payload: {
      message: {
        from: payload?.edited_message?.from?.id?.toString(),
        to: payload?.edited_message?.chat?.id?.toString(),
        messageId: payload?.edited_message?.message_id?.toString(),
        status: WebhookStatusMessagesEnum.EDITED,
        content: payload?.edited_message?.text || payload?.edited_message?.caption
      }
    }
  }
  

  Descrição: Processa mensagens editadas pelo usuário, criando um evento de documentosatualização que pode ser enviado para a plataforma de destino.

• Tipos5.3 Mídia Recebida: PDF, ZIP, GIF e outros arquivos

3. Gerenciamento de Arquivos

getFileLink(fileId)

Fotos - Seleciona a maior resolução disponível
if (data.photo?.length > 0) {
  const { file_id, file_name, mime_type } = data.photo[data.photo.length - 1]
  incomingMessage.message.media = {
    uri: await telegramBot.getFileLink(file_id),
    contentType: mime_type,
    fileName: file_name,
  }

//
• Documentos

  Funcionalidade:e ObterÁudios URL- deProcessamento downloadunificado deif arquivos

  (data.document
||
• data.voice)

  Uso:{ ConversãoincomingMessage.message.media de= { uri: await telegramBot.getFileLink(data.document?.file_id para|| URLdata.voice?.file_id), acessível

  contentType:
data.document?.mime_type

Estruturasdata.document?.file_name de|| Dadosdata.voice?.file_name, Recebidas

Update Structure

{
  update_id: number,
  message?: TelegramMessageDetail,
  edited_message?: TelegramMessageDetail}
}

MessageDescrição: StructureProcessa diferentes tipos de mídia, convertendo file_ids em URLs acessíveis e normalizando metadados.

5.4 Localização Recebida

if (data.location) {
  message_id:incomingMessage.location number,= from:{
    TelegramMessageSender,latitude: date:Number(data.location.latitude number,|| text?: string,
  caption?: string,
  photo?: TelegramMessageMedia[]0),
    voice?:longitude: TelegramMessageMedia,Number(data.location.longitude document?:|| TelegramMessageMedia,0),
  location?: LocationDto,
  reply_to_message?: TelegramReplyMessage}
}

MediaDescrição: StructureExtrai coordenadas geográficas e as converte para o formato numérico padrão do sistema.

5.5 Mensagem Citada

if (payload?.message?.reply_to_message?.message_id) {
  file_id:incomingMessage.message.quoted string,= file_name?:{ 
    string,id: mime_type?:payload.message.reply_to_message.message_id.toString() 
  string,
  file_size?: number,
  width?: number,
  height?: number}
}

✅Descrição: MensagensIdentifica dequando textouma mensagem é uma resposta a outra mensagem, preservando a referência para contexto da conversa.

Esta

Envio de Mensagens

• ✅ Texto com formatação Markdown

• ✅ Imagens via URL

• ✅ Vídeos via URL

• ✅ Áudios via URL

• ✅ Documentos via URL

• ✅ Mensagens citadas (reply_to_message_id)

• ✅ Adição de nome do usuário nas mensagens

Detecção de Tipos de Mídia

if (mimetype.match(/gif|zip|pdf/)) {
  // sendDocument
} else if (mimetype.match('image')) {
  // sendPhoto
} else if (mimetype.match('audio')) {
  // sendVoice
} else if (mimetype.match('video')) {
  // sendVideo
}

Configuração Automática

• ✅ Setup automático de webhook em desenvolvimento
  

• ✅ Validação de token e configuração

❌ Funcionalidades Não Implementadas

Recursos Disponíveis mas Não Utilizados

• ❌ 

  deleteMessage()

   - Exclusão de mensagens

   

• ❌ 

  sendMessageReaction()

   - Reações em mensagens

   

• ❌ 

  deleteMessageReaction()

   - Remoção de reações

   

• ❌ 

  sendProactiveMessage()

   - Mensagens proativas

   

• ❌ 

  startConversation()

   - Início de conversas (retorna erro)

   

Outros Recursosrecursos da APIbiblioteca Não Implementados

• ❌ Inline keyboards

• ❌ Custom keyboards

• ❌ Polls/enquetes

• ❌ Stickers

• ❌ Games

• ❌ Payments

• ❌ Passport data

• ❌ Chat actions (typing, uploading, etc.)

• ❌ Group management

• ❌ Channel management

• ❌Telegram Bot commandsAPI menu

Fluxo de Processamento

Recebimento (Webhook → Incoming Message)

1. Webhook recebe update do Telegram

2. Validação da estrutura via 

   TelegramMessageDto

3. Mapeamento via 

   telegramPayloadToIncomingMessage

4. Conversão de 

   file_id

    para URL via 

   getFileLink

5. Processamento da mensagemutilizados no sistemaprojeto Omnichannel.

Envio (Outgoing Message → Telegram)

1. Recebimento via 

   SendMessageDto

2. Detecção do tipo de mídia via MIME type

3. Seleção do método apropriado da API

4. Envio com suporte a reply

5. Retorno do 

   message_id