# Cliengo Connect API

> Public REST API gateway para Cliengo. Unifica conversaciones, contactos, chatbots, canales y campañas WhatsApp HSM detrás de un único endpoint (`connect.cliengo.com`).

Auth: Bearer token (`Authorization: Bearer sk_live_...`). Rate limits por plan: free 30/min, starter 60/min, premium 200/min, enterprise 1000/min.

## API Reference

- [OpenAPI 3.0 spec — YAML](https://developers.cliengo.com/openapi.yml): spec completo en formato YAML.
- [OpenAPI 3.0 spec — JSON](https://developers.cliengo.com/openapi.json): mismo spec en JSON (más conveniente para herramientas).
- [Reference HTML](https://developers.cliengo.com/reference.html): página interactiva de referencia (Scalar). El spec está inline en el HTML.

## Guías

- [Quickstart y autenticación](https://developers.cliengo.com/guides.html): cómo obtener un token y hacer el primer request.
- [Prompts para IAs](https://developers.cliengo.com/prompts.html): prompts sugeridos para usar la API desde un agente.

## Endpoints públicos (resumen)

- `GET /v1/contacts` — buscar contactos
- `GET /v1/conversations` — listar/filtrar conversaciones
- `GET /v1/channels` — canales (websites)
- `GET /v1/chatbots` — chatbots configurados
- `GET /v1/users`, `GET /v1/accounts`, `GET /v1/plans`, `GET /v1/teams`
- `POST /v1/whatsapp/...` — campañas y mensajes HSM
- `GET /v1/tags`, `GET /v1/phases`, `GET /v1/webhooks`

Para detalles completos (parámetros, schemas, ejemplos) consultá el [OpenAPI spec](https://developers.cliengo.com/openapi.yml).