Fotos, mensagens de voz e arquivos no Telegram

O que seu agente de IA faz com cada coisa que um cliente pode enviar ao seu bot do Telegram: uma resposta a um álbum e à pergunta dele, mensagens de voz e de vídeo que ele escuta, GIFs e stickers, documentos que ele não consegue abrir e onde todo arquivo acaba na caixa de entrada.

Atualizado

Menos de dois minutos: uma oficina de bicicletas conecta o bot, uma cliente manda três fotos, uma pergunta e uma mensagem de voz, o agente responde, e de manhã o mecânico responde ele mesmo.

Clientes no Telegram raramente descrevem um problema com palavras quando podem mostrá-lo. Eles enviam três fotos e uma pergunta, seguram o microfone e falam por vinte segundos, ou gravam uma das mensagens redondas de vídeo do Telegram. Seu agente de IA recebe tudo isso, responde uma vez e guarda cada arquivo em /conversations para a sua equipe.

Pense na Brightwater Bike Repair. Um cliente manda mensagem para o bot do Telegram da oficina: três fotos de uma roda traseira empenada e depois “quanto custa consertar, e você consegue até sábado?”. Um minuto depois, uma mensagem de voz: “ah, e os freios também estão chiando.” O agente responde às fotos e à pergunta em uma única resposta, e depois responde sobre os freios. O mecânico que abre a conversa de manhã vê as fotos, pode reproduzir a mensagem de voz e lê o que foi dito nela.

Uma resposta a um álbum e à pergunta dele

O Telegram entrega um álbum como uma mensagem por foto, e a pergunta digitada junto como mais uma. Responder cada um assim que chegasse seria responder quatro vezes, três delas a fotos que ainda não tinham pergunta.

Então, quando uma mensagem traz uma foto ou um arquivo, o agente espera até que pasem 5 segundos sem chegar mensagem nova e responde tudo o que veio, junto. Ele nunca espera mais de 20 segundos desde a primeira mensagem, por mais que o cliente continue enviando.

  • Texto sem foto ou arquivo é respondido na hora. A espera vale apenas quando uma foto ou um arquivo faz parte do que chegou.
  • Até 20 mensagens são respondidas juntas. Um cliente que envia dois álbuns completos de 10 fotos e depois uma pergunta recebe duas respostas.
  • Uma mensagem enviada enquanto o agente já está escrevendo não entra naquela resposta. Ela ganha a dela, depois que a primeira saiu, então o agente nunca responde a duas coisas ao mesmo tempo no mesmo chat.
A conversa do Telegram da Maya Collins em /conversations: as três fotos de uma roda traseira empenada numa grade, a pergunta “Quanto custa consertar, e você consegue até sábado?” e, embaixo, uma única resposta do agente.
Três fotos e uma pergunta, respondidas uma vez.

O que o agente faz com cada coisa que o cliente envia

O cliente enviaO agente
Uma foto, ou um álbumVê. Até 10 fotos por resposta, na ordem em que foram enviadas, então ele pode falar sobre “a terceira foto”.
Uma mensagem de voz, ou um arquivo de áudioLê uma transcrição do que foi dito e responde a isso.
Uma mensagem redonda de vídeoLê uma transcrição do que foi dito. Ele não vê a imagem.
Um vídeoSabe que chegou um vídeo. Ele não pode assisti-lo e diz isso em vez de adivinhar o que há nele.
Um GIFSabe que chegou um GIF. Ele não pode assisti-lo.
Um stickerVê o emoji do sticker, então um sticker 👍 chega como um joinha.
Um documento — um PDF, uma planilha, um arquivo do WordSabe que chegou um documento, e o nome dele. Ele não consegue abri-lo.

A última linha é a que exige planejamento. Um agente que recebe “aqui está minha nota fiscal, confere o total” vai dizer que não consegue abrir o arquivo, não vai inventar um total. Se seus clientes enviam documentos que seu agente deveria ler, diga a ele nas instruções o que dizer em vez disso — pedir o valor em uma mensagem, ou dizer que uma pessoa vai conferir.

Os arquivos anteriores ficam lembrados como enviados. Na próxima mensagem do cliente, o agente sabe que mais cedo na conversa ele enviou uma foto, uma mensagem de vídeo ou um sticker 👍, e o que ele respondeu. Ele não vê aquelas fotos de novo.

Onde todo arquivo acaba

Abra a conversa em /conversations. Cada arquivo que o cliente enviou fica na thread em que o enviou:

  • As fotos em uma grade, um bloco por foto. Clique em uma para abri-la em tamanho completo.
  • Uma mensagem de voz com um player, e a Transcript dela embaixo.
  • Uma mensagem redonda de vídeo em um player quadrado, com a transcrição embaixo.
  • Um GIF rodando em loop sem som, com um botão Pause GIF sempre visível. Se o seu computador está configurado para reduzir movimento, os GIFs começam pausados.
  • Um sticker como o emoji dele, grande. Na lista de conversas, a prévia diz Sticker 👍.
  • Um vídeo com um player, e um documento como um chip com o nome e o tamanho; clique para abrir o arquivo em uma nova aba.

Um arquivo que não pôde ser salvo mostra uma linha no lugar dele — Photo not available, Voice message not available, Document not available — para você saber que algo foi enviado mesmo quando não pode ser exibido.

Mais abaixo na mesma conversa: a mensagem de voz da Maya com um botão de tocar e, em Transcript, “Ah, e os freios também estão chiando.”, depois a resposta do agente sobre os freios.
Uma mensagem de voz que você pode ouvir, com o que foi dito escrito embaixo.

Coisas que valem saber

  • Arquivos acima de 16 MB não são salvos. A mensagem do cliente ainda chega, com a linha no lugar do arquivo, e o agente é avisado de que não conseguiu carregá-lo.
  • Os arquivos ficam guardados por 180 dias e depois são apagados. As mensagens, e o que as transcrições diziam, ficam.
  • Uma mensagem editada não é respondida de novo. Se um cliente edita uma mensagem depois de enviá-la, o agente responde à original e a caixa de entrada mostra a original.
  • Um bot sem agente ainda guarda tudo. Se nenhum agente está definido para responder no bot, toda mensagem e todo arquivo ainda chegam a /conversations para uma pessoa responder — coloque um agente no seu bot cobre os dois.

Para onde ir depois