> 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-lhe 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 usar 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. Aceda a ⚙ Configuraçõ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**: Adicione uma nova publicação ao seu blog no HubSpot
* **Atualizar publicação do blog**: Modifique uma publicação do blog existente
* **Obter publicação do blog**: Obtenha uma publicação específica do blog por ID
* **Listar publicações do blog**: Obtenha uma lista de publicações do blog
* **Publicar publicação do blog**: Coloque um rascunho de publicação do blog online
* **Eliminar publicação do blog**: Remova permanentemente uma publicação do blog

**Autores do blog**

* **Listar autores do blog**: Obtenha uma lista de autores do seu blog no HubSpot

**Páginas do site**

* **Criar página do site**: Adicione uma nova página ao seu site no HubSpot
* **Atualizar página do site**: Modifique uma página do site existente
* **Obter página do site**: Obtenha uma página específica do site por ID
* **Listar páginas do site**: Obtenha uma lista de páginas do site
* **Publicar página do site**: Coloque uma página de rascunho do site online
* **Eliminar página do site**: Remova permanentemente uma página do site

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-b3c25fae7926aac763d1a9901d334bbbc3fbc7a6%2Fhubspot-cms-01-actions.png?alt=media" alt="HubSpot CMS Integration step with the Action dropdown listing Create Blog Post, Update Blog Post, Get Blog Post, List Blog Posts, Publish Blog Post, Delete Blog Post, List Blog Authors, Create Site Page, Update Site Page, Get Site Page, List Site Pages, Publish Site Page, Delete Site Page"><figcaption><p>Escolha uma ação do HubSpot CMS.</p></figcaption></figure>

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

**Criar publicação do blog**

* **Nome interno**: Nome interno da publicação do blog usado 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 ao qual 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 de URL para a publicação (ex.: `my-blog-post`)
* **Nome do autor (Opcional)**: Nome de exibição do autor da publicação
* **Data de publicação (Opcional)**: Data/hora ISO 8601 para agendar a publicação (ex.: `2025-01-15T10:00:00Z`)

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-76f72dbe42733a3aaee20a201fc3092e19b5c3d0%2Fhubspot-cms-02-create-blog-post.png?alt=media" alt="HubSpot CMS Create Blog Post action with internal name, page title, blog ID, body, slug, and author"><figcaption><p>Crie uma publicação de blog no HubSpot a partir dos resultados do Workflow.</p></figcaption></figure>

**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 de SEO
* **Corpo da publicação (Opcional)**: Conteúdo HTML atualizado
* **Slug (Opcional)**: Slug de URL atualizado
* **Nome do autor (Opcional)**: Nome de exibição 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, Publicada ou Agendada
* **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 colocar online (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
* **Depois de (Opcional)**: Cursor de paginação para obter a página seguinte de resultados

**Criar página do site**

* **Nome**: Nome interno da página do site (obrigatório)
* **Caminho do modelo**: Caminho para o modelo HubSpot a utilizar (obrigatório)
* **Título da página (Opcional)**: Título SEO da página
* **Slug (Opcional)**: Slug de 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 de 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, Publicada ou Agendada
* **Limite (Opcional)**: Número máximo de resultados a devolver
* **Depois de (Opcional)**: Cursor de paginação para obter a página seguinte de resultados

**Publicar página do site**

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

**Eliminar página do site**

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

### Casos de uso 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 fontes com o seu CMS HubSpot

### Tratamento de erros

Por predefinição, a etapa de Integração com o HubSpot CMS irá terminar o fluxo de trabalho se falhar. Pode configurá-la para continuar, selecionando "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.
