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

# Crear un usuario / agente

> Crea agentes en tu cuenta de Shimli usando la API.

# Crear un usuario (agente)

En Shimli, un **agente** es un usuario de tu equipo que puede gestionar conversaciones, campañas y contactos desde la plataforma. Esta guía muestra cómo crear agentes programáticamente.

<Steps>
  <Step title="Prepara los datos del agente">
    Necesitas:

    * `name` — nombre completo del agente
    * `phone` — número de teléfono
    * `email` — correo electrónico (será su usuario de acceso)
  </Step>

  <Step title="Llama el endpoint">
    ```bash theme={null}
    curl -X POST https://api.shimli.app/v1/agent \
      -H "Content-Type: application/json" \
      -d '{
        "token": "TOKEN_SHIMLI",
        "name": "María González",
        "phone": "50499998888",
        "email": "maria.gonzalez@empresa.com"
      }'
    ```
  </Step>

  <Step title="Verifica la creación">
    El agente queda creado y recibirá un correo de bienvenida con instrucciones para establecer su contraseña.
  </Step>
</Steps>

## Consultar un agente

Para obtener la información de un agente existente:

```bash theme={null}
curl -X GET "https://api.shimli.app/v1/agent?id=ID_AGENT" \
  -H "Content-Type: application/json" \
  -d '{ "token": "TOKEN_SHIMLI" }'
```

## Eliminar un agente

```bash theme={null}
curl -X DELETE https://api.shimli.app/v1/agent \
  -H "Content-Type: application/json" \
  -d '{
    "token": "TOKEN_SHIMLI",
    "id": "ID_AGENT"
  }'
```

<Callout type="warning">
  Al eliminar un agente, sus conversaciones asignadas se redistribuyen. Esta acción no se puede deshacer.
</Callout>

## Referencia completa

* [Insert Agent](/api-reference/agents/insert-agent) — crear
* [Get Agent](/api-reference/agents/get-agent) — consultar
* [Delete Agent](/api-reference/agents/delete-agent) — eliminar