Reações por e-mail

Com as reações por e-mail, os usuários podem responder mensagens de forma divertida e sem atrito usando emojis.

Formato

Uma reação por e-mail é um e-mail comum formatado em MIME com uma parte especial que indica que é uma reação.

Formato geral da mensagem

O e-mail precisa ter uma parte do corpo com Content-Type: text/vnd.google.email-reaction+json formatado conforme descrito na definição.

Uma parte do corpo é:

  • A parte de nível superior da mensagem. Isso significa que o cabeçalho Content-Type do e-mail é text/vnd.google.email-reaction+json.
  • Uma subparte de uma parte MIME multipart que tem um Content-Type de text/vnd.google.email-reaction+json e um Content-Disposition que não é attachment.

O e-mail de reação também precisa ter partes text/plain e text/html normais para que os clientes de e-mail que não oferecem suporte a reações ainda mostrem algo como resposta. O Gmail recomenda colocar a parte text/vnd.google.email-reaction+json entre as partes text/plain e text/html. Isso acontece porque alguns clientes de e-mail sempre mostram a última parte, mesmo que não entendam o tipo MIME. Da mesma forma, alguns clientes de e-mail mostram apenas a primeira parte.

O e-mail também precisa ter um cabeçalho In-Reply-To com o ID da mensagem a que a reação se aplica. Precisa ser um único ID de mensagem.

text/vnd.google.email-reaction+json definição de peça

Essa parte MIME está no formato JSON. Ela tem dois campos:

  • version: um número inteiro que representa a versão do formato de reação por e-mail a que esta parte está em conformidade. Ele precisa ser 1.
  • emoji: uma string que representa exatamente um símbolo de emoji, conforme definido pelo Unicode Technical Standard 51 (em inglês).

Se o Content-Transfer-Encoding for um formato binário, o JSON precisará usar a codificação de caracteres UTF-8. Caso contrário, o Content-Transfer-Encoding pode ser qualquer codificação padrão.

Interpretação do Gmail de text/vnd.google.email-reaction+json

Quando o Gmail recebe uma mensagem que parece uma reação, ele valida a parte da reação e aplica um tratamento especial de exibição a essa mensagem.

Validação

O Gmail valida todas as mensagens com uma parte text/vnd.google.email-reaction+json que recebe. Se a parte estiver malformada, ela será considerada inválida, e a mensagem não será tratada como uma reação.

Especificamente:

  1. O Gmail analisa o JSON e verifica a validade dele. Se o JSON estiver malformado, o Gmail vai considerar a parte inválida.

  2. O Gmail verifica o campo de versão. A versão precisa ser exatamente 1. Precisa ser um número inteiro, não uma string. À medida que o formato evolui, outras versões podem ser aceitas. Se a versão for desconhecida ou estiver ausente, o Gmail vai considerar a parte inválida.

  3. O Gmail verifica o campo de emoji. O conteúdo precisa ser exatamente um dos emojis especificados pela versão 15 ou mais recente do Padrão Técnico Unicode 51, incluindo extensões referenciadas, como tom de pele. À medida que o padrão de emoji evolui, o Gmail se compromete a oferecer suporte a pelo menos a versão mais recente, a 1. O Gmail provavelmente oferece suporte à versão mais recente, exceto pela janela necessária para implementar qualquer padrão lançado recentemente. Se o campo estiver ausente, vazio ou não contiver exatamente um emoji, o Gmail vai considerar a parte inválida.

Display

Para mensagens com partes de reação por e-mail válidas, o Gmail mostra o emoji no campo de emoji perto da mensagem especificada pelo cabeçalho In-Reply-To. Isso também pode incluir uma contagem de quantas reações são recebidas com esse emoji, mostrar o remetente da reação e, possivelmente, outros tratamentos de interface. Se o cabeçalho In-Reply-To estiver faltando ou se uma mensagem com o ID especificado não for encontrada na conversa, o Gmail vai mostrar a reação como um e-mail normal. O Gmail talvez não consiga encontrar a mensagem porque o usuário a excluiu, a conversa ficou muito longa ou por qualquer outro motivo.

Ao mostrar mensagens de reação por e-mail inválidas, o Gmail exibe a parte text/html se ela existir. Caso contrário, ele usa a parte text/plain. Se não houver nenhuma parte do corpo com uma dessas características, o Gmail vai mostrar uma mensagem vazia.

Limites

O Gmail recomenda que os clientes que querem adicionar suporte para reações por e-mail incluam alguns limites para evitar que os usuários sejam sobrecarregados. Especificamente:

  • As mensagens de listas de e-mails não podem ter reações.
  • Mensagens com muitos destinatários não devem permitir reações. O Gmail usa um limite de 20 destinatários distintos nos campos combinados To e CC.
  • As mensagens em que o destinatário não está nos campos To ou CC não podem ter reações.
  • Mensagens que já têm muitas reações não devem permitir mais reações. O Gmail usa um limite de 20 reações por usuário em cada mensagem.

Esses e outros limites também são descritos na seção "Não é possível enviar reações com emoji" em Responder e-mails com reações com emoji.