Como funciona
- Seus contatos chegam ao índice de contatos do Reveal: conecte HubSpot ou Mailchimp (sincronizados), Customer.io (consultado no clique) ou envie um CSV. O Reveal guarda apenas um hash de cada email com sal própria da sua conta; contatos descadastrados ou excluídos viram supressões.
- Você assina um
pidpor destinatário e campanha comPOST /v1/reveal/links/signa partir do seu backend, ou em lote pelo console. - Você guarda o
pidnuma propriedade do contato (por exemploprynt_pid) e adiciona?pid=com essa merge tag aos links que apontam para o seu site. - Quando o destinatário clica e há consentimento no seu site, o SDK lê
pid, remove-o da URL que reporta e o envia com o beacon. O Reveal confere a assinatura, a validade e se o contato continua inscrito, e vincula a visita a esse contato como identificação first-party (first_party_link, referência de consentimentolink:<campaign>).
Sem consentimento, com Global Privacy Control ou após um opt-out, o SDK nunca lê o token e o Reveal nunca o usa. O token nunca contém o endereço de email.
Assinar tokens no seu backend
curl https://api.pryntid.com/v1/reveal/links/sign \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"contactRef": "12345", "source": "hubspot", "campaign": "nov-newsletter", "ttlDays": 30}'
# 200 → {"pid": "djEuMTIu…", "expiresAt": "2026-12-03T10:00:00Z"}| Campo | Significado |
|---|---|
contactRef + source | O id do contato na origem: id de registro do HubSpot (hubspot), unique email id do Mailchimp (mailchimp), id do Customer.io (customerio), o contactRef do seu CSV (csv) |
email | No lugar de contactRef: o melhor contato inscrito com esse endereço |
consentRef | Só com email, para um contato que o Reveal ainda não conhece (uma lista do Klaviyo, por exemplo): sua referência do opt-in. O contato é registrado com origem link |
campaign | 1–40 caracteres A-Z a-z 0-9 _ -, padrão email; registrado como referência de consentimento link:<campaign> |
ttlDays | Dias em que o link funciona: padrão 30, máximo 90. Um email encaminhado deixa de funcionar quando o token expira. Links de compartilhamento criados no console (visão somente leitura da conta) duram 7 dias por padrão e 30 no máximo |
Erros: 422 contact_not_eligible se o contato não existe, se descadastrou, fez opt-out ou foi excluído; 401 sem uma chave secreta válida; 429 acima de 600 requisições por minuto por chave. O endpoint exige sua chave secreta: chame-o do seu servidor, nunca do navegador.
Assinatura em lote pelo console
People → Contacts → Bulk sign: envie um CSV com uma coluna contactRef (e source) ou email, escolha a campanha e a validade, baixe o arquivo com a coluna pid e importe-o na sua ferramenta de email como propriedade do contato. As linhas que não podem ser assinadas voltam com o motivo.
Merge tags
| Ferramenta | Referência do contato para assinar | Link decorado |
|---|---|---|
| HubSpot | {{contact.hs_object_id}} · origem hubspot | https://example.com/pricing?pid={{contact.prynt_pid}} |
| Klaviyo | seu próprio id, ou o email com consentRef | https://example.com/pricing?pid={{ person|lookup:'prynt_pid' }} |
| Mailchimp | *|UNIQID|* · origem mailchimp | https://example.com/pricing?pid=*|PRYNTPID|* |
| Customer.io | {{customer.id}} · origem customerio | https://example.com/pricing?pid={{customer.prynt_pid}} |
Mailchimp e Customer.io também funcionam sem assinatura: com o rastreamento de cliques ativo eles adicionam mc_eid / _cio_id aos seus links. Conecte a integração e o Reveal consulta o assinante com a sua própria chave de API (só membros inscritos, cache de 24 horas; a chave é guardada criptografada).
Opções do SDK
PryntReveal.reveal({
publicKey: 'pk_live_…',
pid: { param: 'pid', store: true }, // param padrão 'pid'; store guarda em localStorage 'prynt_pid'
// pid: false // desativa o reconhecimento por links de email
});Com store: true as visitas seguintes do mesmo navegador são reconhecidas sem o parâmetro; um opt-out (Global Privacy Control, setConsent(false), uma recusa no seu gerenciador de consentimento) apaga o token guardado. Um valor de pid que não é um token da Prynt, como um id de produto, não é alterado.
Emails encaminhados
O mesmo token usado em mais de 3 dispositivos é tratado como link encaminhado: a visita continua vinculada, com confiança 0,6 e o motivo shared_link, para que você possa deixá-la fora dos alertas que exigem uma identificação forte. Os tokens estão ligados a um contato da sua conta; um token de outra conta, modificado ou expirado é ignorado.
Privacidade
- Apenas os seus próprios contatos, de ferramentas que você controla, com o consentimento deles. O Reveal nunca adiciona pessoas de outros clientes nem de dados de terceiros.
- O Reveal guarda um hash de cada email com sal própria da sua conta, nunca o endereço, e nunca o coloca num token.
- Contatos descadastrados, limpos ou excluídos viram supressões. Um pedido de exclusão remove a pessoa, marca o contato como excluído para sempre e, no HubSpot, anonimiza as notas da Prynt e marca
prynt_opted_outnos contatos que a Prynt criou. - Conte aos seus assinantes o que você faz: veja Consentimento para os modos de consentimento e o opt-out.
Última atualização 2026-11-03 · Limites · Exclusão do visitante