Cada parceiro é um membro do seu espaço de trabalho com um código pessoal. Você pode transformar membros em parceiros manualmente, tornar parceiro todo mundo que se cadastra, deixar que os membros se ativem sozinhos ou criar parceiros a partir de outro sistema. Este artigo explica cada caminho e onde um novo parceiro fica na sua equipe.
Antes de começar
Os novos parceiros só entram por conta própria enquanto a chave Programa de afiliados estiver ativa e o seu espaço de trabalho estiver no plano Business. As configurações abaixo ficam em Afiliados > Configurações > Geral e exigem a permissão Gerenciar configurações de afiliados. Adicionar parceiros manualmente exige Atualizar afiliados e árvore da equipe.
Quatro formas de virar parceiro
- Você os adiciona. Na aba Afiliados, Adicionar parceiro transforma um membro existente em parceiro. Consulte Gerenciar os seus parceiros.
- Eles se cadastram. Com Novos cadastros se tornam parceiros ativo, todos que criam uma conta viram parceiros na hora.
- Eles se ativam sozinhos. Os membros digitam um código no elemento Copiar link de referência na área de membros.
- Outro sistema os cria pela API.
Um membro só pode ser parceiro uma vez. Seja qual for o caminho de entrada, ele recebe o mesmo cadastro de parceiro, com um único código para todos os seus links.
Tornar parceiros os novos cadastros
- Abra Afiliados > Configurações > Geral.
- Na caixa Cadastro de parceiros, ative Novos cadastros se tornam parceiros.
- Clique em Salvar.
A partir daí, quem se cadastrar pela sua página de cadastro, com o Google ou por
login único vira parceiro. O mesmo acontece com quem se cadastrar pelo
formulário de cadastro incorporado no seu próprio site. Os membros que você
adiciona ou importa manualmente e os compradores não são afetados. Um novo
parceiro recebe um código gerado a partir do nome, por exemplo anna-berg, ou
anna-berg-2 se esse código já estiver ocupado.
Enquanto a chave estiver ativa, a caixa mostra O seu link de cadastro, o endereço da sua página de cadastro, pronto para copiar. Coloque um link para ele no seu site, por exemplo em um botão Seja parceiro.

Se a sua página de cadastro estiver desativada, a caixa avisa A sua página de cadastro está desativada., porque ninguém consegue se cadastrar. Abrir configurações de cadastro leva você às configurações de login, onde você ativa Ativar a página de registro. Consulte Login, cadastro e SSO.
Onde um novo parceiro fica
Um parceiro que se cadastra ou se ativa sozinho é colocado sob um patrocinador na sua equipe. O patrocinador é escolhido nesta ordem:
- O parceiro ao qual o membro já está vinculado, por uma compra anterior ou porque você o atribuiu em Membros gerenciados.
- O parceiro cujo código veio com o cadastro: do link pelo qual o membro chegou, do formulário de cadastro, da visita atual ou do cookie de indicação.
- O Parceiro padrão da caixa Cadastro de parceiros.
- Ninguém. O novo parceiro começa no topo da sua equipe.
Só os parceiros ativos podem ser patrocinadores, e ninguém fica colocado sob si mesmo. O campo Parceiro padrão aparece quando você tem pelo menos um parceiro ativo. Como diz o texto de ajuda, ele só coloca pessoas na estrutura da sua equipe: "A atribuição de comissões das vendas não é afetada."
Quando você adiciona um parceiro manualmente, escolhe o patrocinador em Colocado sob. A lista ali só oferece parceiros ativos, assim como Alterar parceiro quando você move alguém. Um parceiro criado pela API fica sob o patrocinador cujo código a requisição envia, ou no topo. O Parceiro padrão não vale para nenhum dos dois. Para mudar um parceiro de lugar depois, use a árvore da equipe, descrita em Gerenciar os seus parceiros.
Entrar pela área de membros
O elemento Copiar link de referência em um Hub ou no Dashboard mostra aos parceiros o seu link. Um membro que ainda não é parceiro vê no lugar disso um campo de código com o texto de exemplo seucodigo e o botão Ativar.

O código precisa ter no mínimo 3 e no máximo 50 caracteres: letras, números, hifens e sublinhados. Ele é salvo em minúsculas e passa a fazer parte do link de indicação do membro. Se outro parceiro já usar o código, o elemento diz "Este código já está ocupado. Escolha outro." Depois de Ativar, o elemento mostra na hora o link do novo parceiro.
A ativação só funciona enquanto o seu programa estiver ativo e o seu espaço de trabalho estiver no plano Business. Caso contrário, o elemento mostra "O programa de parceiros não está ativo." no lugar do campo de código e do Ativar, e ninguém pode virar parceiro ali. Um parceiro que você passou para inativo também vê o campo de código, mas não consegue se reativar sozinho: o elemento responde "Já está registrado como afiliado."
O formulário de cadastro no seu próprio site
O formulário de cadastro que você incorpora em outro site, configurado na aba
Formulário de cadastro das configurações de login, também traz parceiros.
Quando a página que contém o formulário é aberta com um código de parceiro no
endereço, como ?ref=anna, ?affiliate=anna ou ?partner=anna, o formulário
guarda esse código pelo resto da visita nessa aba do navegador e o envia com o
cadastro.
Enquanto Novos cadastros se tornam parceiros estiver ativo, o novo membro vira parceiro e é colocado sob o parceiro cujo código veio com o formulário. Com a chave desligada, o código não tem efeito no cadastro.
Quem se cadastrar com um endereço de e-mail que já pertence a um membro recebe no lugar disso um link de login. Dessa forma ele não vira parceiro.
Adicionar parceiros a partir de outros sistemas
Uma chave de API pode criar e consultar parceiros. Crie a chave em Configurações > API e limite-a às permissões de que ela precisa da área Afiliados. Consulte Chaves de API e acesso para desenvolvedores.
- Gerenciar cria um parceiro com
POST /v1/affiliates, para um membro existente por ID ou endereço de e-mail. Se nenhum membro tiver esse endereço de e-mail, o membro também é criado, o que exige ainda Gerenciar em Membros e um primeiro nome. Opcionalmente, envie umcode, o código do patrocinador comoparent_codeesend_welcome_mail. O patrocinador precisa ser um parceiro ativo: um patrocinador inativo é recusado com "O afiliado patrocinador não está ativo." (status 422), um código desconhecido com status 404. Um membro que já é parceiro é devolvido sem alterações. - Ver lê um parceiro pelo código com
GET /v1/affiliates/by-code/{code}, ou o parceiro de um membro comGET /v1/members/{id}/affiliate. - Gerenciar também vincula um membro a um parceiro para compras futuras com
PUT /v1/members/{id}/affiliate-claime remove esse vínculo comDELETE. Ler o vínculo comGETexige Ver em Membros.
O e-mail de boas-vindas
Os novos parceiros recebem o e-mail "Bem-vindo ao programa de afiliados" com o seu código, o link da loja e o link de recrutamento. Ele é enviado quando alguém vira parceiro ao se cadastrar ou ao se ativar sozinho. Quando você adiciona um parceiro manualmente, ele só é enviado se você ativar Enviar e-mail de boas-vindas em Adicionar parceiro. Pela API, ele só é enviado se a requisição pedir.
Se a conta de membro foi criada na mesma etapa, pelo formulário de cadastro incorporado ou pela API, o e-mail traz também um botão Definir senha. O novo parceiro o usa para entrar pela primeira vez. Nesse caso, o formulário envia este e-mail no lugar do e-mail de boas-vindas habitual para membros.
A seguir, leia Gerenciar os seus parceiros para ver como editar, mover e remover parceiros.