Integrações: conecte a Cooud às suas outras ferramentas

A maioria das integrações da Cooud é orientada a eventos: sempre que algo acontece com um pedido da sua loja, a Cooud avisa a ferramenta conectada para que ela tome a ação certa. É por isso que, ao conectar uma área de membros, o aluno ganha acesso assim que o pagamento é confirmado e perde o acesso se houver reembolso, sem que você precise mexer em nada.

Os principais momentos do ciclo de vida de um pedido que disparam as integrações são:

As integrações são configuradas por loja. Você as encontra no painel, na seção Integrações, com uma busca e um contador de quantas estão ativas. Cada serviço aparece como um cartão que você ativa e configura informando as credenciais — normalmente uma chave de API ou token gerado dentro da própria ferramenta. Se desativar uma integração, será preciso configurá-la de novo para reativá-la.

• Pedido criado (order.created): a compra foi iniciada e o pedido registrado — ainda pode não estar pago.
• Pedido pago (order.paid): o pagamento foi confirmado. É o gatilho que libera acesso, sincroniza o cliente e emite a nota.
• Pedido atualizado (order.updated): algum dado do pedido mudou.
• Pedido reembolsado (order.refunded): houve reembolso; integrações de área de membros revogam o acesso automaticamente.
• Loja atualizada (store.updated): os dados da sua loja foram alterados.

O painel agrupa as integrações por finalidade, para você achar rápido o que precisa. Hoje você pode conectar:

Cada categoria resolve uma parte da operação: a área de membros entrega o produto, o CRM nutre o relacionamento, o fiscal cuida das notas, o e-commerce conecta lojas externas, o upsell aumenta o valor de cada venda e o rastreamento mostra de onde vêm os resultados. Você pode combinar quantas integrações quiser. E se a ferramenta que você usa não estiver na lista, dá para conectá-la via API e webhooks — explicamos isso no final.

• Área de membros (entrega de conteúdo): MemberKit (área de membros para cursos e conteúdos), Astron Members (área de membros com gamificação) e HuskyApp (assinaturas e cobranças recorrentes).
• Rastreamento e atribuição: UTMify (rastreamento avançado de UTMs e conversões) e Xtracky (rastreamento de vendas e atribuição de conversões).
• E-commerce (loja virtual): WooCommerce e Shopify, para sincronizar pedidos — e, no Shopify, também produtos — com a sua loja externa.
• Automação & CRM: ActiveCampaign, para automação de marketing e relacionamento com seus contatos.
• Fiscal: eNotas, para emissão automática de notas fiscais a cada venda.
• Upsell: AppSell, para upsells e order bumps que aumentam o seu ticket médio.

Conectar é rápido e segue sempre a mesma lógica. No painel da sua loja:

Guarde suas credenciais com cuidado, pois elas dão acesso à sua conta na ferramenta externa. Se uma chave vazar ou você parar de usar a integração, revogue-a na ferramenta de origem e gere uma nova. Lembre-se também de que desativar uma integração na Cooud apaga a configuração — para voltar a usá-la, você terá de configurá-la novamente.

• Abra a seção Integrações e localize o serviço desejado (use a busca, se preferir).
• Clique no cartão da integração para ativá-la e abrir a configuração.
• Cole a credencial pedida — em geral uma chave de API ou token gerado no painel da própria ferramenta externa.
• Salve. Em integrações de área de membros, faça também o mapeamento das ofertas (veja a próxima seção).
• Faça uma compra de teste e confirme que a ação aconteceu (acesso liberado, contato criado, nota emitida) antes de divulgar.

O uso mais comum de integração é entregar o produto automaticamente. Depois de conectar MemberKit, Astron Members ou HuskyApp, o fluxo passa a ser simples: pagamento confirmado libera o acesso; reembolso revoga o acesso. O comprador entra no conteúdo em segundos, sem você liberar manualmente.

No MemberKit, você pode ir além e mapear cada oferta (preço) do seu produto para uma turma ou área específica, definindo também um destino padrão no nível da loja. Assim, compradores de ofertas diferentes entram automaticamente no conteúdo certo, e quem adquire uma oferta sem mapeamento explícito cai nesse destino padrão — ninguém fica sem acesso.

