Reações por e-mail

As reações em e-mails permitem que os usuários respondam às mensagens de forma divertida e sem interrupções. usando emojis.

Formato

Uma reação por e-mail é um e-mail normal no formato 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 nas 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 as partes text/plain e text/html regulares para que os clientes de e-mail que não aceitam reações por e-mail mostrem algo resposta. O Gmail recomenda colocar o text/vnd.google.email-reaction+json entre as partes text/plain e text/html. Isso ocorre porque alguns e-mails os clientes sempre exibem a última parte, independentemente de terem entender seu tipo MIME. Da mesma forma, alguns clientes de e-mail exibem somente o primeiro parte.

O e-mail também precisa ter um cabeçalho In-Reply-To contendo o ID da mensagem de a mensagem à qual a reação se aplica. 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 da reação no e-mail. ao qual esta parte está em conformidade. Precisa ser 1.
  • emoji: uma string que representa exatamente um símbolo de emoji, conforme definido por a Unicode Technical Standard 51 (em inglês).

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

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

Quando o Gmail recebe uma mensagem que parece uma reação, ele valida a parte de 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 incorreta, ela será considerada inválida, e o mensagem não é 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 considera a parte inválida.

  2. O Gmail verifica o campo de versão. A versão precisa ser exatamente 1. Deve ser um inteiro; não pode ser uma string. Conforme o formato evolui, outras versões podem ser aceitos. Se a versão for desconhecida ou ausente, o Gmail considerará a parte inválido.

  3. O Gmail verifica o campo de emojis. O conteúdo precisa ser exatamente um dos emojis especificado pela versão 15 ou superior do Unicode Technical Standard 51 (link em inglês) incluindo todas as extensões referenciadas, como tom de pele. Como o padrão para emojis evoluir, o Gmail compromete-se a oferecer suporte à versão mais recente, a 1. Gmail é compatível com a 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

Nas mensagens com partes de reação válidas, o Gmail mostra o emoji na emoji perto da mensagem especificada pelo cabeçalho In-Reply-To. Isso pode incluir uma contagem de quantas reações são recebidas com o emoji, pode mostrar o remetente dessa reação e possivelmente outros tratamentos na interface. Se o cabeçalho In-Reply-To está ausente ou uma mensagem com o ID fornecido não pode ser na conversa, o Gmail exibe a mensagem de reação como e-mail normal. Observe que o Gmail pode não conseguir encontrar a mensagem porque o o usuário excluiu, a conversa ficou muito longa ou por outros motivos.

Ao mostrar mensagens de reação de e-mail inválidas, o Gmail mostra text/html parte, se ele existir. Caso contrário, ele usará a parte text/plain. Se nenhuma parte do corpo com uma delas, o Gmail exibirá 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, faça o seguinte:

  • As mensagens de listas de e-mails não devem permitir reações.
  • Mensagens com muitos destinatários não devem permitir reações. O Gmail usa uma de 20 destinatários diferentes nos campos combinados To e CC.)
  • 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 podem ser exibidas. (Gmail usa um limite de 20 reações por usuário para cada mensagem.)

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