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

# Sentra

> Instale a extensão Sentra para VS Code, Cursor ou Windsurf para integrar faturamento e pagamentos em seu aplicativo usando assistência com inteligência artificial.

<Frame>
  <iframe width="100%" height="400" src="https://www.youtube.com/embed/177o3L5MOf4" title="Sentra Extension Demo" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />
</Frame>

## Visão Geral

Sentra adiciona inteligência e execução sobre as pilhas principais da Dodo Payments. É um agente de IA que integra, analisa e atua sobre faturamento e pagamentos. Sentra conecta SDKs, APIs e adaptadores em sua pilha (Auth, DB, CRM, etc.), apresenta insights de receita como motores de crescimento e executa ações do cliente, como reembolsos, upgrades e créditos.

<Info>
  Sentra está atualmente em Beta. Recursos, APIs e integrações podem mudar rapidamente. Agradecemos feedback e relatórios de bugs enquanto iteramos!
</Info>

## Instalação

Sentra está disponível como uma extensão para VS Code, Cursor e Windsurf. Escolha seu IDE abaixo:

<Tabs>
  <Tab title="VS Code">
    <Steps>
      <Step title="Open Extensions Marketplace">
        1. Abra o VS Code.
        2. Clique no ícone Extensões na barra lateral (ou pressione `Cmd+Shift+X` no macOS / `Ctrl+Shift+X` no Windows/Linux).
        3. Pesquise por "Sentra by Dodo Payments" no marketplace.

        <Frame>
          <img src="https://mintcdn.com/dodopayments/LTTtFnnP9hnNapJj/images/sentra/vscode.png?fit=max&auto=format&n=LTTtFnnP9hnNapJj&q=85&s=71c93be5456921bad87edb591d12d4c3" alt="Extensões do Marketplace do VS Code mostrando a extensão Sentra" style={{ maxHeight: '500px', width: 'auto' }} width="2744" height="1186" data-path="images/sentra/vscode.png" />
        </Frame>
      </Step>

      <Step title="Install the Extension">
        1. Clique em "Sentra by Dodo Payments" nos resultados da busca.
        2. Clique no botão **Instalar**.
        3. Aguarde a conclusão da instalação.
      </Step>

      <Step title="Restart VS Code">
        Após a instalação, reinicie o VS Code para ativar a extensão.

        <Tip>
          Se a extensão não aparecer após a instalação, reiniciar o editor resolverá o problema na maioria dos casos.
        </Tip>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Cursor">
    <Steps>
      <Step title="Open Extensions Marketplace">
        1. Abra o Cursor.
        2. Clique no ícone Extensões na barra lateral (ou pressione `Cmd+Shift+X` no macOS / `Ctrl+Shift+X` no Windows/Linux).
        3. Pesquise por "Sentra by Dodo Payments" no marketplace.
      </Step>

      <Step title="Install the Extension">
        1. Clique em "Sentra by Dodo Payments" nos resultados da busca.
        2. Clique no botão **Instalar**.
        3. Aguarde a conclusão da instalação.
      </Step>

      <Step title="Restart Cursor">
        Após a instalação, reinicie o Cursor para ativar a extensão.

        <Tip>
          Se a extensão não aparecer após a instalação, reiniciar o editor resolverá o problema na maioria dos casos.
        </Tip>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Windsurf">
    <Steps>
      <Step title="Open Extensions Marketplace">
        1. Abra o Windsurf.
        2. Clique no ícone Extensões na barra lateral (ou pressione `Cmd+Shift+X` no macOS / `Ctrl+Shift+X` no Windows/Linux).
        3. Pesquise por "Sentra by Dodo Payments" no marketplace.
      </Step>

      <Step title="Install the Extension">
        1. Clique em "Sentra by Dodo Payments" nos resultados da busca.
        2. Clique no botão **Instalar**.
        3. Aguarde a conclusão da instalação.
      </Step>

      <Step title="Restart Windsurf">
        Após a instalação, reinicie o Windsurf para ativar a extensão.

        <Tip>
          Se a extensão não aparecer após a instalação, reiniciar o editor resolverá o problema na maioria dos casos.
        </Tip>
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Configuração

Uma vez instalada, você precisa configurar o Sentra com sua chave de API da Dodo Payments e as configurações de ambiente.

