Como Integrar com a Membox
A Membox é uma área de membros com aplicativo próprio. Com a integração ativa, quando um novo cliente adquirir um produto na Assiny, as informações desse cliente são enviadas automaticamente para a Membox, que cadastra o aluno e o vincula ao curso. A conexão é feita por uma URL: você a copia na Membox, ao criar a integração, e a cadastra como webhook na Assiny.Antes de começar: como modelar a integração
Esta é a parte que mais gera dúvida, e vale resolver antes de mexer nas duas telas. Quem decide quais cursos o aluno recebe é a integração criada na Membox, e não o produto da Assiny. Ao criar a integração, a Membox pede o tipo de acesso:
Com isso em mãos, o desenho muda conforme o que você vende:
Você poderá criar quantas integrações forem necessárias.
Passo a Passo
Parte 1: Criando a integração na Membox
1
Acesse a Membox
Acesse sua conta na Membox em app.membox.io/login.
2
Abra as Integrações
No menu lateral, clique em Integrações e depois em Adicionar nova.
3
Escolha a Assiny
Clique na opção Assiny para iniciar.
4
Copie a URL da API
Copie a URL da API que a Membox exibe. Ela será usada na Parte 2.
5
Defina o tipo de acesso
Escolha entre Acesso completo e Acesso customizado, conforme a tabela acima. Se escolher Acesso customizado, selecione os cursos que essa integração deve liberar.
6
Crie a integração
Clique em Criar integração.
Parte 2: Configurando na Assiny
Na Assiny, a URL da Membox entra como um webhook do projeto — Webhooks é um item próprio da barra lateral. A URL da API da Membox é geral, e não uma por produto: mesmo que você crie várias integrações do lado da Membox, aqui basta um webhook, com todos os produtos entregues pela Membox em Produtos vinculados.1
Acesse a Assiny
Em outra aba, acesse sua conta na Assiny pelo link
https://admin.assiny.com.br/login, entre na sua organização e abra o projeto.2
Abra os Webhooks
Na barra lateral do projeto, abra Webhooks e clique em Novo Webhook.
3
Preencha a aba Geral
A tela Criando novo webhook está dividida em Geral, Eventos e Avançado. Os três campos de Geral são obrigatórios:
- Nome do webhook — use algo que identifique o destino, por exemplo
Membox - URL — cole a URL da API copiada da Membox na Parte 1
- Produtos vinculados — selecione os produtos que a Membox entrega
4
Selecione os eventos
Na aba Eventos, use o campo Selecione o evento a ser enviado para marcar os eventos que a Membox deve receber. A lista completa aparece no próprio campo.
5
Dispare um evento de teste
Ainda em Eventos, use a área Evento de teste — “Dispare um evento simulado para verificar a integração.” Assim você confirma que a URL da Membox responde antes de criar o webhook.
6
Crie o webhook
Com as abas preenchidas, clique em Criar webhook.
Pronto!
Sua integração está ativa. A Assiny passa a enviar as vendas para a Membox, que cuida da matrícula e do acesso.Depois de configurado
O que acontece na prática, sem nenhuma ação manual:- Na compra, as informações do cliente são enviadas automaticamente para a Membox, e ele é vinculado ao curso conforme o tipo de acesso definido na integração.
- Se o cliente for removido do produto na Assiny, o acesso ao curso correspondente é automaticamente cancelado na Membox.
- Em assinaturas, atraso no pagamento ou cancelamento resulta no bloqueio ou na remoção do acesso.
Se a integração precisar de ajustes
Na Membox, a integração criada continua sendo a fonte da verdade sobre quais cursos o aluno recebe: mudou o pacote, mudou o escopo do Acesso customizado. Na Assiny, a URL e os produtos que alimentam a Membox ficam no webhook cadastrado — abra Webhooks na barra lateral para revisar a URL, os Produtos vinculados e os eventos marcados, ou para disparar um novo Evento de teste.Central de Integrações
Veja todas as integrações disponíveis no painel da Assiny.
Webhooks
Entenda como os webhooks da Assiny funcionam, dos eventos aos logs de disparo.