Reações por e-mail

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

Formato

Uma reação por e-mail é um e-mail normal 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 formatada 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 normais text/plain e text/html para que os clientes de e-mail que não oferecem suporte a reações por e-mail ainda mostrem algo como uma resposta. O Gmail recomenda colocar a parte text/vnd.google.email-reaction+json entre as partes text/plain e text/html. Isso ocorre 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 só mostram a primeira parte.

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

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

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 essa parte está em conformidade. Esse valor precisa ser 1.
  • emoji: uma string que representa exatamente um símbolo de emoji, conforme definido por o padrão técnico Unicode 51.

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 poderá 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 de exibição especial a essa mensagem.

Validação

O Gmail valida todas as mensagens recebidas com uma parte text/vnd.google.email-reaction+json. 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 considerará a parte inválida.

  2. O Gmail verifica o campo de versão. A versão precisa ser exatamente 1. Ela precisa ser um número inteiro e não pode ser uma string. À medida que o formato evolui, outras versões podem ser aceitas. Se a versão for desconhecida ou estiver ausente, o Gmail 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 - 1. O Gmail provavelmente oferece suporte à versão mais recente, exceto pela janela necessária para implementar qualquer padrão recém-lançado. Se o campo estiver ausente, vazio ou não contiver exatamente um emoji, o Gmail 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, potencialmente, outros tratamentos de interface. 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 mostrará a mensagem de reação como um e-mail normal. O Gmail pode não conseguir encontrar a mensagem porque o usuário a excluiu, a conversa ficou muito longa ou por vários outros motivos.

Ao mostrar mensagens de reação por e-mail inválidas, o Gmail mostra a parte text/html, se ela existir. Caso contrário, ele usa a parte text/plain. Se nenhuma parte do corpo com um desses elementos existir, o Gmail mostrará uma mensagem vazia.

Limites

O Gmail recomenda que os clientes que querem adicionar suporte a reações por e-mail adicionem alguns limites para evitar que as reações sobrecarreguem os usuários. Especificamente:

  • As mensagens de listas de e-mails não devem permitir reações.
  • As mensagens com muitos destinatários não devem permitir 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 devem permitir reações.
  • As mensagens que já têm muitas reações não devem permitir 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 emoji" de Responder e-mails com reações de emoji.