> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/integracoes/overview/integrations/hubspot-cms.md).

# HubSpot CMS

Integre o seu Workflow com HubSpot CMS

A etapa de Integração com o HubSpot CMS permite ligar os seus fluxos de trabalho do AirOps diretamente à sua conta HubSpot. Esta integração permite criar, atualizar, publicar e gerir publicações de blog e páginas do site no HubSpot de forma programática.

### Como configurar a etapa de Integração com o HubSpot CMS

#### Autenticação

Antes de utilizar a integração com o HubSpot CMS nos seus fluxos de trabalho, primeiro tem de ligar a sua conta HubSpot nas Definições do AirOps:

1. Navegue para ⚙ Definições > Integrações
2. Encontre a secção HubSpot CMS e clique em "Configurar"
3. Conclua o processo de autenticação OAuth, concedendo ao AirOps as permissões necessárias

#### Tipos de ação

A Integração com o HubSpot CMS suporta as seguintes ações:

**Publicações do blog**

* **Criar publicação do blog**: Adicionar uma nova publicação ao seu blog do HubSpot
* **Atualizar publicação do blog**: Modificar uma publicação do blog existente
* **Obter publicação do blog**: Obter uma publicação específica do blog por ID
* **Listar publicações do blog**: Obter uma lista de publicações do blog
* **Publicar publicação do blog**: Publicar um rascunho de publicação do blog
* **Eliminar publicação do blog**: Remover permanentemente uma publicação do blog

**Autores do blog**

* **Listar autores do blog**: Obter uma lista de autores do seu blog do HubSpot

**Páginas do site**

* **Criar página do site**: Adicionar uma nova página ao seu site HubSpot
* **Atualizar página do site**: Modificar uma página do site existente
* **Obter página do site**: Obter uma página específica do site por ID
* **Listar páginas do site**: Obter uma lista de páginas do site
* **Publicar página do site**: Publicar um rascunho de página do site
* **Eliminar página do site**: Remover permanentemente uma página do site

#### Parâmetros específicos da ação

**Criar publicação do blog**

* **Nome interno**: Nome interno da publicação do blog utilizado no painel do HubSpot (obrigatório)
* **Título da página**: O título apresentado no separador do navegador e nos resultados de pesquisa (obrigatório)
* **ID do blog**: O ID do blog a que esta publicação pertence (obrigatório)
* **Corpo da publicação (opcional)**: O conteúdo do corpo HTML da publicação do blog
* **Slug (opcional)**: Slug da URL da publicação (ex. `my-blog-post`)
* **Nome do autor (opcional)**: Nome apresentado do autor da publicação
* **Data de publicação (opcional)**: Data e hora ISO 8601 para agendar a publicação (ex. `2025-01-15T10:00:00Z`)

**Atualizar publicação do blog**

* **ID da publicação**: O ID da publicação do blog a atualizar (obrigatório)
* **Nome interno (opcional)**: Nome interno atualizado
* **Título da página (opcional)**: Título atualizado do navegador e SEO
* **Corpo da publicação (opcional)**: Conteúdo HTML atualizado
* **Slug (opcional)**: Slug da URL atualizado
* **Nome do autor (opcional)**: Nome apresentado do autor atualizado
* **Data de publicação (opcional)**: Data de publicação agendada atualizada

**Obter publicação do blog**

* **ID da publicação**: O ID da publicação do blog a obter (obrigatório)

**Listar publicações do blog**

* **Estado (opcional)**: Filtrar por estado da publicação - Rascunho, Publicado ou Agendado
* **Limite (opcional)**: Número máximo de resultados a devolver (predefinição 20)

**Publicar publicação do blog**

* **ID da publicação**: O ID da publicação do blog em rascunho a publicar (obrigatório)

**Eliminar publicação do blog**

* **ID da publicação**: O ID da publicação do blog a eliminar (obrigatório)

**Listar autores do blog**

* **Limite (opcional)**: Número máximo de resultados a devolver
* **Após (opcional)**: Cursor de paginação para obter a próxima página de resultados

**Criar página do site**

* **Nome**: Nome interno da página do site (obrigatório)
* **Caminho do modelo**: Caminho para o modelo do HubSpot a utilizar (obrigatório)
* **Título da página (opcional)**: Título SEO da página
* **Slug (opcional)**: Slug da URL da página (ex. `about-us`)

**Atualizar página do site**

* **ID da página**: O ID da página do site a atualizar (obrigatório)
* **Nome (opcional)**: Nome da página atualizado
* **Título da página (opcional)**: Título SEO atualizado
* **Slug (opcional)**: Slug da URL atualizado

**Obter página do site**

* **ID da página**: O ID da página do site a obter (obrigatório)

**Listar páginas do site**

* **Estado (opcional)**: Filtrar por estado da página - Rascunho, Publicado ou Agendado
* **Limite (opcional)**: Número máximo de resultados a devolver
* **Após (opcional)**: Cursor de paginação para obter a próxima página de resultados

**Publicar página do site**

* **ID da página**: O ID da página do site em rascunho a publicar (obrigatório)

**Eliminar página do site**

* **ID da página**: O ID da página do site a eliminar (obrigatório)

### Casos de Utilização Comuns

* Gerar publicações de blog escritas por IA e publicá-las diretamente no HubSpot
* Atualizar publicações existentes com conteúdo renovado ou melhorias de SEO
* Agendar a publicação de conteúdo como parte de um pipeline de conteúdo maior
* Sincronizar conteúdo de outras origens para o seu HubSpot CMS

### Tratamento de erros

Por predefinição, a etapa de Integração com o HubSpot CMS terminará o fluxo de trabalho se falhar. Pode configurá-la para continuar ao selecionar "Continuar" em vez de "Terminar fluxo de trabalho" nas definições da etapa.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/integracoes/overview/integrations/hubspot-cms.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
