DM Champ Docs

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.

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