Reações por e-mail

As reações a e-mails permitem que os usuários respondam a mensagens de e-mail de uma maneira divertida e sem atrito usando emojis.

Formato

Uma reação a um e-mail é um e-mail normal com formato MIME e 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 pode ser:

  • 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 de várias partes 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 uma 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, independentemente de entenderem ou não 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. Ele precisa ser um único ID de mensagem.

Definição da parte text/vnd.google.email-reaction+json

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

  • version: um número inteiro que representa a versão do formato de reação aos e-mails com que esta parte está em conformidade. Precisa ser 1.
  • emoji: uma string que representa exatamente um símbolo de emoji, conforme definido pela especificação técnica 51 do Unicode.

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 ser uma reação, ele valida a parte da reação e aplica um tratamento de exibição especial 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 com formato incorreto, ela será considerada inválida e a mensagem não será tratada como uma reação.

Especificamente, faça o seguinte:

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

  2. O Gmail verifica o campo de versão. A versão precisa ser exatamente 1. Ele 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 como 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 Unicode Technical Standard 51, incluindo todas as extensões referenciadas, como o 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, 1. O Gmail provavelmente oferece suporte à versão mais recente, exceto para a 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 considerará a parte como inválida.

Display

Para mensagens com partes de reação 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, pode mostrar o remetente dessa reação e, possivelmente, outros tratamentos de IU. Se o cabeçalho In-Reply-To estiver ausente ou uma mensagem com o ID fornecido não puder ser encontrada na conversa, o Gmail vai mostrar a mensagem de reação como um e-mail normal. O Gmail pode não encontrar a mensagem porque o usuário a excluiu, a conversa ficou muito longa ou por outros motivos.

Ao mostrar mensagens de reação a e-mails inválidas, o Gmail mostra 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 esses elementos, o Gmail vai mostrar uma mensagem vazia.

Limites

O Gmail recomenda que os clientes que queiram adicionar suporte a reações a e-mails adicionem alguns limites para evitar que as reações sobrecarreguem os usuários. Especificamente, faça o seguinte:

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

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