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

# Boas-vindas

> A Vendaze API dá ao seu aplicativo acesso direto aos dados do CRM em qualquer workspace conectado.

<img src="https://mintcdn.com/vendaze/aNWuP0bxxBeeSzz9/images/banner-home.png?fit=max&auto=format&n=aNWuP0bxxBeeSzz9&q=85&s=05a50327b2e7f2322d3fda861d3ff34b" alt="Vendaze Developers" width="1584" height="496" data-path="images/banner-home.png" />

## O que você pode construir

A Vendaze API é uma interface REST que permite que aplicativos externos leiam e escrevam dados em workspaces da Vendaze. Ela usa OAuth 2.1 para autorização: seus usuários conectam o próprio workspace ao seu app e você opera sobre os dados deles com consentimento explícito.

Integrações típicas:

* **Sincronização nativa de CRM:** mantenha contatos, empresas e negócios sincronizados entre a Vendaze e seu produto
* **Automação de vendas:** crie negócios e mova-os no pipeline com base em eventos do seu sistema
* **Painéis customizados:** extraia dados do workspace para ferramentas internas, plataformas de BI ou data warehouses
* **Agentes de IA:** conecte modelos de linguagem a dados reais do CRM via MCP server

## Para quem é

<CardGroup cols={2}>
  <Card title="Desenvolvedores SaaS" icon="code">
    Construa uma integração nativa com a Vendaze e ofereça diretamente aos seus clientes dentro do
    seu produto.
  </Card>

  <Card title="Times de engenharia" icon="building">
    Conecte ferramentas internas, pipelines de ETL ou data warehouses aos dados do workspace da
    Vendaze.
  </Card>

  <Card title="Agências e consultores" icon="briefcase">
    Construa automações e integrações personalizadas para clientes que usam a Vendaze como CRM de
    vendas.
  </Card>

  <Card title="Builders de IA" icon="robot">
    Conecte assistentes de IA como Claude ou ChatGPT a dados reais do CRM via MCP server da Vendaze.
  </Card>
</CardGroup>

## Como funciona

A API usa **OAuth 2.1 Authorization Code flow**. Seu app se registra uma vez para obter um `client_id` e `client_secret`. Quando um usuário quer conectar o workspace, ele passa por uma tela de consentimento OAuth padrão. Após a autorização, você recebe um `access_token` com escopo para aquele workspace específico.

Toda chamada à API carrega esse token. O contexto do workspace é resolvido automaticamente. Você nunca envia um identificador de workspace nas requisições.

## O que você precisa para começar

* Uma conta na Vendaze com pelo menos um workspace ativo ([crie gratuitamente](https://app.vendaze.com/register))
* Um servidor com suporte a HTTPS para receber o callback OAuth
* Familiaridade com APIs REST e OAuth 2.1

Não há processo de aprovação. Qualquer desenvolvedor pode registrar um app e começar a construir imediatamente.

<CardGroup cols={2}>
  <Card title="Registre seu app" icon="plug" href="/pt/guides/register-app">
    Obtenha seu `client_id` e `client_secret` em menos de um minuto.
  </Card>

  <Card title="Autenticação" icon="lock" href="/pt/guides/authentication">
    Implemente o fluxo OAuth 2.1 e obtenha seu primeiro access token.
  </Card>

  <Card title="Primeira requisição" icon="terminal" href="/pt/guides/first-request">
    Guia completo do registro até a primeira chamada real à API.
  </Card>

  <Card title="API Reference" icon="code" href="/pt/api-reference">
    Referência completa dos endpoints com schemas de request e response.
  </Card>
</CardGroup>