Um ponto importante sobre o gatilho: o acesso é liberado quando o pagamento é confirmado. Compras no cartão confirmam na hora; o boleto, por sua vez, só confirma após a compensação, então o acesso por boleto é liberado quando o pagamento é compensado, e não no momento em que o boleto é gerado.

Em caso de reembolso, a revogação é reversível: se o cliente comprar novamente, o acesso é reativado automaticamente — você não precisa recriar nada.

Para saber de onde vêm suas vendas, a Cooud trabalha em duas frentes. A primeira são os conectores de rastreamento UTMify e Xtracky: ao ativá-los, suas vendas confirmadas são enviadas para essas plataformas com os dados de origem (UTMs). Isso entrega uma atribuição muito mais confiável do que depender apenas do navegador — você deixa de perder conversões por bloqueio de anúncios ou limitações do lado do cliente.

A segunda frente são os pixels e scripts na própria página de checkout. No construtor de checkout, na área de rastreamento, você informa os IDs dos seus pixels (como Meta, Google e TikTok) para que os eventos de conversão disparem na finalização da compra. Para configurações mais avançadas, é possível adicionar seus próprios scripts de rastreamento e analytics (por exemplo, Google Tag Manager), que passam a rodar no checkout ao vivo.

Sempre valide o rastreamento com uma compra de teste e confira se o evento de conversão chegou na sua ferramenta de anúncios antes de escalar o investimento. Pixel mal configurado é a causa mais comum de 'vendas que não aparecem' no gerenciador de campanhas.

• UTMify e Xtracky: atribuição das vendas confirmadas no servidor — ideal para otimizar campanhas de tráfego pago.
• Pixels no checkout (Meta, Google, TikTok): disparam os eventos de conversão na finalização da compra.
• Scripts personalizados: para GTM e analytics próprios, quando você precisa de algo além dos pixels padrão.

Se você precisa de algo que não está no catálogo — conectar um sistema próprio, um ERP ou qualquer ferramenta via automação — a Cooud expõe API e webhooks na seção do Desenvolvedor, que reúne APIs, chaves, webhooks e domínios do checkout em um só lugar.

Tokens e chaves de API: você gera tokens no servidor para autenticar chamadas à API da sua loja. As chaves nativas da API v2 vêm em dois ambientes — cooud_sk_sandbox_ (para testar sem cobranças reais) e cooud_sk_live_ (produção). Cada chave secreta é exibida uma única vez, então copie e guarde com segurança. A regra de ouro: chaves secretas vivem só no seu servidor ou back-end, nunca em código de frontend, páginas públicas ou apps de navegador. Avançar a versão da API v2 é uma ação definitiva e sem volta, e habilita recursos como a compra com um clique (one-click) no pós-compra; teste no sandbox antes e, para liberar a compra com um clique em produção, fale com o suporte.

Webhooks: você cadastra uma URL HTTPS de destino e escolhe quais eventos quer receber (os mesmos do ciclo do pedido: criado, atualizado, pago, reembolsado, além de loja atualizada). Use order.paid como confirmação de pagamento para liberar acesso externo. Cada webhook novo mostra um webhook_secret uma única vez, e as notificações são assinadas com o cabeçalho X-Cooud-Signature — verifique essa assinatura no seu servidor antes de confiar no conteúdo recebido. Boas práticas:

Ainda na área do Desenvolvedor estão os Domínios do checkout: se você usa o checkout embutido no seu próprio site, adicione ali os domínios HTTPS onde ele roda. A Cooud registra cada domínio autorizado para que o checkout funcione com segurança no endereço da sua loja, garantindo que os pagamentos por cartão e boleto sejam processados corretamente.

• Responda 200 rapidamente e processe o restante de forma assíncrona.
• Descarte eventos duplicados pelo event.id ou order.id — reentregas podem repetir o mesmo evento.
• Verifique o X-Cooud-Signature com o webhook_secret antes de agir sobre a notificação.
• Guarde o webhook_secret assim que ele aparecer; a Cooud não o exibe novamente.