> For the complete documentation index, see [llms.txt](https://ajuda.livechat360.com.br/crm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.livechat360.com.br/crm/api-docs/api-livechat-360.md).

# API LiveChat 360

Bem-vindo à documentação da API do LiveChat 360. Esta API REST permite integrar o seu sistema (ERP, site, planilhas, ferramentas de automação) ao CRM da sua conta: contatos, empresas, negociações, produtos, tarefas, origens, anotações, arquivos e propostas.

**URL base:**

```
https://app-api.atendeserver.com.br/v1
```

Todas as requisições usam HTTPS, os corpos são JSON (exceto o upload de arquivos) e as respostas são sempre JSON.

### Primeira requisição

```bash
curl -H "Authorization: Bearer SUA_CHAVE" \
  "https://app-api.atendeserver.com.br/v1/leads?per_page=1"
```

> As chaves de API são criadas no painel, em **API ▸ Chaves**. A chave completa é exibida **uma única vez**, no momento da criação. Veja Autenticação.

### Por onde começar

| Se você quer                                   | Vá para                        |
| ---------------------------------------------- | ------------------------------ |
| Entender os conceitos e preparar a conta       | Começando                      |
| Criar e usar uma chave de API                  | Autenticação                   |
| Saber o que cada chave pode fazer              | Escopos e permissões           |
| Entender envelopes, status e regras de escrita | Referência                     |
| Listar, filtrar e paginar coleções             | Paginação, ordenação e filtros |
| Interpretar um erro                            | Erros                          |
| Ver a integração completa de ponta a ponta     | Guia rápido                    |

### Recursos disponíveis

Mapa completo, relacionamentos e ordem de criação em Recursos.

| Recurso                | Rota base                        |
| ---------------------- | -------------------------------- |
| Contatos               | `/v1/leads`                      |
| Empresas               | `/v1/companies`                  |
| Negociações            | `/v1/deals`                      |
| Produtos da negociação | `/v1/deals/{dealId}/products`    |
| Tarefas                | `/v1/tasks`                      |
| Produtos do catálogo   | `/v1/products`                   |
| Origens                | `/v1/sources`                    |
| Anotações              | `/v1/deals/{dealId}/annotations` |
| Arquivos               | `/v1/deals/{dealId}/files`       |
| Propostas              | `/v1/deals/{dealId}/proposals`   |