# Atlas API para agentes > API con clave para leer y escribir en Atlas (ARM: clientes, ventas y agentes de WhatsApp y web). Base https://atlas.atharix.com/api/integration/v1/ · cabecera X-API-Key. Conector MCP con login de Atlas: https://atlas.atharix.com/mcp ## Empieza aquí - Guía en llano: https://atlas.atharix.com/api/integration/v1/docs/ - Quién soy (ámbitos efectivos de la clave, sin ámbito): GET https://atlas.atharix.com/api/integration/v1/me/ - Esquema OpenAPI de toda la API: https://atlas.atharix.com/api/integration/v1/schema/ - Referencia completa (Swagger): https://atlas.atharix.com/api/integration/v1/docs/referencia/ - Servidor MCP (Claude, Grok, clientes MCP; OAuth o X-API-Key): https://atlas.atharix.com/mcp ## Procedimiento del agente 1. GET me/ y anota tus scopes. Un 403 = falta ámbito: pídelo a la persona, no lo rodees. 2. Lee el schema/ del recurso antes de cargar (accounts/, contacts/, leads/, invoices/, receivables/, catalog/). Los campos personalizados solo están ahí; no inventes campos. 3. Busca antes de crear (GET leads/?q=, GET accounts/?tax_id=). 4. Toda escritura masiva primero con "dry_run": true; enseña el resultado y pide confirmación; repite sin dry_run con el mismo cuerpo. 5. Un lead, una cuenta o una tarea nunca son tuyos: owner_email y assignee_email son personas de GET team/. Sin dueño, Atlas reparte. 6. Pagina con el cursor tal cual (?cursor=next_cursor) hasta has_more:false. 7. Respeta Retry-After y agrupa en lotes (…/bulk/). 8. Cuenta lo que hiciste con las palabras de la persona, no con rutas ni códigos. ## Reglas - Lotes en …/bulk/: respuesta por fila (created, updated, unchanged, deleted, rejected[{index, reason}]); máx. 1.000 cuentas o 500 del resto. - Idempotencia por clave natural: id → external_ref → tax_id / email / phone. Repetir no duplica. - Escritura parcial: solo cambia lo que mandas; "" vacía el campo; ignored_fields devuelve lo desconocido. - Teléfonos en E.164 o con country/default_country (ISO-2). - Configurar un agente: PATCH bots/{id}/ (ajustes técnicos), PATCH bots/{id}/config/ (identidad, directivas, ajustes avanzados validados), PUT bots/{id}/flow/ (lienzo entero, candado version), GET bots/{id}/diagnostics/, POST bots/{id}/simulate/ (sin efectos, gasta tokens). - Lo que gobierna el lienzo da 409 designer_owned: va por flow/. - Fuera de la API, a propósito: borrar bots, conectar un número de WhatsApp en Meta, cambiar el dueño de un lead con dueño, alta de personas, SLA, horario del negocio.