
# WordPress

> **Para quem é isto?** Empresas que utilizam um site WordPress e pretendem uma automatização para escrever publicações ou criar contas no mesmo. Se não utiliza WordPress, pode ignorar esta página.
>
> Utiliza uma plataforma de site diferente? Qualquer coisa com uma API pode ser ligada: consulte [Ligar uma Ferramenta que Não Listamos](connecting-other-tools.md).

O WordPress é o software no qual funciona uma grande parte da web. Ligá-lo ao <span data-t="appName">DM Champ</span> confere às suas [automatizações](../automations/automations.md) passos prontos a usar para as duas coisas que as pessoas normalmente pretendem de um site: colocar conteúdo nele e dar uma conta a alguém. Uma conversa que termine em "sim, envie-me o guia" pode criar o utilizador WordPress. Um resumo semanal pode surgir como um rascunho de publicação à espera da sua revisão.

Não é instalado nada no seu site WordPress. Liga o seu próprio site com os seus próprios detalhes de início de sessão e nós chamamos a API REST integrada do WordPress da mesma forma que o seu próprio painel de controlo faz.

**Disponibilidade:** As Automatizações estão disponíveis em todas as contas. Já se encontram na sua barra lateral e não há nada para ativar ou solicitar.

---

## O que precisa

- Um site WordPress na **versão 5.6 ou mais recente**, acessível via **https**.
- **Pretty permalinks** (ligações permanentes amigáveis) ativadas (**Definições → Ligações permanentes**, qualquer opção que não seja "Simples"). É isto que faz com que o endereço `/wp-json/` funcione e é a razão mais comum para uma ligação ser recusada.
- Uma **palavra-passe de aplicação** para o utilizador WordPress com o qual a automatização deve agir. No WordPress, vá a **Utilizadores → Perfil**, desça até **Palavras-passe de aplicação**, dê-lhe um nome como "Automatizações" e clique em **Adicionar nova**. O WordPress mostra a palavra-passe uma vez, em blocos separados por espaços. Copie-a com os espaços.

Uma palavra-passe de aplicação não é a sua palavra-passe de início de sessão normal. A sua palavra-passe real permanece fora disto e eliminar a palavra-passe de aplicação mais tarde revoga exatamente esta ligação e nada mais.

O que quer que o utilizador que escolher tenha permissão para fazer no WordPress é o limite do que a automatização pode fazer. Um utilizador que não possa publicar publicações também não poderá publicá-las a partir de uma automatização.

---

## Ligar o WordPress

Liga-se a partir do interior de uma automatização, na primeira vez que utiliza um passo do WordPress.

1. Abra **Automatizações** na barra lateral (sob o grupo **AI Studio**) e abra ou crie uma automatização.
2. Adicione um passo e procure por **WordPress** no seletor de passos.
3. Escolha a ação WordPress que pretende. O passo pede-lhe para ligar primeiro.
4. Preencha os três campos:
   - **URL do site** é o endereço do seu site WordPress, começando com `https://`, por exemplo `https://yoursite.com`.
   - **Nome de utilizador WordPress** é o nome de utilizador com o qual esse utilizador inicia sessão, não o seu endereço de e-mail.
   - **Palavra-passe de aplicação** é a palavra-passe que criou acima, colada com os seus espaços.
5. Clique em ligar.

Verificamos os detalhes no seu site antes de guardar qualquer coisa, lendo o perfil do utilizador que nos forneceu. Um endereço errado, um nome de utilizador errado, uma palavra-passe errada ou um site onde o `/wp-json/` não é resolvido é recusado imediatamente com o motivo no ecrã, para que nunca obtenha uma ligação que parece estar bem e falha na primeira vez que a automatização é executada.

A sua palavra-passe de aplicação é armazenada encriptada e nunca lhe é mostrada novamente. Perdeu-a? Crie uma nova no WordPress e ligue novamente.

---

## As Ações

Cada ação é um passo que coloca na tela de automatização. Todos os campos aceitam dados de passos anteriores com os habituais botões de inserção de dados, pelo que um título pode ser criado a partir do nome de um contacto e o conteúdo pode vir de um passo de IA.

### Criar publicação

Publica uma nova publicação ou guarda-a como rascunho.

