DM Champ Docs

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.

O WordPress é o software no qual funciona uma grande parte da web. Ligá-lo ao DM Champ confere às suas automatizações 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