
# WordPress

> **Para quem é isso?** Empresas que possuem um site WordPress e desejam uma automação para escrever posts ou criar contas nele. Se você não usa WordPress, pode pular esta página.
>
> Usa uma plataforma de site diferente? Qualquer coisa com uma API ainda pode ser conectada: veja [Conectando uma Ferramenta que Não Listamos](connecting-other-tools.md).

O WordPress é o software no qual uma grande parte da web é executada. Conectá-lo ao <span data-t="appName">DM Champ</span> oferece às suas [automações](../automations/automations.md) etapas prontas para as duas coisas que as pessoas geralmente desejam de um site: publicar conteúdo e criar uma conta para alguém. Uma conversa que termina em "sim, envie-me o guia" pode criar o usuário no WordPress. Um resumo semanal pode ser enviado como um rascunho de post aguardando sua revisão.

Nada é instalado no seu site WordPress. Você conecta seu próprio site com seus próprios detalhes de login, e nós chamamos a API REST integrada do WordPress da mesma forma que o seu próprio painel faz.

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

---

## O que você precisa

- Um site WordPress na **versão 5.6 ou mais recente**, acessível via **https**.
- **Links permanentes amigáveis** ativados (**Configurações → Links permanentes**, qualquer opção que não seja "Simples"). É isso que faz o endereço `/wp-json/` funcionar, e é o motivo mais comum para uma conexão ser recusada.
- Uma **senha de aplicativo** para o usuário do WordPress com o qual a automação deve agir. No WordPress, vá para **Usuários → Perfil**, role até **Senhas de Aplicativo**, dê um nome como "Automações" e clique em **Adicionar Nova**. O WordPress mostra a senha uma vez, em blocos separados por espaços. Copie-a com os espaços.

Uma senha de aplicativo não é sua senha de login normal. Sua senha real permanece fora disso, e excluir a senha do aplicativo posteriormente revoga exatamente essa conexão e nada mais.

O que quer que o usuário que você escolher tenha permissão para fazer no WordPress é o limite do que a automação pode fazer. Um usuário que não pode publicar posts também não conseguirá publicá-los a partir de uma automação.

---

## Conectando o WordPress

Você se conecta de dentro de uma automação, na primeira vez que usa uma etapa do WordPress.

1. Abra **Automações** na barra lateral (sob o grupo **AI Studio**) e abra ou crie uma automação.
2. Adicione uma etapa e pesquise por **WordPress** no seletor de etapas.
3. Escolha a ação do WordPress que você deseja. A etapa solicitará que você se conecte 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 usuário do WordPress** é o nome de usuário com o qual o usuário faz login, não o endereço de e-mail dele.
   - **Senha de aplicativo** é a senha que você criou acima, colada com seus espaços.
5. Clique em conectar.

Verificamos os detalhes em seu site antes de salvar qualquer coisa, lendo o perfil do usuário que você nos forneceu. Um endereço incorreto, um nome de usuário incorreto, uma senha incorreta ou um site onde `/wp-json/` não é resolvido é recusado imediatamente com o motivo na tela, para que você nunca obtenha uma conexão que pareça correta e falhe na primeira vez que a automação for executada.

Sua senha de aplicativo é armazenada criptografada e nunca é exibida novamente para você. Perdeu? Crie uma nova no WordPress e conecte-se novamente.

---

## As Ações

Cada ação é uma etapa que você solta na tela de automação. Cada campo aceita dados de etapas anteriores com os botões usuais de inserção de dados, portanto, um título pode ser criado a partir do nome de um contato e o conteúdo pode vir de uma etapa de IA.

### Criar post

Publica um novo post ou salva como rascunho.

- **Título** é o título do post. Obrigatório.
- **Conteúdo** é o corpo do post. Obrigatório. Aceita HTML.
- **Status** decide o que acontece com ele: `publish`, `future`, `draft`, `pending` ou `private`. **Deixe vazio e o post será salvo como rascunho**, de propósito: uma automação que publica no seu site público logo na primeira execução de teste é uma surpresa pior do que uma que não publica.
- **Resumo** é o breve resumo que o WordPress exibe em listas. Opcional.

