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

# Conectar a Shopee

> Como pegar sua App ID e Secret Key no programa de afiliados da Shopee e configurar no Easyfy.

Pra integrar a Shopee você precisa de duas chaves do programa de
afiliados: uma **App ID** e uma **Secret Key**.

<Note>
  O Easyfy usa a **Open API oficial** da Shopee, então os dados de
  produto e links vêm direto do programa de afiliados — sem
  intermediários.
</Note>

## Pré-requisitos

<Check>
  Estar aprovado no [Shopee Affiliate Program](https://affiliate.shopee.com.br).
</Check>

<Check>
  Ter acesso à seção **Open API** (geralmente liberada após aprovação).
</Check>

## Onde pegar as credenciais

<Steps>
  <Step title="Entre no painel de afiliados">
    Acesse [affiliate.shopee.com.br](https://affiliate.shopee.com.br) e faça
    login com sua conta de afiliado.
  </Step>

  <Step title="Abra a seção Open API">
    No menu lateral, procure por **Open API** ou **Ferramentas de
    Desenvolvedor**.
  </Step>

  <Step title="Crie uma aplicação (se ainda não tiver)">
    Clique em **Criar Aplicação**, dê um nome qualquer (ex: "Easyfy") e
    confirme.
  </Step>

  <Step title="Copie App ID e Secret">
    Na lista de aplicações, você verá:

    * **App ID** — uma sequência numérica
    * **Secret** — uma string longa de letras e números

    <Warning>
      A **Secret** só aparece uma vez na criação. Copie e guarde em local
      seguro. Se perder, você precisará gerar uma nova.
    </Warning>
  </Step>
</Steps>

## Configurando no Easyfy

<Steps>
  <Step title="Abra Configurações">
    No Easyfy, vá em **Configurações → Credenciais → Shopee**.
  </Step>

  <Step title="Cole as credenciais">
    | Campo               | Valor      |
    | ------------------- | ---------- |
    | Credential (App ID) | Sua App ID |
    | Secret Key          | Sua Secret |
  </Step>

  <Step title="Salvar e testar">
    Clique em **Salvar**. O Easyfy faz uma chamada de teste pra confirmar que
    está tudo certo.
  </Step>
</Steps>

## Problemas comuns

<AccordionGroup>
  <Accordion title="A Secret não aparece no painel">
    A Secret só é exibida no momento da criação da aplicação. Se você fechou a
    tela sem copiar, será preciso **gerar uma nova aplicação** ou regenerar a
    chave (quando disponível).
  </Accordion>

  <Accordion title="Erro 'credenciais inválidas' ao salvar">
    Confira se:

    * Você copiou as credenciais sem espaços extras antes ou depois
    * Sua conta de afiliado está **aprovada** (não em análise)
    * A aplicação no painel da Shopee está **ativa**
  </Accordion>

  <Accordion title="Os links gerados não estão registrando comissão">
    Pode haver delay de até 24h para a Shopee reconhecer cliques de uma
    aplicação nova. Se persistir, verifique se está usando a tag certa no
    painel de afiliados.
  </Accordion>
</AccordionGroup>

## Recursos úteis

<CardGroup cols={2}>
  <Card title="Shopee Affiliate" icon="external-link" href="https://affiliate.shopee.com.br">
    Painel oficial do programa
  </Card>

  <Card title="Documentação Open API" icon="book-open" href="https://open-api.affiliate.shopee.com.br">
    Documentação oficial da Shopee
  </Card>
</CardGroup>