Passcodes

O que é um passcode

O passcode é a chave que liga o seu site a um projeto no Reachy. Ele vai no snippet do SDK e identifica para qual projeto os contatos e eventos devem ir. Ele só permite enviar dados, nunca ler, por isso é seguro no código do navegador.

Criar um passcode

1. Entre no Reachy e confira no topo que o projeto ativo é o que vai receber os contatos.
2. Vá em Settings e abra a aba Passcodes.
3. Clique em Adicionar Passcode.
4. Dê um nome que identifique onde ele será usado (ex.: site-institucional, quiz-cartao).
5. Escolha a expiração: sem expiração, ou um prazo em dias para integrações temporárias.
6. Clique em Criar e visualizar e copie o passcode exibido.

O passcode completo aparece uma única vez. O Reachy guarda apenas uma versão protegida dele, então não é possível consultá-lo depois. Se fechar a janela sem copiar, gere outro e exclua o anterior.

Gerenciar passcodes

• A lista mostra nome, data de criação, quem criou e a situação: Ativo ou Expirado.
• Um passcode expirado para de aceitar envios na data definida; o SDK que o usa deixa de enviar dados até receber um passcode novo.
• Para revogar um passcode, exclua-o. Troque o snippet do site antes, para não interromper a coleta.
• É possível filtrar a lista por situação e por quem criou.

Uso no SDK

O passcode entra na configuração inicial do SDK, no snippet do site. É o único campo obrigatório.

<script>
  window.reachy = window.reachy || { event: [], config: [], session: [], privacy: [], identify: [], login: [], queue: [] };
  window.reachy.queue.push({ type: 'config', data: {
    passcode: 'YOUR_PASSCODE'
  }});
</script>
<script async src="https://sdk.reachy.io/sdk.js"></script>

Com o snippet no ar, o SDK envia page views automaticamente e passa a aceitar createContact, trackEvent e web push. O passo a passo completo está em SDK Web do Reachy.

O mesmo passcode autentica a configuração e as inscrições de web push do projeto; não é preciso criar um passcode separado para isso.

Boas práticas

• Um passcode por site ou funil. Você desativa um sem afetar os outros e sabe de onde cada contato veio.
• Nomes descritivos. Use o nome do site ou do funil, não "teste" ou "novo".
• Guarde fora do código. Variável de ambiente do site ou gerenciador de senhas do time; nunca em documentos soltos ou mensagens.
• Use expiração em integrações temporárias. Campanhas sazonais e testes ganham um prazo e deixam de valer sozinhas.
• Troque periodicamente. Crie um passcode novo, atualize o snippet e exclua o antigo.
• Exclua o que não está em uso. Mantenha na lista apenas os passcodes de sites ativos.
• Só no navegador. O passcode serve apenas para o snippet do SDK e para o web push.