<Steps>
  <Step title="Get Your API Key">
    1. Faça login no seu [painel Dodo Payments](https://app.dodopayments.com).
    2. Navegue até **Developer** › **API Keys**.
    3. Copie sua chave de API.
  </Step>

  <Step title="Configure Sentra">
    1. Abra seu IDE (VS Code, Cursor ou Windsurf).
    2. Abra a Paleta de Comandos (`Cmd+Shift+P` no macOS / `Ctrl+Shift+P` no Windows/Linux).
    3. Digite "Sentra: Configure" e selecione-o.
    4. Insira sua chave de API do Dodo Payments quando solicitado.

    <Frame>
      <img src="https://mintcdn.com/dodopayments/LTTtFnnP9hnNapJj/images/sentra/setup.png?fit=max&auto=format&n=LTTtFnnP9hnNapJj&q=85&s=15e47c48c17fa2950abeb07dd97e4ab6" alt="Tela de configuração do Sentra com entrada da chave API e seleção do ambiente" width="50%" style={{ maxHeight: '500px', width: 'auto' }} data-path="images/sentra/setup.png" />
    </Frame>
  </Step>

  <Step title="Select Environment Mode">
    Escolha seu modo de ambiente:

    * **Test Mode**: Para desenvolvimento e testes
    * **Live Mode**: Para uso em produção

    <Warning>
      Comece com o modo Test para validar sua configuração antes de mudar para o modo Live para dados de produção.
    </Warning>
  </Step>

  <Step title="Set Model Reasoning Effort">
    Selecione seu nível preferido de esforço de raciocínio do modelo:

    * **Low**: Respostas mais rápidas, apropriado para tarefas simples
    * **Medium**: Desempenho equilibrado (recomendado)
    * **High**: Análise mais aprofundada, adequado para integrações complexas
  </Step>

  <Step title="Complete Setup">
    Clique em **Let's go!** para concluir a configuração e começar a usar o Sentra.

    <Check>
      Suas chaves de API são armazenadas com segurança no Armazenamento Secreto do seu IDE e nunca expostas no seu código.
    </Check>
  </Step>
</Steps>

## Como Funciona

Sentra segue um processo simples de quatro etapas, do prompt à produção:

<Steps>
  <Step title="Prompt">
    Digite o que deseja construir. Por exemplo: "Add usage-based billing with a free trial for my Pro plan."

    <Frame>
      <img src="https://mintcdn.com/dodopayments/LTTtFnnP9hnNapJj/images/sentra/welcome.png?fit=max&auto=format&n=LTTtFnnP9hnNapJj&q=85&s=6dc75f60d43e81d44e8f83f1925c4cc5" alt="Interface do Sentra mostrando entrada de prompt com tarefa de exemplo" width="50%" style={{ maxHeight: '500px', width: 'auto' }} data-path="images/sentra/welcome.png" />
    </Frame>
  </Step>

  <Step title="Plan">
    O Sentra gera as alterações (ganchos do SDK, objetos, configuração) e apresenta um plano para sua revisão.
  </Step>

  <Step title="Approve">
    Revise o plano gerado e confirme as alterações que deseja que o Sentra implemente.
  </Step>

  <Step title="Execute">
    O Sentra aplica as alterações, testa e confirma o sucesso.
  </Step>
</Steps>

## Usando o Sentra

### Modos

Sentra oferece três modos de interação acessíveis pela interface:

* **Perguntar**: Faça perguntas sobre Dodo Payments, modelos de faturamento, uso da API e melhores práticas
* **Construir**: Integre faturamento e UI em seu aplicativo com assistência guiada
* **Planejar**: Projete arquiteturas de faturamento escaláveis com orientação arquitetônica

### Tarefas de Exemplo

Aqui estão algumas tarefas comuns que você pode realizar com o Sentra:

* **Integrar Página de Preços**: Configure uma página de preços completa com listagens de produtos e checkout
* **Implementar Webhook**: Configure manipuladores de webhook para eventos de pagamento
* **Adicionar Fluxo de Assinatura**: Crie gerenciamento de assinaturas com capacidades de upgrade/downgrade
* **Configurar Faturamento Baseado em Uso**: Configure medidores e ingestão de eventos para rastreamento de uso
* **Criar Portal do Cliente**: Construa um portal de autoatendimento para gerenciamento de faturamento

### Configurações de Aprovação Automática

Você pode configurar as configurações de aprovação automática para agilizar seu fluxo de trabalho:

* **Nenhuma**: Revise e aprove todas as mudanças manualmente (recomendado para produção)
* **Baixo Risco**: Aprovação automática de mudanças simples e de baixo risco
* **Todas**: Aprovação automática de todas as mudanças (use com cautela)

## Modelos de Faturamento Suportados

Sentra suporta todos os modelos de faturamento da Dodo Payments:

* **Pagamentos Únicos**: Transações de compra únicas
* **Assinaturas**: Faturamento recorrente com múltiplos intervalos
* **Faturamento Baseado em Uso**: Faturamento medido com base no consumo
* **Faturamento Baseado em Resultados**: Modelos de preços por resultado

## Para Quem É

Sentra conecta engenharia e negócios, para que cada equipe possa implementar monetização sem fricção:

* **Desenvolvedores**: Implemente monetização mais rapidamente dentro do seu IDE
* **Fundadores e PMs**: Prototipe modelos de faturamento sem trabalho profundo de infraestrutura
* **RevOps e Finanças**: Use ações controladas sem precisar de engenheiros
* **Suporte e Sucesso**: Resolva casos de faturamento com segurança, com aprovações onde necessário

## Solução de Problemas

<AccordionGroup>
  <Accordion title="Extension not appearing after installation">
    Se o Sentra não aparecer no seu IDE após a instalação, tente o seguinte:

    1. **Reinicie seu editor**: feche e reabra o VS Code, Cursor ou Windsurf completamente
    2. **Verifique a instalação**: confirme que a extensão está instalada indo em Extensões e pesquisando por "Sentra"
    3. **Recarregue a janela**: use a Paleta de Comandos (`Cmd+Shift+P` / `Ctrl+Shift+P`) e execute "Developer: Reload Window"

    <Check>
      Reiniciar o editor resolve o problema na maioria dos casos.
    </Check>
  </Accordion>

  <Accordion title="Invalid API key or authentication errors">
    * Verifique se sua chave de API está correta e ativa no painel do Dodo Payments
    * Garanta que você esteja usando o modo de ambiente correto (Test vs Live) que corresponda à sua chave de API
    * Verifique se sua chave de API tem as permissões necessárias
    * Tente regenerar sua chave de API se o problema persistir
  </Accordion>

  <Accordion title="Configuration not saving">
    * Certifique-se de que todos os campos obrigatórios na tela de configuração estejam preenchidos
    * Verifique se seu IDE tem permissão para acessar o Armazenamento Secreto
    * Tente reconfigurar o Sentra pela Paleta de Comandos
  </Accordion>

  <Accordion title="Plan generation fails">
    * Verifique se sua chave de API é válida e tem acesso aos recursos exigidos
    * Verifique sua conexão com a internet
    * Garanta que você esteja usando um modelo de cobrança compatível
    * Tente reformular seu prompt com mais detalhes específicos
  </Accordion>

  <Accordion title="Execution errors">
    * Analise o plano gerado cuidadosamente antes de aprová-lo
    * Verifique se a estrutura do seu projeto corresponde às expectativas do Sentra
    * Confirme se todas as dependências estão instaladas
    * Verifique o painel de saída do IDE para mensagens de erro detalhadas
  </Accordion>
</AccordionGroup>

<Warning>
  Se você continuar a ter problemas após reiniciar o editor, entre em contato com o suporte fornecendo detalhes sobre a versão do IDE e as mensagens de erro específicas que está vendo.
</Warning>

## Recursos Adicionais

<CardGroup cols={2}>
  <Card title="Dodo Payments Docs" icon="book" href="/introduction">
    Saiba mais sobre os recursos e capacidades do Dodo Payments.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Explore a referência completa da API do Dodo Payments.
  </Card>

  <Card title="Webhook Setup" icon="webhook" href="/developer-resources/webhooks">
    Entenda como configurar webhooks para eventos de pagamento.
  </Card>

  <Card title="Get Beta Access" icon="rocket" href="https://dodopayments.com/sentra">
    Visite o site da Sentra para saber mais e obter acesso beta.
  </Card>
</CardGroup>