#Integrar Principia

Crie uma integração de entrada na Clickmax, cole o API Token da sua conta Principia (antiga Provi), registre a URL gerada no webhook da Principia com o header Authorization — e cada evento com e-mail passa a criar ou atualizar um contato (com a tag principia), enquanto as compras confirmadas 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 Principia você precisa do API Token (menu lateral > Configurações > API Token). Ele é obrigatório: além de autorizar a criação da integração, é o que permite à Clickmax listar seus cursos no seletor de produtos das automações.
• Você também define um valor secreto próprio para autenticar as entregas. Esse mesmo valor vai no campo Token da Clickmax e no header Authorization do webhook da Principia.

#Passo a passo

1. Na Clickmax, abra Integrações e selecione o card Principia.
2. Em outra aba, acesse a Principia e faça login.
3. Na Principia, no menu lateral, vá em Configurações > API Token, copie o token e cole no campo Token da API da Clickmax.
4. Escolha um valor secreto (uma senha longa e aleatória) e cole no campo Token da Clickmax. Guarde-o: você vai reusá-lo no passo 7.
5. Informe um Apelido para a integração e clique em Criar integração.
6. A Clickmax gera uma URL de webhook. Copie essa URL.
7. Na Principia, em Configurações > Webhooks, cadastre a URL copiada e informe o header Authorization com o valor secreto do passo 4.
8. Na Principia, marque os eventos que deseja receber (compra confirmada, compra cancelada, pagamento recusado, financiamento negado, fatura gerada, fatura expirada, carrinho abandonado e avalista necessário).
9. Volte à Clickmax e clique em Concluir integração.

#O que passa a chegar

Cada evento com e-mail cria ou atualiza um contato com a tag principia. Compras confirmadas marcam o contato como cliente e registram a venda; compra cancelada, pagamento recusado e financiamento negado também viram venda registrada, com o resultado correspondente.

Como a Principia é um checkout com financiamento, ela envia etapas que não existem em outros checkouts: financiamento negado (a análise de crédito recusou) e avalista necessário (é preciso um avalista para seguir). As duas chegam como atividade no histórico do contato e podem iniciar automações, junto com fatura gerada, fatura expirada e carrinho abandonado.

Eventos sem o e-mail do comprador são ignorados.

Para a lista completa de eventos reconhecidos e o que cada um dispara, veja a referência de webhooks de entrada e a referência de eventos.

#Relacionados

• Todas as integrações
• Criar sua primeira automação — reaja às compras da Principia
• Integrar Guru e Integrar Hotmart

#Se não funcionou

• A integração não é criada: o Token da API é validado no momento da criação. Se ele estiver errado ou expirado, a Clickmax recusa e nada é salvo — gere um novo em Configurações > API Token. Veja os códigos de erro.
• Nenhum evento chega: o valor do header Authorization no webhook da Principia precisa ser idêntico ao do campo Token da Clickmax — qualquer diferença faz a Clickmax rejeitar a entrega. Confira também se a integração está ativa. Veja os códigos de erro.
• Um evento específico não chega: eventos sem o e-mail do comprador são descartados (a Clickmax não consegue resolver o contato). Confira também se aquele evento está marcado no webhook da Principia. Veja os códigos de erro.
• O curso não aparece no seletor de produtos da automação: o seletor lista os cursos pela API da Principia usando o Token da API. Se ele não foi salvo ou perdeu a validade, a lista vem vazia — nesse caso você ainda pode digitar o id do curso manualmente. Veja as perguntas frequentes.