#Integrar Yever

Crie uma integração de entrada na Clickmax, cole o Api Token da sua conta Yever, registre a URL gerada nos webhooks da Yever — e cada evento com e-mail passa a criar ou atualizar um contato (com a tag yever), enquanto os pedidos pagos viram vendas na Clickmax.

Antes de começar

• Papel de workspace: Proprietário, Administrador, Editor ou Colaborador. Os papéis Financeiro, Convidado e Atendente não têm acesso a Integrações.
• Plano:
• Da sua conta Yever você precisa do Api Token (Configuração > API > Novo token), que a Clickmax usa para listar seus produtos nos gatilhos. Ele só é exibido no momento em que é criado — se você perder, gere outro.
• O Token do webhook é gerado pela própria Yever quando você cadastra o webhook, então ele só existe depois do passo 6.

#Passo a passo

1. Na Clickmax, abra Integrações e selecione o card Yever.
2. Em outra aba, acesse a Yever e faça login.
3. Na Yever, vá em Configuração > API > Novo token, copie o token gerado e cole no campo Api Token da Clickmax.
4. Informe um Apelido para a integração e clique em Criar integração. Deixe o campo Token vazio por enquanto.
5. A Clickmax gera uma URL de webhook. Copie essa URL.
6. Na Yever, vá em Configuração > Webhooks > Novo webhook e cole a URL copiada.
7. Marque os eventos que deseja receber: Pedidos, Carrinho abandonado, Assinatura e Cashback. Dentro de Pedidos, habilite também Pedido pago — webhooks criados antes desse evento existir não vêm inscritos nele automaticamente.
8. Copie o token que a Yever exibe na tela do webhook, volte à Clickmax, edite a integração e cole no campo Token.
9. Clique em Concluir integração.

#O que passa a chegar

Cada evento com e-mail cria ou atualiza um contato com a tag yever. Pedidos pagos marcam o contato como cliente e registram a venda; reembolso, chargeback e cancelamento também viram venda registrada. Eventos sem e-mail do cliente são ignorados.

A Yever dispara Pedido pago e Pedido atualizado na mesma transição de pagamento. A Clickmax usa apenas o Pedido pago nesse caso, então a automação roda uma vez só.

#Pedido com mais de um produto

Um pedido com order bump (ou vários itens) gera uma venda na Clickmax, com o valor total do pedido — não uma venda por produto. Na lista de vendas externas o produto principal aparece com um selo +N indicando os itens adicionais.

No histórico do contato é o contrário: entra uma atividade por produto, cada uma com o valor daquele item, e os que a Yever marca como order bump ganham o selo Order bump. É assim que você vê exatamente o que foi comprado no pedido.

Nos fluxos, o gatilho filtrado por produto dispara se aquele produto estiver no pedido — inclusive quando ele veio como order bump.

#Filtrar por produto

Nos gatilhos de pedido e de assinatura você pode escolher um produto: a Clickmax lista os produtos direto da sua Yever usando o Api Token. O filtro casa pelo id do produto, então renomear o produto na Yever não quebra nada.

Os gatilhos de cashback não têm filtro de produto — a Yever não informa o produto nesses eventos, então eles disparam para qualquer cashback.

#Carrinho abandonado filtra pelo nome do produto

O evento de carrinho abandonado da Yever não informa o id do produto, apenas o nome. Por isso, quando você filtra esse gatilho por produto, a Clickmax compara pelo nome.

Consequência prática: se você renomear o produto na Yever, o gatilho para de disparar — o nome salvo no filtro deixa de bater com o que chega no webhook. Nesse caso, abra o gatilho de novo, selecione o produto na lista atualizada e salve. Se preferir não depender disso, deixe o filtro vazio para disparar em qualquer carrinho abandonado.

#Relacionados

• Todas as integrações
• Criar sua primeira automação — reaja aos pedidos da Yever
• Integrar Guru e Integrar Hotmart

#Se não funcionou

• Não consigo criar a integração: a Clickmax valida o Api Token na criação. Se ele estiver errado ou vencido, gere outro em Configuração > API na Yever. Veja os códigos de erro.
• Nenhum evento chega: confira se o Token exibido pela Yever foi colado na integração — sem ele a Clickmax rejeita as entregas. Confira também se os eventos foram marcados no webhook da Yever. Veja as perguntas frequentes.
• Pedido pago não chega, mas os outros chegam: habilite Pedido pago na tela do webhook na Yever. Webhooks antigos não vêm inscritos nesse evento.
• Um evento específico não chega: eventos sem o e-mail do cliente são descartados (a Clickmax não consegue resolver o contato). Veja os códigos de erro.
• A automação de carrinho abandonado parou de disparar: o produto provavelmente foi renomeado na Yever. Reabra o gatilho, selecione o produto na lista atualizada e salve.