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.

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 nuevas empiezan como PENDING y pueden activarse automáticamente si la capacidad del plan lo permite.

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.
• 404 Not Found: El recurso no existe para la cuenta del token.
• 500 Internal Server Error: Error inesperado del servidor.