Começar no piloto

Este guia leva uma loja do cadastro ao primeiro Pedido rastreado. Leva cerca de 30 minutos. Você só precisa de uma Fonte de Pedidos: um Webhook (Yampi, Hotmart, checkout próprio) ou a Shopify.

1. Criar a conta

Abra o Admin e escolha Criar conta (ou use o link de convite que recebeu). Confirme o e-mail, aceite os termos e entre.

2. Criar a loja

No primeiro acesso o PrivateLab pede o nome da loja. Informe o nome que seu cliente conhece.

3. Escolher a Marca

Em Marca, escolha a transportadora Pralogo Envios (o ambiente precisa ter o domínio da Pralogo ativo em /platform/domains; sem ele todas as transportadoras aparecem como "Em breve". No staging ela já está ativa), ajuste cores e contato e toque em Publicar marca. Só a Pralogo está disponível no piloto.

4. Publicar o Template

Em Template, revise as etapas e a Origem do envio. Toque em Publicar. Sem Template publicado, nenhum Pedido vira Jornada.

5. Preparar os e-mails

Em Marca > E-mails, toque em Preparar e-mails. No painel: aceite os termos, ligue os e-mails, escolha os Marcos que geram e-mail, confira o remetente e a prévia e toque em Confirmar seleção. Confirmar não envia nada: só libera os próximos Marcos selecionados.

O e-mail só sai se o ambiente estiver com o envio ao cliente ligado (CUSTOMER_EMAIL_ENABLED=1). Com ele desligado, as entregas ficam retidas ("Retido: envio desligado neste ambiente") e o passo 9 não acontece.

6. Conectar a Fonte

Em Fontes, escolha uma das duas.

Webhook genérico

Toque em Nova Fonte, escolha Webhook, copie o endereço e o token (mostrado uma vez). Envie o Pedido pago com POST e Authorization: Bearer <token>:

{
  "contract": "v1",
  "event_id": "A-1042:confirmed",
  "order_id": "A-1042",
  "payment_status": "confirmed",
  "customer": { "name": "Maria Exemplo", "email": "maria@exemplo.com.br" },
  "delivery": {
    "address": {
      "line1": "Rua das Flores, 100",
      "city": "São Paulo",
      "state": "SP",
      "postal_code": "01001-000"
    }
  },
  "items": [{ "name": "Camiseta Aurora P", "shippable": true }]
}

Resposta 202 quer dizer "recebido". O desfecho aparece em Últimas tentativas. Contrato completo: campos opcionais, limites e erros.

Shopify

Em Conexões > Shopify > Gerar link, informe a loja e abra o link logado como dono dela. Autorize. Pedidos pagos passam a chegar sozinhos.

7. Receber o primeiro Pedido

Faça um pedido de teste pago. Ele aparece em Pedidos e vira uma Jornada.

8. Abrir a Página de rastreio

No detalhe do Pedido, copie o link de rastreio e abra. Você vê a Página com a marca da Pralogo e as etapas.

9. O que acompanhar

• Exceções: Pedidos que pedem ação (endereço, pausa, falha). A visão Exceções em Pedidos lista por prioridade.
• Créditos: cada Jornada consome crédito. O aviso "Créditos acabando" aparece na Visão geral.
• E-mails: o detalhe do Pedido mostra se o e-mail foi entregue.

Algo travou? Conte o que viu na tela a quem te convidou.