Reações por e-mail

As reações por e-mail permitem que os usuários respondam mensagens de e-mail de uma maneira 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 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 a Content-Transfer-Encoding for um formato binário, o JSON precisará usar a codificação de caracteres UTF-8. Caso contrário, a Content-Transfer-Encoding poderá ser qualquer codificação padrão.

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

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 com uma parte text/vnd.google.email-reaction+json que ele 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 considerará a parte inválida.

  2. O Gmail verifica o campo version. 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 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 menos

    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 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, além de mostrar o remetente da reação ou 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 encontrar a mensagem se o usuário a tiver excluído, se a conversa for muito longa ou por 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 oferecer suporte a reações por e-mail apliquem limites para evitar que as reações sobrecarreguem os usuários. Especificamente:

  • As mensagens de listas de e-mails não devem oferecer suporte a reações.
  • As mensagens com muitos destinatários não devem oferecer suporte a reações, como mais 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 oferecer suporte a reações.
  • As mensagens que já têm muitas reações não devem oferecer suporte a reações, como mais de 20 reações por usuário para uma única mensagem.

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