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

# Flow API

> API externa do ConnectVets Flow para ERP, webhooks e agentes de IA

# ConnectVets Flow API

Documentação para quem vai integrar um sistema externo (ERP, middleware ou agente de IA) com o Flow. Os pedidos vão para o **backend (API gateway)**, não para a URL do CRM no navegador. Toda chamada exige workspace com billing ativo.

## O que você pode fazer

<CardGroup cols={3}>
  <Card title="API REST" icon="code" href="/flow/api-reference/contacts">
    Ideal para ERP: contatos, descoberta de workspace e disparo de pesquisa com contrato HTTP estável.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/flow/webhooks">
    O Flow avisa o seu sistema quando um contato muda ou um lead troca de etapa.
  </Card>

  <Card title="MCP" icon="robot" href="/flow/mcp">
    Para agentes de IA (Claude, Cursor, etc.): cole a URL e a chave — sem escrever código.
  </Card>
</CardGroup>

## Base URL

<Warning>
  Não use a URL do front-end (CRM) nas integrações.
</Warning>

| Ambiente                   | Base URL                                         |
| -------------------------- | ------------------------------------------------ |
| Produção                   | `https://api.connectvets.com.br/flow/v1`         |
| Sandbox                    | `https://api-sandbox.connectvets.com.br/flow/v1` |
| Local (flow na porta 8090) | `http://localhost:8090/api`                      |

Exemplo de caminho completo:

```
https://api.connectvets.com.br/flow/v1/external/workspaces/{workspace_id}/contacts
```

No gateway o prefixo é `/flow/v1`; no servidor isso vira `/api/…`.

## Autenticação

```http theme={null}
Authorization: Bearer flow_live_<seu_token>
```

Crie a chave em **Integrações → Gerenciar chaves**. Cada chave pertence a **um único workspace**. Use [`GET /external/me`](/flow/api-reference/workspaces) para obter o `workspace_id`.

Próximo passo: [Início rápido](/flow/quickstart).