Central de Ajuda

Gerencie portais de ajuda, categorias e artigos. A central de ajuda permite criar uma base de conhecimento para seus clientes. Todos os endpoints sao escopados a conta autenticada via prefixo /api/v1/accounts/{account_id}.

Portais

GET/api/v1/accounts/{account_id}/portals

Lista todos os portais de ajuda.

200Lista de portais

json

{
  "payload": [
    {
      "id": 1,
      "name": "Central de Ajuda",
      "slug": "central-ajuda",
      "custom_domain": "ajuda.empresa.com",
      "articles_count": 25,
      "categories_count": 5
    }
  ]
}

POST/api/v1/accounts/{account_id}/portals

Cria um novo portal de ajuda.

Body (envolto em objeto portal)

Nome	Tipo	Obrigatorio	Descricao
`name`	`string`	Sim	Nome do portal
`slug`	`string`	Sim	Slug para URL
`custom_domain`	`string`	Nao	Dominio personalizado
`color`	`string`	Nao	Cor tema (hex)
`header_text`	`string`	Nao	Texto do cabecalho do portal
`page_title`	`string`	Nao	Titulo da pagina
`homepage_link`	`string`	Nao	Link para pagina inicial
`config`	`object`	Nao	Config de locales: { default_locale, allowed_locales[], draft_locales[] }

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/portals" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "portal": {
      "name": "Central de Ajuda",
      "slug": "central-ajuda"
    }
  }'

Categorias

GET/api/v1/accounts/{account_id}/portals/{portal_id}/categories

Lista categorias de um portal.

200Lista de categorias

json

{
  "payload": [
    {
      "id": 1,
      "name": "Primeiros Passos",
      "slug": "primeiros-passos",
      "position": 1,
      "articles_count": 8
    }
  ]
}

POST/api/v1/accounts/{account_id}/portals/{portal_id}/categories

Cria uma categoria no portal.

Body (envolto em objeto category)

Nome	Tipo	Obrigatorio	Descricao
`name`	`string`	Sim	Nome da categoria
`description`	`string`	Nao	Descricao da categoria
`slug`	`string`	Nao	Slug para URL
`locale`	`string`	Nao	Idioma (pt_BR, en)
`position`	`integer`	Nao	Posicao na ordenacao
`icon`	`string`	Nao	Icone da categoria
`parent_category_id`	`integer`	Nao	ID da categoria pai

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/portals/1/categories" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "category": {
      "name": "Primeiros Passos",
      "locale": "pt_BR"
    }
  }'

Artigos

GET/api/v1/accounts/{account_id}/portals/{portal_id}/articles

Lista artigos de um portal com paginacao.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`page`(query)	`integer`	Nao	Pagina
`category_id`(query)	`integer`	Nao	Filtrar por categoria
`status`(query)	`string`	Nao	Status: draft, published, archived

bash

curl -s "https://chat.seudominio.com/api/v1/accounts/1/portals/1/articles?status=published" \
  -H "api_access_token: YOUR_TOKEN" | jq .

POST/api/v1/accounts/{account_id}/portals/{portal_id}/articles

Cria um novo artigo.

Body (envolto em objeto article)

Nome	Tipo	Obrigatorio	Descricao
`title`	`string`	Sim	Titulo do artigo
`content`	`string`	Sim	Conteudo (Markdown)
`category_id`	`integer`	Nao	Categoria
`author_id`	`integer`	Nao	ID do autor (agente)
`status`	`string`	Nao	Status: draft, published, archived
`description`	`string`	Nao	Resumo do artigo
`slug`	`string`	Nao	Slug para URL
`locale`	`string`	Nao	Idioma do artigo

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/portals/1/articles" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "article": {
      "title": "Como configurar o WhatsApp",
      "content": "# Configurando WhatsApp\n\nPasso 1: ...",
      "category_id": 1,
      "status": "published"
    }
  }'