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
detext/vnd.google.email-reaction+json
e umContent-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 ser1
.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:
O Gmail analisa o JSON e verifica a validade dele. Se o JSON estiver incorreto, O Gmail considera a parte inválida.
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.
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
eCC
.) - As mensagens em que o destinatário não está nos campos
To
ouCC
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.