### Atualizar post

Altera um post que já existe.

- **ID do post** é o post a ser alterado. Obrigatório. Você o encontrará na barra de endereços ao editar um post no WordPress, ou pode obtê-lo de uma etapa de **Criar post** anterior na mesma automação.
- **Novo título**, **Novo conteúdo** e **Novo status** são todos opcionais, e **apenas os campos que você preencher serão alterados**. Deixar o título vazio não apaga o título do post publicado.

### Obter post

Busca um post para que etapas posteriores possam usá-lo: título, conteúdo, status e seu link público.

- **ID do post** é o post a ser lido. Obrigatório.

### Criar usuário

Cria uma conta no WordPress.

- **Nome de usuário** é o nome com o qual a pessoa fará login. Obrigatório.
- **E-mail** é o endereço de e-mail da pessoa. Obrigatório. Geralmente é o e-mail do contato vindo do gatilho.
- **Senha** é a senha inicial. Obrigatório.
- **Nome** e **Sobrenome** são opcionais.
- **Função** é o nome de uma função do WordPress, como `subscriber`, `author` ou `editor`. Opcional; se deixado vazio, o WordPress atribui a função padrão para novos usuários.

### Encontrar usuário por e-mail

Procura um usuário pelo endereço de e-mail e retorna seu ID para que uma etapa posterior possa usá-lo.

- **E-mail** é o endereço a ser pesquisado. Obrigatório.

---

## Um Exemplo de Automação

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

1. **Gatilho:** uma tag é adicionada a um contato, digamos `wants access`, pelo seu agente de IA ou por um membro da equipe.
2. **Localizar usuário por e-mail**, com o e-mail do contato. Isso informa se ele já possui uma conta.
3. Uma etapa de **Condição** sobre se algo foi retornado.
4. No caminho "nada encontrado", **Criar usuário** com o e-mail, um nome de usuário, uma senha e a função `subscriber`.
5. Uma etapa de **Enviar mensagem** que informa no WhatsApp que a conta está pronta, com o nome de usuário.

Um segundo exemplo, para conteúdo: uma automação agendada que solicita a uma etapa de **IA** que escreva a pergunta mais feita da semana, seguida por uma etapa de **Criar postagem** que a salva como rascunho. Você abre o WordPress na segunda-feira com uma postagem que só precisa ser lida e publicada.

---

## É bom saber

- **As saídas seguem em frente.** Tudo o que uma ação retorna fica disponível para as etapas posteriores como variáveis, portanto, o id de **Localizar usuário por e-mail** é o que você passa para a próxima etapa, e o link de **Criar postagem** é o que você envia em uma mensagem.
- **Rascunho é o padrão seguro.** **Criar postagem** salva como rascunho, a menos que você defina um status por conta própria.
- **Alguns hosts removem o cabeçalho Authorization** antes que o WordPress o veja, o que faz com que qualquer senha de aplicativo pareça incorreta. Se seus detalhes estiverem definitivamente corretos e a conexão ainda for recusada, é sobre isso que você deve perguntar ao seu host.
- **Não existe um gatilho que monitore o WordPress.** Nada verifica seu site em busca de novas postagens ou novos usuários. Para fazer com que o WordPress inicie uma automação, use um gatilho de **Webhook** na automação e aponte um plugin de webhook do WordPress para o endereço fornecido.
- **Qualquer coisa que não esteja na lista acima ainda é possível** com a etapa de **Solicitação HTTP**, que pode chamar qualquer endereço na API do seu site diretamente.

---

## Próximos passos

- [Automações](../automations/automations.md): gatilhos, etapas, condições e como um fluxo de trabalho é montado.
- [FluentCRM](fluentcrm.md): os mesmos detalhes de conexão gerenciam o CRM que roda no seu site WordPress.
- [MemberPress](memberpress.md): assinaturas e pagamentos no seu site WordPress.
- [Conectando uma ferramenta que não listamos](connecting-other-tools.md): funções personalizadas, a API e webhooks.
