Agregar palabras clave

Autenticación

Envía un token de API de RedReplier como Bearer token en cada solicitud. Los tokens empiezan por redreplier_; RedReplier resuelve la cuenta desde el token. Envía X-Workspace-Id para actuar en un workspace distinto del predeterminado; consulta Listar workspaces.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parámetros

• websiteId (ruta, UUID, obligatorio): Sitio web que recibirá las palabras clave.

Cuerpo de la solicitud

• keywords (string[], obligatorio, no vacío): Valores de palabras clave que se agregarán; cada valor puede tener hasta 255 caracteres.

Respuesta

Devuelve un objeto Website público.

Objeto Website

• id (string): UUID del sitio web.
• accountGroupId (string): Grupo de cuenta resuelto desde el token.
• domain (string): Dominio normalizado del sitio web.
• url (string): URL del sitio web.
• name (string | null): Nombre visible.
• description (string | null): Contexto usado para calcular la relevancia.
• createdAt, updatedAt (ISO string | null): Marcas de creación y actualización en formato ISO 8601, o null.
• keywords (Keyword[]): Objetos Keyword de este sitio web.

Objeto Keyword

• id (string): UUID de la palabra clave.
• websiteId (string): UUID del sitio web principal.
• value (string): Texto de la palabra clave, hasta 255 caracteres.
• status (string): PENDING, ACTIVE, DISABLED o SUSPENDED.
• createdAt, updatedAt (ISO string | null): Marcas de creación y actualización en formato ISO 8601, o null.

Solicitud de ejemplo

curl -X POST https://ai.redreplier.com/ai-app/api/v1/websites/11111111-1111-4111-8111-111111111111/keywords \
  -H 'Authorization: Bearer redreplier_test_1234567890' \
  -H 'Content-Type: application/json' \
  -d '{"keywords":["agency CRM","client onboarding software"]}'

Notas

Agregar palabras clave es distinto de editarlas. Las que caben en el cupo del plan pasan a ACTIVE al momento. El resto queda en PENDING hasta que el plan tenga hueco.

Errores

• 400 Bad Request: Entrada, URL, UUID, enum, parámetro de consulta o cuerpo no válido.
• 401 Unauthorized: Bearer token ausente o no válido, o code: "token_issuer_lost_access" cuando la persona que creó la clave API fue desactivada o salió del workspace.
• 403 Forbidden: code: "subscription_required" cuando el plan del workspace no incluye acceso a la API, code: "workspace_access_denied" cuando X-Workspace-Id indica un workspace al que esta credencial no puede acceder, o code: "permission_denied" cuando tu rol en el workspace no tiene el permiso redreplier.write (lo tienen Admin y Editor).
• 404 Not Found: El recurso no existe para la cuenta del token.
• 429 Too Many Requests: Límite de solicitudes superado. Espera los segundos indicados en Retry-After.
• 500 Internal Server Error: Error inesperado del servidor.