La documentación más actualizada de las APIs de Cloud Humans está en docs.cloudhumans.com/api-reference. En caso de diferencia entre este artículo y la referencia, prevalece lo que está allí.
Cuándo usarlo
- Quieres crear un nuevo artículo en el Centro de Ayuda de Cloud Chat vía API
- Estás automatizando la publicación de contenido a partir de otra fuente
- Necesitas una referencia rápida del endpoint de creación
Requisitos previos
-
API Key a mano — consulta Cómo encontrar tu API Key en Cloud Chat
-
ACCOUNT_IDyPORTAL_SLUG(slug del portal, ej.:cloud-chat) -
author_idycategory_idregistrados
Endpoint
POST /api/v1/accounts/{id}/portals/{slug}/articles
Headers
| Header | Valor |
|---|---|
content-type |
application/json |
api_access_token |
Tu token de API |
Campos obligatorios
| Campo | Descripción |
|---|---|
title |
Título del artículo |
content |
Contenido en Markdown |
status |
0 (borrador) o 1 (publicado) — recomendamos crearlo como 0 y publicarlo después con PUT |
author_id |
ID del autor |
category_id |
ID de la categoría |
Ejemplo
curl --location 'https://cloudchat.cloudhumans.com/api/v1/accounts/{ACCOUNT_ID}/portals/{PORTAL_SLUG}/articles' \
--header 'Content-Type: application/json' \
--header 'api_access_token: SEU_TOKEN' \
--data '{
"title": "Título do artigo",
"content": "Conteúdo em Markdown...",
"status": 0,
"author_id": 1,
"category_id": 1
}'
Después de crearlo como borrador (status=0), publícalo haciendo un PUT con status=1 en el mismo article_id. Consulta el flujo completo en Cómo crear, actualizar o eliminar artículos en el Centro de Ayuda vía API.
Observaciones
-
Para el flujo completo (crear + publicar + actualizar + eliminar): Cómo crear, actualizar o eliminar artículos en el Centro de Ayuda vía API
-
Visión general de todas las APIs disponibles: Guía Maestra — Cómo acceder y operar datos de Cloud Chat vía API