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

# Usar la API de Replier

> Crea una clave de API en Gestionar la cuenta, llama a la API REST de Replier desde tu propio código y gestiona errores, reintentos y límites de solicitudes.

La API de Replier permite que tu propio código o una herramienta de automatización haga lo mismo que tú en Replier: listar espacios de trabajo, cuentas y publicaciones, crear y cambiar automatizaciones, leer resultados y contactos, y enviar respuestas pendientes o de automatizaciones únicas. Para usar Replier desde ChatGPT, Claude u otra herramienta de IA, usa las [conexiones de IA](https://docs.usereplier.com/es/guides/ai-connections.md).

La [referencia de la API](https://docs.usereplier.com/api-reference/workspaces/list-workspaces.md) (en inglés) muestra cada endpoint con sus parámetros y respuestas.

## Crear una clave de API

1. En Replier, abre el menú de tu cuenta y elige **Gestionar la cuenta → Integraciones**.
2. En **Claves de API**, selecciona **Crear clave de API**.
3. Escribe un nombre que reconozcas después, elige su acceso y selecciona **Crear clave**.
4. Copia la clave. Replier solo la muestra una vez.

Quien tenga la clave puede usar Replier en tu nombre, así que no la pongas en código que compartas ni en el navegador. Si se filtra, elimínala y crea otra.

Una clave que solo puede ver tus datos se rechaza cuando intenta cambiar algo. Una clave que también puede hacer cambios puede crear, editar, activar o desactivar y eliminar automatizaciones, guardar tus textos predeterminados, reordenar la cola de la próxima publicación, subir fotos de respuesta y enviar respuestas pendientes y de automatizaciones únicas. En ambos casos, la clave actúa con tu rol en cada espacio de trabajo, así que no puede hacer más que tú.

## Hacer una solicitud

Envía la clave como bearer token a `https://api.usereplier.com/v1`:

```bash theme={null}
curl https://api.usereplier.com/v1/workspaces \
  -H "Authorization: Bearer $REPLIER_API_KEY"
```

Las demás solicitudes se hacen en un espacio de trabajo. Usa un `id` de esa lista:

```bash theme={null}
curl https://api.usereplier.com/v1/workspaces/$WORKSPACE_ID/accounts \
  -H "Authorization: Bearer $REPLIER_API_KEY"
```

Las solicitudes que cambian algo envían JSON:

```bash theme={null}
curl -X PATCH https://api.usereplier.com/v1/workspaces/$WORKSPACE_ID/automations/$AUTOMATION_ID \
  -H "Authorization: Bearer $REPLIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'
```

Las automatizaciones creadas o cambiadas con la API tienen los mismos límites que en Replier: hasta 24 destinos, tres botones, una foto opcional y flujos de mensajes en espacios de trabajo Studio.

## Errores

Una solicitud rechazada responde con un estado HTTP y un cuerpo como este:

```json theme={null}
{
  "error": {
    "code": "AUTOMATION_NOT_FOUND",
    "message": "Automation not found in this workspace."
  }
}
```

`code` no cambia; `message` es una explicación en inglés y su redacción puede cambiar. Algunos errores añaden otros campos, como la automatización que ya tiene la publicación que elegiste.

| Estado | Significado |
| - | - |
| 400 | La solicitud no es válida. En `INVALID_REQUEST`, el mensaje indica el campo. |
| 401 | `INVALID_API_KEY`: falta la clave, es incorrecta, está en pausa o se eliminó. |
| 403 | La clave o tu rol no lo permiten; por ejemplo, `WRITE_ACCESS_REQUIRED` para una clave que solo puede ver. |
| 404 | El espacio de trabajo, la cuenta o la automatización no existe o no tienes acceso; por ejemplo, `WORKSPACE_NOT_FOUND`. |
| 409 | Entra en conflicto con el estado actual; por ejemplo, `VERSION_CONFLICT` si la automatización cambió después de leerla. |
| 429 | `RATE_LIMITED`: más de 300 solicitudes en un minuto con esta clave. Espera los segundos del encabezado `Retry-After` y vuelve a intentarlo. |
| 500 | Replier tuvo un error. Vuelve a intentarlo con el mismo `Idempotency-Key`. |

## Reintentar con seguridad

Las solicitudes que cambian algo aceptan el encabezado `Idempotency-Key`. Envía un valor aleatorio nuevo, como un UUID, para cada operación y el mismo valor al reintentarla. Un reintento con el mismo valor devuelve el primer resultado en lugar de crear una segunda automatización o enviar las respuestas dos veces. Enviar respuestas pendientes, de comentarios anteriores o de automatizaciones únicas, y crear una automatización única, requieren el encabezado; sin él, la solicitud se rechaza con `IDEMPOTENCY_KEY_REQUIRED`.

```bash theme={null}
curl -X POST https://api.usereplier.com/v1/workspaces/$WORKSPACE_ID/catch-up \
  -H "Authorization: Bearer $REPLIER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 4f9c1d2e-8a7b-4c3d-9e1f-2a6b5c8d7e0f" \
  -d @items.json
```

Para no sobrescribir el cambio de otra persona, envía `expected_version` con la versión que leíste. Si la automatización cambió desde entonces, la solicitud se rechaza con `VERSION_CONFLICT`. Es obligatorio al eliminar una automatización.

## Cambios en la API

Dentro de `/v1`, Replier solo añade: endpoints nuevos, parámetros opcionales nuevos, campos de respuesta nuevos y valores nuevos en campos de estados o motivos. Ignora los campos y valores que no conozcas. Un cambio que rompería el código existente llegará como `/v2`.

## Pausar o eliminar una clave

En **Gestionar la cuenta → Integraciones**, cada clave muestra su acceso y cuándo se usó por última vez. Elige **Pausar acceso** para rechazar sus solicitudes hasta que elijas **Reanudar acceso**. Elige **Eliminar clave** para quitarla definitivamente; el código que la usa pierde el acceso de inmediato. Las automatizaciones que creó siguen funcionando.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.