- **Título** é o título da publicação. Obrigatório.
- **Conteúdo** é o corpo da publicação. Obrigatório. Aceita HTML.
- **Estado** decide o que acontece com a mesma: `publish`, `future`, `draft`, `pending` ou `private`. **Deixe vazio e a publicação será guardada como rascunho**, propositadamente: uma automatização que publica no seu site público na primeira execução de teste é uma surpresa pior do que uma que não o faz.
- **Excerto** é o breve resumo que o WordPress mostra em listas. Opcional.

### Atualizar publicação

Altera uma publicação que já existe.

- **ID da publicação** é a publicação a alterar. Obrigatório. Encontrá-lo-á na barra de endereços ao editar uma publicação no WordPress, ou pode obtê-lo a partir de um passo **Criar publicação** anterior na mesma automatização.
- **Novo título**, **Novo conteúdo** e **Novo estado** são todos opcionais, e **apenas os campos que preencher serão alterados**. Deixar o título vazio não apaga o título da publicação ativa.

### Obter publicação

Recupera uma publicação para que passos posteriores a possam utilizar: título, conteúdo, estado e a sua ligação pública.

- **ID da publicação** é a publicação a ler. Obrigatório.

### Criar utilizador

Cria uma conta WordPress.

- **Nome de utilizador** é o nome com que irão iniciar sessão. Obrigatório.
- **Email** é o seu endereço de email. Obrigatório. Geralmente é o email do contacto proveniente do acionador.
- **Palavra-passe** é a sua primeira palavra-passe. Obrigatório.
- **Nome próprio** e **Apelido** são opcionais.
- **Função** é um nome de função do WordPress, tal como `subscriber`, `author` ou `editor`. Opcional; se for deixado vazio, o WordPress atribui a sua própria função predefinida para novos utilizadores.

### Encontrar utilizador por email

Procura um utilizador pelo endereço de email e devolve o seu ID para que um passo posterior o possa utilizar.

- **Email** é o endereço a pesquisar. Obrigatório.

---

## Um exemplo de automatização

**Dê a um cliente uma conta no site no momento em que ele a solicitar.**

1. **Gatilho:** uma etiqueta é adicionada a um contacto, por exemplo `wants access`, pelo seu agente de IA ou por um membro da equipa.
2. **Encontrar utilizador por e-mail**, com o e-mail do contacto. Isto indica-lhe se o utilizador já possui uma conta.
3. Um passo de **Condição** sobre se algo foi encontrado.
4. No ramo "nada encontrado", **Criar utilizador** com o seu e-mail, um nome de utilizador, uma palavra-passe e a função `subscriber`.
5. Um passo de **Enviar mensagem** que os informa via WhatsApp de que a conta está pronta, com o nome de utilizador.

Um segundo exemplo, para conteúdo: uma automatização agendada que solicita a um passo de **IA** que escreva a pergunta mais frequente da semana, seguido de um passo de **Criar publicação** que a guarda como rascunho. Abre o WordPress na segunda-feira com uma publicação que apenas precisa de ser lida e publicada.

---

## É bom saber

- **Os resultados avançam.** Tudo o que uma ação devolve fica disponível para passos posteriores como variáveis, pelo que o ID de **Encontrar utilizador por e-mail** é o que transmite ao passo seguinte, e a ligação de **Criar publicação** é o que envia numa mensagem.
- **Rascunho é a predefinição segura.** **Criar publicação** guarda como rascunho, a menos que defina o estado manualmente.
- **Alguns alojamentos removem o cabeçalho Authorization** antes de o WordPress o ver, o que faz com que qualquer palavra-passe de aplicação pareça incorreta. Se os seus dados estiverem certamente corretos e a ligação continuar a ser recusada, é sobre isto que deve questionar o seu alojamento.
- **Não existe um gatilho que monitorize o WordPress.** Nada verifica o seu site à procura de novas publicações ou novos utilizadores. Para que o WordPress inicie uma automatização, utilize um gatilho de **Webhook** na automatização e aponte um plugin de webhook do WordPress para o endereço que este lhe fornecer.
- **Qualquer coisa que não esteja na lista acima ainda é possível** com o passo de **Pedido HTTP**, que pode chamar qualquer endereço da API do seu site diretamente.

---

## Próximos Passos

- [Automatizações](../automations/automations.md): gatilhos, passos, condições e como um fluxo de trabalho é estruturado.
- [FluentCRM](fluentcrm.md): os mesmos detalhes de ligação gerem o CRM que é executado no seu site WordPress.
- [MemberPress](memberpress.md): adesões e pagamentos no seu site WordPress.
- [Ligar uma ferramenta que não listamos](connecting-other-tools.md): funções personalizadas, a API e webhooks.
