Skip to main content
Resumo: o destinatário recebe um endereço curto e não precisa de senha, cadastro nem aplicativo. A página abre no celular, mostra só o que falta e atualiza sozinha conforme cada item é analisado.
O link sai no domínio da plataforma ou no seu domínio próprio, quando ele estiver verificado. O endereço completo vem pronto no envio e na resposta da API: use-o como veio, sem montar. O token tem 43 caracteres, um por destinatário. Ele identifica a pessoa e o escopo dela, então dois destinatários da mesma solicitação recebem links diferentes e cada um só enxerga os próprios itens.

​
Quem chega pelo formulário público

O formulário público é a porta de entrada irmã desta página, no mesmo domínio (/form/{código}). A pessoa se identifica, confirma o contato por um código e é levada para esta mesma página, com o link da solicitação dela. Não existe um segundo portal: o que ela vê daí em diante é igual ao de qualquer destinatário.

​
O que a pessoa faz na página

Ela pode ainda:
  • Pedir um link novo quando o dela venceu (quem reemite é o operador, nunca a página).
  • Convidar outra parte para um documento conjunto, quando o item permite.
  • Informar o contato de uma parte que o documento já nomeou.

​
Tempo real

A página escuta um canal em tempo real e atualiza sozinha quando um item muda de estado, sem recarregar e sem polling. O nome do canal é derivado do token por HMAC: quem tiver apenas o hash guardado (um backup, um dump, um log de query) não consegue escutar o canal de ninguém. O token nunca é gravado nem registrado em log: o que se guarda é o hash dele. Estouro de limite responde 429 com mensagem em português.

​
Sua marca na página

Com a capacidade communicationBrandingEnabled, a página do destinatário e as mensagens saem com a identidade da sua empresa, e não com a da GYRA+.

​
Logo e cores

Logo enviado pelo painel, e quatro cores em hexadecimal de 6 dígitos: As mesmas cores valem nas telas do toolbox: a marca é uma só, configurada num lugar só. Em vez do domínio da plataforma, o link sai no seu domínio. Vale para o link do destinatário e para o endereço do formulário público. Você declara o domínio, a plataforma devolve os registros de DNS a publicar, e depois pede a verificação. Enquanto o DNS não confere, o link continua saindo no domínio da plataforma.

​
Remetente próprio do e-mail

Mesmo desenho: você declara o domínio do remetente, publica os registros de DNS que a plataforma devolve e pede a conferência. Sem isso, o e-mail sai do remetente da plataforma.

​
WhatsApp próprio

Você conecta o número da sua empresa, e a plataforma confere o token contra a Meta. O texto do convite é salvo e submetido para aprovação da Meta, e o painel mostra o estado do modelo (em análise, aprovado, recusado). Desconectar volta ao número da plataforma.

​
Pré-visualização

Antes de enviar, dá para ver a mensagem exata que vai sair (e-mail e WhatsApp) e a página do destinatário como ela vai aparecer, com a marca aplicada.