> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect

> Vincule Cakto e Kiwify, acompanhe produtos e eventos e entenda a diferença entre desvincular e excluir.

## Resumo

O Connect organiza contas Cakto e Kiwify, produtos, assinaturas e vendas recebidas das integrações.
Também permite vincular produtos a contratos e acompanhar a configuração dos webhooks.
Os dados dependem das respostas das integrações e dos eventos recebidos.

> [!WARNING]
>
> Desvincular uma conta mantém produtos, vendas e assinaturas salvos.
> Excluir tudo é uma ação separada e irreversível: remove a conta e seu histórico no Connect.
> Não use a exclusão para apenas interromper uma conexão.

## Para quem é

* Quem acompanha ofertas e vendas da Cakto ou Kiwify.
* Quem precisa associar produtos a contratos.
* Quem verifica assinaturas e a saúde dos webhooks.

## Como abrir

Acesse Connect no painel.
A entrada `?tab=connect` abre `connect:overview`.
As telas internas usam `connect:` seguido do identificador da tela.

## Telas e recursos

![Captura de tela: Connect](https://mintcdn.com/dogly-tdc/qOnot79kPtISSKbW/images/doglytdc/connect.png?fit=max\&auto=format\&n=qOnot79kPtISSKbW\&q=85\&s=e541acc073a0562dad7ad901877d48f8)

Connect no DoglyTdc

### Visão geral

Em `overview`, consulte os indicadores de receita, recorrência, contas, produtos e assinaturas.
A visão reúne vendas recentes e o estado de atualização da conexão.
Se o carregamento for parcial, alguns dados podem estar ausentes; atualize antes de concluir uma análise.

### Contas

Em `accounts`, vincule e revise contas Cakto ou Kiwify.
A Cakto usa API Key e tenta criar o webhook automaticamente.
Se a chave for validada, mas o webhook ficar pendente, use Recriar webhook.
A Kiwify solicita Token, API Secret e Webhook Secret; seu cadastro não é conferido automaticamente.

**1. Vincule a conta**

Escolha Cakto ou Kiwify e complete os campos solicitados.
Confira o resultado antes de considerar a configuração concluída.

**2. Prepare o webhook**

Na Cakto, confira se o webhook foi criado ou se precisa ser recriado.
Na Kiwify, crie o webhook no provedor e cole a URL da aba Webhooks do Connect.

**3. Confira a chegada dos dados**

Use as ações de teste ou validação e revise o estado da conta.
Na Kiwify, o primeiro aviso recebido confirma o webhook; validar não faz conferência automática no provedor.

Ao desvincular, o histórico permanece salvo.
Ao reativar a mesma conta, a interface pode recuperar o histórico anterior.
A opção Excluir tudo tem confirmação própria e não deve ser confundida com desvinculação.

### Produtos

Em `products`, escolha uma conta ativa e informe nome, preço, descrição e ciclo disponíveis.
Na Cakto, o fluxo solicita a criação do produto e da oferta no provedor.
Na Kiwify, registra um checkout que você já criou; a URL é obrigatória.
É possível abrir ou completar o checkout, vincular um contrato elegível e desfazer esse vínculo.

Excluir um produto o remove do Connect.
Na Kiwify, ele continua no provedor e precisa ser excluído lá separadamente.
Na Cakto, o fluxo tenta removê-lo também no provedor quando possível.

### Assinaturas

Em `subscriptions`, consulte cliente, produto, estado, MRR e próximo ciclo informado.
Use busca, filtro de estado e carregamento de mais resultados.
As assinaturas aparecem conforme os eventos de criação ou renovação recebidos pelo webhook.

### Vendas

Em `sales`, consulte vendas e eventos sincronizados.
Use os filtros e a busca disponíveis para localizar registros e carregue mais resultados quando necessário.
Confira o estado de cada registro: uma venda pendente não equivale a receita confirmada.

### Automação e webhooks

Em `automation`, exibido como Webhooks, copie a URL de recebimento de eventos por conta.
Confira estado do webhook, última sincronização, último evento e erros apresentados.
A Cakto tem registro automático; na Kiwify, a configuração do webhook é manual no provedor.
A ação Validar revisa a integração, mas não elimina essa etapa manual na Kiwify.

## Créditos e limites

A tela não apresenta cobrança de créditos por vincular uma conta ou consultar as listagens.
O MRR e os valores de vendas são indicadores financeiros da integração, não saldo de créditos do DoglyTdc.
As listagens carregam resultados por páginas; use a ação de carregar mais para continuar a consulta.

## Permissões

Use o Connect na sessão autenticada do painel.
As credenciais devem ser inseridas apenas nos formulários da conta.
Revise a conta e os dados afetados antes de confirmar desvinculação ou exclusão.
Compartilhe links de checkout e contratos somente com os destinatários apropriados.

## Erros comuns

| Mensagem | O que significa | O que fazer |
| - | - | - |
| Connect carregou parcialmente | Parte das consultas falhou. | Atualize e confira os dados ausentes antes de analisar. |
| Não foi possível carregar o Connect agora | A área não conseguiu carregar os dados. | Use Tentar de novo. |
| Webhook pendente | A configuração de eventos ainda não está concluída. | Na Cakto, recrie o webhook; na Kiwify, configure-o no provedor. |
| Preço inválido | O valor não foi aceito no formulário. | Revise o formato do preço em reais. |
| Informe a URL do checkout Kiwify | Falta o endereço de uma oferta já criada. | Crie ou localize o checkout na Kiwify e informe sua URL. |

## Perguntas frequentes

> [accordion] Desvincular apaga meu histórico?
>
> Não. Produtos, vendas e assinaturas continuam salvos.
> Excluir tudo é uma ação diferente, com confirmação própria e sem reversão.

> [accordion] A Kiwify é validada automaticamente?
>
> Não. Configure o webhook manualmente no provedor.
> O primeiro evento recebido confirma o recebimento pelo webhook.

> [accordion] Vincular um produto ao contrato comprova pagamento?
>
> Não. O vínculo disponibiliza a cobrança no contexto do contrato.
> Confira o estado financeiro dos eventos separadamente.

## Relacionado

> [card] [Pagamentos da plataforma](https://docs.doglytdc.dev/pt-BR/doglytdc/business/platform-payments.md)

> [card] [Contratos](https://docs.doglytdc.dev/pt-BR/doglytdc/business/contracts.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.